python之文件与目录操作及压缩模块(os、zipfile、tarfile、shutil)

python中可以用于对文件和目录进行操作的内置模块包括:

模块/函数名称功能描述open()函数文件读取或写入os.path模块文件路径操作os模块文件和目录简单操作zipfile模块文件压缩tarfile模块文件打包shutil模块高级文件和目录处理fileinput模块读取一个或多个文件中的所有行tempfile模块创建临时文件和目录

其中文件读取或写入已经在之前的文章中进行了描述,具体请参考这里 >> import os
>>>
>>> os.path.abspath(‘test.sh’)
‘/root/test.sh’
>>> os.path.split(‘/root/test.sh’)
(‘/root’, ‘test.sh’)
>>> os.path.split(‘/usr/local’)
(‘/usr’, ‘local’)
>>> os.path.split(‘/usr/local/’)
(‘/usr/local’, ”)
>>> os.path.split(‘test.sh’)
(”, ‘test.sh’)
>>> os.path.basename(‘/root/test.sh’)
‘test.sh’
>>> os.path.dirname(‘/root/test.sh’)
‘/root’
>>> os.path.splitext(‘test.sh’)
(‘test’, ‘.sh’)
>>> os.path.splitext(‘/root/test.sh’)
(‘/root/test’, ‘.sh’)
>>> os.path.splitext(‘/usrl/local’)
(‘/usrl/local’, ”)
>>> os.path.join(‘/root’)
‘/root’
>>> os.path.join(‘/root’, ‘1’, ”, ‘2’, ‘ ‘, ‘3’ )
‘/root/1/2/ /3’
>>> os.path.join(‘/root’, ‘/usr/local’, ‘test.sh’)
‘/usr/local/test.sh’
>>> os.path.join(‘/root’, ‘/usr/local’, ‘1’, ”)
‘/usr/local/1/’
>>> os.path.exists(‘/root/test.sh’)
true
>>> os.path.exists(‘/root/test.txt’)
false
>>> os.path.exists(‘/etc/rc0.d’)
true
>>> os.path.getatime(‘/etc/my.cnf’)
1483433424.62325
>>> os.path.getmtime(‘/etc/my.cnf’)
1472825145.4308648
>>> os.path.getctime(‘/etc/my.cnf’)
1472825145.432865
>>> os.path.relpath(‘/etc/my.cnf’)
‘../etc/my.cnf’
>>> os.path.relpath(‘/etc/my.cnf’, start=’/etc’)
‘my.cnf
>>> os.path.realpath(‘/etc/rc0.d’)
‘/etc/rc.d/rc0.d’
>>> os.path.realpath(‘test.sh’)
‘/root/test.sh’
>>> os.system(‘ls -l /etc/my.cnf’)
-rw-r–r– 1 root root 597 sep 2 22:05 /etc/my.cnf
>>> os.path.getsize(‘/etc/my.cnf’)
597
>>> os.path.isabs(‘/etc/my.cnf’)
true
>>> os.path.isabs(‘my.cnf’)
false
>>> os.path.isfile(‘/etc/my.cnf’)
true
>>> os.path.isdir(‘/etc/my.cnf’)
false
>>> os.path.islink(‘/etc/my.cnf’)
false
>>> os.path.islink(‘/etc/rc0.d’)
true
>>> os.path.islink(‘/etc/rc0.d/’)
false
>>> os.path.isdir(‘/etc/rc0.d/’)
true
>>> os.path.isdir(‘/etc/rc0.d’)
true
>>> os.system(‘df -th’)
filesystem type size used avail use% mounted on
/dev/vda1 ext4 40g 8.7g 29g 24% /
devtmpfs devtmpfs 3.9g 0 3.9g 0% /dev
tmpfs tmpfs 3.9g 0 3.9g 0% /dev/shm
tmpfs tmpfs 3.9g 401m 3.5g 11% /run
tmpfs tmpfs 3.9g 0 3.9g 0% /sys/fs/cgroup
tmpfs tmpfs 783m 0 783m 0% /run/user/0
0
>>> os.path.ismount(‘/’)
true
>>> os.path.ismount(‘/dev’)
true
>>> os.path.ismount(‘/usr’)
false
>>> os.path.samefile(‘/etc/rc0.d’, ‘/etc/rc0.d’)
true
>>> os.path.samefile(‘/etc/rc0.d’, ‘/etc/rc0.d/’)
true二、文件及目录操作(os模块)

需要说明的是: os模块是一个混杂的操作系统接口模块,它提供了各种操作系统相关的功能,文件及目录操作只是其中一部分,而非全部。

在一些unix平台上,这个模块的许多文件或目录的操作函数都支持下面的一个或多个特性:

指定一个文件描述符 对于某些函数,path参数不仅仅可以是一个字符串,还可以是一个文件描述符。该函数会操作这个文件描述符引用的文件。我们可以通过os.supports_fd来检查当前平台path参数是否可以指定为一个文件描述符,如果不可用将会引发一个notimplementederror。如果该函数还支持dir_fd或follow_symlinks参数,当path被以文件描述符的方式提供时,指定dir_fd或follow_symlinks参数是错误的。

相对于目录描述符的路径 如果dir_fd不是none,它应该是一个指向某个目录的文件描述符,并且要操作的path应该是一个相对于该目录的相对路径;如果path是一个绝对路径,dir_fd将会被忽略。

不遵循符号链接 如果follow_symlinks是false,并且要操作的路径中最后一个元素是一个符号链接时,该函数将会操作这个链接文件,而不是操作这个链接文件指向的文件。

1. 相关方法列表# 测试当前用户是否对path所对应文件有某种访问权限
# python2
os.access(path, mode)
# python3
os.access(path, mode, *, dir_fd=none, effective_ids=false, follow_symlinks=true)
# 更改当前工作目录,从python3.3开始path参数允许是一个目录的文件描述符
os.chdir(path)
# 更改当前工作目录,从python3.3开始该函数等价于os.chdir(fd)
os.chfdir(fd)
# 更改文件或目录权限,dir_fd和follow_symlinks是python3.3新增的参数
os.chmod(path, mode, *, dir_fd=none, follow_symlinks=true)
# 更改文件或目录权限,如果path是个链接文件则影响是链接文件本身;python3.3开始该函数等价于os.chmod(path, mode, follow_symlinks=false)
os.lchmod(path, mode)
# 更改文件或目录的属主和属组,如果不改变则设置为-1;dir_fd和follow_symlinks是python3.3新增的参数
os.chown(path, uid, gid, *, dir_fd=none, follow_symlinks=true)
更改文件或目录的属主和属组,如果不改变则设置为-1;如果path是个链接文件则影响是链接文件本身;python3.3开始该函数等价于os.chown(path, uid, gid, follow_symlinks=false)
os.lchown(path, uid, gid)
# 更改当前进程主目录
os.chroot(path)
# 返回一个表示当前目录的字符串
os.getcwd()
# 返回一个表示当前目录的字节串,python3新添加的函数
os.getcwdb()
# 创建硬链接, *后面的参数都是python3.3新增的
os.link(src, dst, *, src_dir_fd=none, dst_dir_fd=none, follow_symlinks=true)
# 创建软链接,*后面的参数都是python3.3新增的
os.symlink(src, dst, target_is_directory=false, * dir_fd=none)
# 返回指定目录中所有文件列表,顺序不固定,且不包含‘.’和‘..’;注意path在python2中没有默认值
os.listdir(path=’.’)
# 返回指定目录中所有文件条目对应的direntry对象迭代器,顺序不固定,则不包含’.’和‘..’;python3.5新增的函数
os.scandir(path=’.’)
# 获取文件或文件描述的状态信息,染回一个stat_result对象,dir_fd和follow_symlinks都是python3.3新增的参数
os.stat(path, *, dir_fd=none, follow_symlinks=true)
# 获取文件或文件描述的状态信息,如果path是一个链接文件则获取的是链接文件本身的状态信息;python3.3开始,该函数等价于os.stat(path, dir_fd=dir_fd, folow_symlinks=false)
os.lstat(path, *, dir_fd=none)
# 创建一个名为path的目录并指定目录权限,如果目录已经存在则会引起fileexistserror;dir_fd是python3.3开始新加的参数。需要说明的是该函数与os.makedirs()、os.mkfifo()函数创建的目或逛到文件的权限会受到umask的影响,比如指定mode为0777,实际目录权限为 0777 – umask = 0755
os.mkdir(path, mode=0o777, *, dir_fd=none)
# 递归创建目录,该函数功能与mkdir()相似,但是会递归创建所有的中间目录;exist_ok为python3.2新增参数,表示当目录已经存在时是否正常返回,如果exist_ok为false(默认)且目标目录已经存在则会引发oserror
os.makedirs(name, mode=0o777, exists_ok=false)
# 创建一个fifo(命名管道)文件,fifo可以被当做正常文件那样访问;通常fifos被用作‘client’和‘server’类型进程的汇集点,server打开fifo读取数据,client打开fifo写入数据。
os.mkfifo(path, mode=0o666, *, dir_fd=none)
# 删除指定的文件,如果path是个目录将会引发oserror
os.remove(path, *, dir_fd=none)
os.unlink(path, *, dir_fd=none)
# 删除指定的空目录,如果目录不为空会引发oserror
os.rmdir(path, *, dir_fd=none)
# 递归删除指定路径中的所有空目录
os.removedirs(name)
# 目录或文件重命名,如果dst是一个目录见鬼引发oserror。在unix平台上,如果dst存在且是一个文件,那么只要用户有权限就将会被静默替换;而在windows平台上,如果dst存在,即使它是一个文件也会引发oserror
os.rename(src, dst, *, src_dir_fd=-none, dst_dir_fd=none)
# 目录或文件递归重命名
os.renames(old, new)
# 与os.rename()功能相同,区别在于:对于os.replace()来说,如果dst存在且是一个文件,那么只要用户有权限就将会被静默替换,而没有平台上的差别
os.replace(src, dst, *, src_dir_fd=none, dst_dir_fd=none)
# 返回链接文件指向的真实路径,类似于os.path.relpath(path),但是该方法可能返回相对路径
os.readlink(path, *, dir_fd=none)
# 返回一个文件的某个系统配置信息,name表示配置项名称,可以通过os.pathconf_names来查看可用的值
os.pathconf(path, name)

关于os.access()函数的说明:默认以用户的真实uid(ruid)和gid来对文件的访问权限做检测,但是大部分操作将会使用有效uid(euid)或gid去做检测,且python3中可以通过将effective_ids参数设置为ture来使用有效uid/gid来做权限检测(关于ruid/euid/suid的概念可以参考)。mode可取值为:os.f_ok(文件存在)、os.r_ok(可读)、os.w_ok(可写)、os.x_ok(可执行)中的一个或用逻辑运算符连接起来的多个。

2. 实例>>> import os
>>>
>>> os.access(‘/bin/passwd’, os.f_ok)
true
>>> os.access(‘/bin/passwd’, os.f_ok|os.x_ok)
true
>>> os.access(‘/bin/passwd’, os.f_ok|os.w_ok)
true
>>> os.getcwd()
‘/root’
>>> os.chdir(‘/tmp’)
>>> os.getcwd()
‘/tmp’
>>> os.system(‘ls -l test*’)
-rw-r–r– 1 root root 0 feb 9 09:02 test1.txt
lrwxrwxrwx 1 root root 9 feb 9 09:02 test.txt -> test1.txt
0
>>> os.chmod(‘/tmp/test.txt’, 0666)
>>> os.system(‘ls -l test*’)
-rw-rw-rw- 1 root root 0 feb 9 09:02 test1.txt
lrwxrwxrwx 1 root root 9 feb 9 09:02 test.txt -> test1.txt
0
>>> os.link(‘test.txt’, ‘test’)
>>> os.system(‘ls -li test*’)
271425 lrwxrwxrwx 2 root root 9 feb 9 09:02 test -> test1.txt
271379 -rw-rw-rw- 1 mysql mysql 0 feb 9 09:02 test1.txt
271425 lrwxrwxrwx 2 root root 9 feb 9 09:02 test.txt -> test1.txt
0
>>> os.listdir(‘.’)
[‘zabbix_proxy.log’, ‘test.txt’, ‘zabbix_agentd.log’, ‘.test-unix’, ‘systemd-private-14bb029ad4f340d5ac49a6fb3c2ca6c9-systemd-machined.service-gjk0cd’, ‘hsperfdata_root’, ‘wrapper-31124-1-out’, ‘a’, ‘test1.txt’, ‘zabbix_proxy.log.old’, ‘zabbix_agentd.log.old’, ‘systemd-private-14bb029ad4f340d5ac49a6fb3c2ca6c9-mariadb.service-kudcmu’, ‘test’, ‘.x11-unix’, ‘.font-unix’, ‘wrapper-31124-1-in’, ‘.xim-unix’, ‘.ice-unix’, ‘aegis-‘]
>>> os.listdir(‘/tmp’)
[‘zabbix_proxy.log’, ‘test.txt’, ‘zabbix_agentd.log’, ‘.test-unix’, ‘systemd-private-14bb029ad4f340d5ac49a6fb3c2ca6c9-systemd-machined.service-gjk0cd’, ‘hsperfdata_root’, ‘wrapper-31124-1-out’, ‘a’, ‘test1.txt’, ‘zabbix_proxy.log.old’, ‘zabbix_agentd.log.old’, ‘systemd-private-14bb029ad4f340d5ac49a6fb3c2ca6c9-mariadb.service-kudcmu’, ‘test’, ‘.x11-unix’, ‘.font-unix’, ‘wrapper-31124-1-in’, ‘.xim-unix’, ‘.ice-unix’, ‘aegis-‘]
>>> os.mkdir(‘/tmp/testdir’)
>>> os.system(‘ls -l /tmp’)
lrwxrwxrwx 2 root root 9 feb 9 09:02 test -> test1.txt
-rw-rw-rw- 1 mysql mysql 0 feb 9 09:02 test1.txt
drwxr-xr-x 2 root root 4096 feb 9 09:47 testdir
lrwxrwxrwx 2 root root 9 feb 9 09:02 test.txt -> test1.txt
>>> os.mkdir(‘/tmp/testdir’)
traceback (most recent call last):
file “”, line 1, in
oserror: [errno 17] file exists: ‘/tmp/testdir’
>>> os.mkdir(‘/tmp/a/b/c’)
traceback (most recent call last):
file “”, line 1, in
oserror: [errno 2] no such file or directory: ‘/tmp/a/b/c’
>>> os.makedirs(‘/tmp/a/b/c’) # mode默认为0777,结果却是0755,bug?
>>> os.makedirs(‘/tmp/b/c/d’, 0700)
>>> os.system(‘ls -l /tmp’)
total 2316
drwxr-xr-x 3 root root 4096 feb 9 10:16 a
drwx—— 3 root root 4096 feb 9 10:16 b
lrwxrwxrwx 2 root root 9 feb 9 09:02 test -> test1.txt
-rw-rw-rw- 1 mysql mysql 0 feb 9 09:02 test1.txt
drwxr-xr-x 2 root root 4096 feb 9 09:47 testdir
lrwxrwxrwx 2 root root 9 feb 9 09:02 test.txt -> test1.txt
>>> os.rename(‘/tmp/test1.txt’, ‘/tmp/test3.txt’)
>>> os.system(‘ls -l /tmp’)
lrwxrwxrwx 2 root root 9 feb 9 09:02 test -> test1.txt
prw-r–r– 1 root root 0 feb 9 10:21 test1.fifo
-rw-rw-rw- 1 mysql mysql 0 feb 9 09:02 test3.txt
drwxr-xr-x 2 root root 4096 feb 9 09:47 testdir
prw-r–r– 1 root root 0 feb 9 10:20 test.fifo
lrwxrwxrwx 2 root root 9 feb 9 09:02 test.txt -> test1.txt
>>> os.readlink(‘/tmp/test.txt’)
‘test1.txt’
>>> os.rmdir(‘/tmp/testdir’)
>>> os.rmdir(‘/tmp/a/b/c’) # 只删除空目录/tmp/a/b/c
>>> os.removedirs(‘/tmp/b/c/d’) # 先删除空目录/tmp/a/b/c,然后删除空目录/tmp/a/b,最后删除目录/tmp/a,而目录/tmp非空,因此不会被删除
>>> os.unlink(‘/tmp/test’)
>>> os.unlink(‘/tmp/test.fifo’)
>>> os.unlink(‘/tmp/test.txt’)
>>> os.system(‘ls -l /tmp’)
>>> os.remove(‘/tmp/test3.txt’)
>>> os.remove(‘/tmp/test1.fifo’)三、文件压缩(zipfile模块)1. zipfile模块包含的类

顾名思义,zipfile模块用于文件的压缩操作,该模块包含以下几个类:

类名描述zipfile.zipfile用于zip文件的读写操作zipfile.pyzipfile用于创建包含python库的zip归档文件zipfile.zipinfo用于表示归档文件中的一个成员信息

zipfile.zipinfo类的实例可以通过zipfile对象的getinfo()和infolist()方法获取。

2. zipfile模块中的函数和常量函数/常量名描述zipfile.is_zipfile(filename)判断filename是否是一个有效的zip文件,并返回一个布尔类型的值zipfile.zip_stored表示一个压缩的归档成员zipfile.zip_deflated表示普通的zip压缩方法,需要zlib模块的支持zipfile.zip_bzip2表示bzip2压缩方法,需要bz2模块的支持;python3.3新增zipfile.zip_lzma表示lzma压缩方法,需要lzma模块的支持;python3.3新增3. zipfile.zipfile类类的构造方法class zipfile.zipfile(file, mode=’r’, compression=zip_stored, allowzip64=true)

创建一个zipfile实例,表示打开一个zip文件。

参数:

file:可以是一个文件的路径(字符串),也可以是一个file-like对象;

mode:表示文件代开模式,可取值有:r(读), w(写), a(添加), x(创建和写一个唯一的新文件,如果文件已存在会引发fileexistserror)

compression:表示对归档文件进行写操作时使用的zip压缩方法,可取值有:zip_stored, zip_deflated, zip_bzip2, zip_lzma, 传递其他无法识别的值将会引起runtimeerror;如果取zip_deflated, zip_bzip2, zip_lzma,但是相应的模块(zlib, bz2, lzma)不可用,也会引起runtimeerror;

allowzip64:如若zipfile大小超过2gib且allowzip64的值为false,则将会引起一个异常

说明:

从python 3.2开始支持使用zipfile作为上下文管理器(with语法)

从python 3.3开始支持bzip2和lzma压缩

从python 3.4开始allowzip64默认值改为true

从python 3.5开始添加对unseekable streams的写操作支持以及对‘x’ mode的支持

实例方法列表# 打印该归档文件的内容
printdir()
# 从归档文件中展开一个成员到当前工作目录,memeber必须是一个完整的文件名称或者zipinfo对象,path可以用来指定一个不同的展开目录,pwd用于加密文件的密码
extract(memeber, path=none, pwd=none)
# 从归档文件展开所有成员到当前工作目录,path和pwd参数作用同上,memebers必须是namelist()返回的list的一个子集
extractall(path=none, members=none, pwd=none)
# 返回一个与每一个归档成员对应的zipinfo对象的列表
infolist()
# 返回归档成员名称列表
namelist()
# 返回一个包含压缩成员name相关信息的zipinfo对象,如果name没有被包含在该压缩文档中将会引发keyerror
getinfo(name)
# 将归档文件中的一个成员作为一个file-like对象展开;name是归档文件中的文件名或者一个zipinfo对象
open(name, mode=’r’, pwd=none)
# 关闭该压缩文件;退出程序前必须调用close()方法,否则一些必要记录不会被写入
close()
# 设置pwd作为展开加密文件的默认密码
setpassword(pwd)
# 读取归档文件中所有文件并检查它们的完整性,返回第一个被损坏的文件名称,或者none。对已关闭的zipfile调用testzip()将会引发runtimeerror
testzip()
# 返回归档文件中name所指定的成员文件的字节。name是归档文件中的文件名称或一个zipinfo对象。该归档文件必须以读(r)或追加(a)的模式打开。如果设置了pwd参数,则其将会覆盖setpassword(pwd)方法设置的默认密码。对一个已经关闭的zipfile调用read()方法将会引发runtimeerror
read(name, pwd=noneds)
# 将filename文件写入归档文件,可以通过arcname指定新文件名(需要注意的是文件名中磁盘盘符和开头的路径分隔符都会被移除);compress_type表示压缩方法,如果指定了该参数则会覆盖zipfile构造方法中的compression参数指定的值;要调用此方法,归档文件必须以’w’, ‘a’或’x’模式打开,如果对以’r’模式打开的zipfile调用write()方法或者对已关闭的zipfile调用write()方法将会引发runtimeerror
write(filename, arcname=none, compress_type=none)
# 将一个字节串写入归档文件;zinfo_or_arcname可以是归档文件中的文件名称,也可以是一个zipinfo实例
writestr(zinfo_or_arcname, bytes[, compress_type])4. zipfile.pyzipfile类

pyzipfile类用于创建包含python库的zip存档

类的构造方法

pyzipfile的构造方法与zipfile的构造方法参数基本一致,只是多了一个optimize参数

class zipfile.pyzipfile(file, mode=’r’, compression=zip_stored, allowzip64=true, optimize=-1)

说明:

python 3.2 新增optimize参数

python 3.4 allowzip64默认值改为true

实例方法列表

pyzipfile类的实例方法与zipfile类的实例方法一致,只是多了一个writepy()方法:

# 搜索*.py文件并将相应的文件添加到归档文件
writepy(pathname, basename=”, filterfunc=none)

说明:

如果该pyzipfile实例的构造方法中的optimize参数没有被给出,或者被设置为-1,那么这里所指的“相应文件”是一个*.pyc文件,如果需要,会进行编译。

如果该pyzipfile实例的构造方法中的optimize参数值为0, 1或2,只有那些同样优化等级(参考compile()函数)的文件会被添加到归档文件。

如果pathname是一个文件,文件名必须以.py结尾,且仅仅是这些(*.py[co])文件被添加,不包含路径信息;如果pathname是一个文件,但是不以.py结尾,将会引发runtimeerror。

如若pathname是一个目录,且这个目录不是一个package目录,则所有的(不包含路径信息).py[co]文件将被添加;如果pathname是一个package目录,则所有的.py[co]都会作为一个文件路径被添加到这个package名称下,并且如果任何子文件夹是package目录,则会被递归添加。

basename仅供内部使用

filterfunc参数如果被给出,则其必须是一个只接收一个字符串参数的函数。每个文件路径在被添加到归档之前都会作为参数传递给filterfunc所指定的函数。如果filterfunc返回false,则这个路径将不会被添加,如果是一个目录,则它的内容将会被忽略。

filterfunc参数是python 3.4新加的。

5. zipfile.zipinfo类

zipinfo类的实例时通过zipfile对象的getinfo()和infolist()方法返回的,其本身没有对外提供构造方法和其他方法。每一个zipinfo对象存储的是zip归档文件中一个单独成员的相关信息,因此该实例仅仅提供了以下属性用于获取归档文件中成员的信息。

属性名称描述zipinfo.filename文件名称zipinfo.date_time文件的最后修改日期和时间,这是一个tuple:(年, 月, 日, 时, 分, 秒)zipinfo.compress_type压缩类型zipinfo.comment文件备注zipinfo.extra扩展字段数据zipinfo.create_systemzip归档的创建系统zipinfo.create_version创建zip归档的pkzip版本zipinfo.extract_version展开zip归档所需要的pkzip版本zipinfo.reserved必须是0zipinfo.flag_bitszip标志位zipinfo.volume文件头的volume号码zipinfo.internal_attr内部属性zipinfo.external_attr外部属性zipinfo.header_offset文件头的字节偏移量zipinfo.crc未压缩文件的crc-32zipinfo.compress_size压缩后的数据大小zipinfo.file_size未压缩文件大小6. 实例实例1:文件归档与解压缩操作import zipfile
# 归档
z = zipfile.zipfile(‘test.zip’, ‘w’)
z.write(‘a.txt’)
z.write(‘b.log’)
z.close()
# 解压
z = zipfile.zipfile(‘test.zip’, ‘r’)
z.extractall()
z.close()
# 文件信息读取
z = zipfile.zipfile(‘test.zip’, ‘r’)
z.printdir()
z.namelist()
z.infolist()
zinfo = z.getinfo(‘a.txt’)
print(zinfo.filename)
print(zinfo.date_time)
print(zinfo.file_size)
print(zinfo.compress_size)
z.close()实例2:python文件归档

工程目录结构

myprog
│ hello.py

├─account
│ login.py
│ __init__.py

├─test
│ test_print.py

└─tools
tool.py

代码

import zipfile
pyz = zipfile.pyzipfile(‘myprog.zip’, ‘w’)
pyz.writepy(‘myprog/hello.py’)
pyz.writepy(‘myprog/tools’)
pyz.writepy(‘myprog/test’)
pyz.writepy(‘myprog/account’)
pyz.close()
pyz.printdir()

输出结果:

file name modified size
hello.pyc 2017-02-16 11:46:20 130
tool.pyc 2017-02-16 11:55:44 135
test_print.pyc 2017-02-16 11:55:48 140
account/__init__.pyc 2017-02-16 11:55:54 118
account/login.pyc 2017-02-16 11:55:54 138四、文件打包(tarfile模块)

tarfile模块用于读写tar归档文件,它也可以同时实现压缩功能。与zipfile模块相比,tarfile模块 可以直接将一个目录进行归档并压缩。另外,tarfile模块提供的api更“面向对象”化。

1. tarfile模块包含的两个主要的类类名描述tarfile该类提供了操作一个tar归档的接口tarinfo一个tarinfo对象代表tarfile中的一个成员

这两个类的关系类似于zipfile.zipfile与zipfile.zipinfo的关系,tarinfo对象中保存了一个文件所需要的所有属性,比如:文件类型、文件大小、修改时间、权限、属主等,但是它不包含文件的数据。

2.tarfile模块包含的方法和常量方法/常量名描述tarfile.open(name=none, mode=’r’, fileobj=none, bufsize=10240, **kwargs)为指定的路径名name返回一个tarfile对象tarfile.is_tarfile(name)如果name是一个tarfile模块可以读的tar归档文件则返回true,否则返回falsetarfile.encoding表示默认字符编码,在windows上为’utf-8’,否则为sys.getfilesystemencoding()的返回值tarfile.ustar_formatposix.1-1922(ustar)格式tarfile.gun_formatgun tar格式tarfile.pax_formatposix.1-2001(pax)格式tarfile.default_format表示创建归档的默认格式,当前值为gun_format

关于open()函数的说明:

tarfile.open(name=none, mode=’r’, fileobj=none, bufsize=10240, **kwargs)

该函数用于创建并返回一个tarfile对象。python官方文档不建议直接使用tarfile的构造方法构建示例,而是建议使用这个open()函数来操作tarfile对象。下面我们来说说它的参数:

name:表示要创建的归档文件的名称,通常为.tar, .tar.gz, .tar.bz2, .tar.xz,具体后缀应该与mode的值对应

mode:必须是一个filemode[:compression]格式的字符串,默认值为’r’。filemode的可取值为’r’, ‘w’, ‘a’, ‘x’; compression表示压缩方式,可取值为’gz’, ‘bz2’, ‘xz’;需要注意的是’a:gz’, ‘a:bz2’, ‘a:xz’是不允许的格式。

下面是mode所有可取值的列表:

mode行为’r:’以读模式打开一个未压缩的归档文件(通常后缀为*.tar)’r:gz’以读模式打开一个通过gzip方式进行压缩的归档文件(通常后缀为*.tar.gz)’r:bz2’以读模式打开一个通过bzip2方式进行压缩的归档文件(通常后缀为*.tar.bz2)’r:xz’以读模式打开一个通过lzma方式进行压缩的归档文件(通常后缀为*.tar.xz)’r’ 或 ‘r:*’以读模式打开归档文件,可以打开以上任意方式压缩的归档文件,且会自动判断应该使用的压缩方式。推荐使用这个mode。’w’或’w:’以写模式打开一个不进行压缩的归档文件’w:gz’以写模式打开一个以gzip方式进行压缩的归档文件’w:bz2’以写模式打开一个以bzip2方式进行压缩的归档文件’w:xz’以写模式打开一个以lzma方式进行压缩的归档文件’x’或’x:’同’w’或’w:’,但是如果归档文件已经存在会引发fileexistserror’x:gz’同’w:gz’,但是如果归档文件已经存在会引发fileexistserror’x:bz2’同’w:bz2”,但是如果归档文件已经存在会引发fileexistserror’x:xz’同’w:xz’,但是如果归档文件已经存在会引发fileexistserror’a’或’a:’以追加方式打开一个不进行压缩的股低昂文件,如果文件不存在则创建

对于 ‘w:gz’, ‘r:gz’, ‘w:bz2’, ‘r:bz2’, ‘x:gz’, ‘x:bz2’这些模式, tarfile.open() 接收关键字参数 compresslevel (默认值为9) 来指定该归档文件的压缩级别.

3.tarfile.tarfile类类构的造方法class tarfile.tarfile(name=none, mode=’r’, fileobj=none, format=default_format, tarinfo=tarinfo, dereference=false, ignore_zeros=false, encoding=encoding, errors=’surrogateescape’, pax_headers=none, debug=0, errorlevel=0)

参数说明:

下面所有的参数都是可选的,且可以作为tarfile类实例的属性被访问;

name:指定归档文件路径名称;如果fileobj参数被指定该参数可以被忽略,且如果fileobj的name属性存在则取该属性的值;

mode::指定文档打开模式;r:读取已存在的归档,a:向一个已存在的文件追加数据,w:创建一个新的文件覆盖已经存在的文件,x:如果文件不存在才创建一个新文件

fileobj:指定要读写的文件对象;如果指定了该参数,那么mode参数的值会被fileojb的mode属性值覆盖,且name参数可以被忽略;

format:用于控制归档格式;必须是这些值中的一个:ustar_format, gun_format, pax_format

tarinfo:

dereference:如果该参数值为false,则直接将软连接和硬链接添加到归档中;如果该参数值为true,则将目标文件的内容添加到归档中;

ignore_zeros:该参数值对读取连续或损坏的归档时有效;如果值为false,则会把一个空block当做归档文件的结束位置;如果值为ture,则会跳过空或无效的block并尝试获取尽可能多的归档成员

debug:设置调试级别,可取值为0(不输出任何调试信息)至 3(输出所有调试信息),调试信息会被写到sys.stderr;

errorlevel:设置错误级别;如果值为0,则使用tarfile.extract()方法时出现的所有错误都会被忽略,否则,如果debug可用,这些信息会作为错误信息出现在debug输出中。如果值为1,则所有fatal错误将会引发oserror;如果值为2,则所有非fatal错误将会引发tarerror;

encoding 和 errors:这两个参数定义了读写归档时使用的字符编码和如何处理转换错误

类方法classmethod tarfile.open(…)

这是个可选的构造方法,实际上tarfile.open()函数就是这个函数的快捷方式

实例方法# 将name文件添加到归档;name可以是任何类型的文件(如:目录,fifo管道,软连接等),arcname用于指定name文件被添加到归档后的新名字,arcname默认为none,表示文件名称保持不变。recursive值为trur表示如果name文件是一个目录,则该目录中文件会被递归添加到归档中。exclude参数如果被指定,则其值必须是一个接受文件名作为参数的函数,且该函数必须返回一个布尔值,返回值为true表示该文件将不会被添加到归档中,反之则会被添加到归档中。filter参数如果被提供,则它必须是一个关键字参数且它应该是一个接收tarinfo对象作为参数的函数,该函数应该返回被修改后的tarinfo对象;如果它的返回值为none,那么该tarinfo将不会被添加到归档中。需要说明的是,从python 3.2开始 exclude参数被废弃,新增filter参数,且使用filter代替exclude的功能
add(name, arcname=none, recursive=true, exclude=none, *, filter=none)
# 添加指定tarinfo对象到归档中。如果fileobj被提供,它应该是一个二进制文件,且会从这个二进制文件中读取tarinfo.size字节的内容添加到这个归档中。你可以通过gettarinfo()直接创建tarinfo对象
addfile(tarinfo, fileobj=none)
# 返回归档成员name对应的tarinfo对象(类似zipfile.zipfile实例的getinfo(name)方法);如果name无法在归档中找到会引发keyerror,如果一个成员在归档中不仅出现一次,则最后一次出现将被当做最新版本
getmemeber(name)
# 将归档中所有成员作为tarinfo对象的列表返回(类似zipfile.zipfile实例的infolist()方法)
getmemebers()
# 将归档中所有成员的名称以列表形式返回(类似zipfile.zipfile实例的namelist()方法)
getnames()
# 打印内容列表到sys.stdout(类似zipfile.zipfile实例的printdir()方法);如果verbose值为false,则仅打印成员的名称;如果verbose值为true,则打印的内容类似’ls -l’命令的输出;如果可选参数members被给出,它必须是getmembers()方法返回的列表的子集;python 3.5新增memebers参数
list(verbose=true, *, memebers=none)
# (当以读模式打开归档时)该方法以tarinfo对象的形式返回归档的下一个成员,如果已经没有可用的成员则返回none
next()
# 将归档中的所有成员提取到当前工作目录或path参数指定的目录;如果memebers参数被指定,它必须是getmemebers()函数返回列表的子集;所有者、更改时间和权限等目录信息会在所有成员被提取后设置;如果numberic_owner值为true,将使用tarfile的uid和gid数字来设置提取后文件的属主和属组,否则将使用叔叔和属组的名字。python 3.5中新增了number_owner参数
extractall(path=”.”, memebers=none, *, numeric_owner=false)
# 提取归档中的一个成员到当前工作目录或path指定的目录,member参数的值可以是一个文件名或一个tarinfo对象;python 3.2添加了set_attrs参数,python 3.5添加了numberic_owner参数
extract(member, path=””, set_attrs=true, *, numberic_owner=false)
# 提取归档中的一个成员为一个文件对象,member参数的值可以是一个文件名或一个tarinfo对象;从python 3.3开始,如果member是一个普通文件或是一个链接,该方法会返回一个io.bufferedreader对象,否则会返回none
extractfile(member)
# 通过对现有文件执行os.stat()操作的结果创建一个tarinfo对象;这个已存在的文件可以通过文件名name来指定,也而已通过文件对象fileobj来指定(文件描述符),文件被添加到归档后的文件名取值优先级为:arcname参数的值,fileobj.name属性的值,name参数的值;你可以在通过addfile()方法将该文件添加到归档之前对tarinfo对象的一些属性值进行修改
gettarinfo(name=none, arcname=none, fileobj=none)
# 关闭tarfile对象
close()4. tarfile.tarinfo类

一个tarinfo对象表示tarfile中的一个成员。tarinfo对象中除了保存了一个文件所需要的所有属性(比如:文件类型、文件大小、修改时间、权限、属主等)之外,它还提供了一些用于判断其文件类型的方法。需要注意的是,它不包含文件的数据。tarinfo对象可以通过tarfile的getmember()、getmembers()和gettarinfo()方法获取。

类构造方法class tarfile.tarinfo(name=””)类方法# 从字符串缓冲区创建一个tarinfo对象并返回
classmethod tarinfo.frombuf(buf, encoding, errors)
从tarfile对象中读取一个成员并将其作为一个tarinfo对象返回
classmethod tarinfo.fromtarfile(tarfile)对象方法和属性方法/属性名描述name归档成员名称size字节大小mtime最后更改时间mode权限位type文件类型,通常是以下几个常量中的一个:regtype, aregtype, linktype, symtype, dirtype, fifotype, conttype, chrtype, blktype, guntype_sparse。判断一个tarinfo对象类型的更方便的方式是使用下面的is*()方法linkname目标文件名称,这只是在tarinfo对象的类型是linktype和symtype时有效uid最初存储该成员的用户idgid最初存储该成员的组iduname用户名gname组名pax_headers一个包含pax扩展头的key-value字典isfile() / isreg()判断tarinfo对象是否是一个普通文件isdir()判断tarinfo对象是否是一个目录issym()判断tarinfo对象是否是一个软链接islnk()判断tarinfo对象是否是一个硬链接ischr()判断tarinfo对象是否是一个字符设备isblk()判断tarinfo对象是否是一个块设备isfifo()判断tarinfo对象是否是一个fifo管道isdev()判断tarinfo对象是否是一个字符设备 或 块设备 或 fifo管道tobuf(format=default_format, encoding=encoding, errors=’surrogateescape’)从一个tarinfo对象生成一个字符串缓冲区5. 实例

工程目录结构:

myprog
│ hello.py

├─account
│ login.py
│ __init__.py

├─test
│ test_print.py

└─tools
tool.py

python工程归档及解压操作:

import tarfile
# 归档压缩
tf = tarfile.open(‘myprog.tar.gz’, ‘w:gz’)
tf.add(“myprog”)
tf.close()
# 解压
tf = tarfile.open(‘myprog.tar.gz’)
tf.extractall()
tf.close()
# 读取归档文件内容
tf = tarfile.open(‘myprog.tar.gz’)
tf.list()
print(tf.getmembers())
f = tf.getmember(‘myprog/hello.py’)
print(f.name)
print(f.size)
f.isfile()
tf.close()五、高级文件和目录处理(shutil模块)

上面我们介绍了路径操作(os.path模块)、文件和目录操作(os模块)和 文件归档压缩操作(zipfile模块和tarfile模块),但是还是这些模块要么缺少一些常用的功能(如:文件复制、删除非空文件夹),要么使用起来不是那么方便,而shutil模块shutil提供了一些文件和文件集合的高级操作,可以弥补这些不足。

需要注意的是:虽然shutil.copy()和shutil.copy2()是高级复制函数,但是它们并不能拷贝所有的文件元数据(metadata),例如在posix平台上,文件的属主、属组和acls等信息都会丢失。

1. 文件和目录操作# 文件内容(部分或全部)复制,参数是两个已经打开的文件对象;length是一个整数,用于指定缓冲区大小,如果其值是-1表示一次性复制,这可能会引起内存问题
shutil.copyfileobj(fsrc, fdst[, length])
# 文件内容全部复制(不包括metadata状态信息), 参数是两个文件名,且dst必须是完整的目标文件名称;如果dst已经存在则会被替换;follow_symlinks是python 3.3新增的参数,且如果它的值为false则将会创建一个新的软链接文件
shutil.copyfile(src, dst, *, follow_symlinks=true)
# 仅拷贝文件权限(mode bits),文件内容、属组、属组均不变,参数是两个文件名;follow_symlinks是python 3.3新增的参数
shutil.copymode(src, dst, *, follow_symlinks=true)
# 仅拷贝文件状态信息(包括文件权限,但不包含属主和属组):mode bits, atime, mtime, flags,参数是两个文件名;follow_symlinks是python 3.3新增的参数
shutil.copystat(src, dst, *, follow_symlinks=true)
# 拷贝文件内容和权限,并返回新创建的文件路径;相当于copyfile + copymode,参数是两个路径字符串,且dst可以是一个目录的路径;follow_symlinks是python 3.3新增的参数
shutil.copy(src, dst, *, follow_symlinks=true)
# 与copy函数功能一致,只是会把所有的文件元数据都复制;相当于copyfile + copystat,也相当于 ‘cp -p’(不包括属主和属组);follow_symlinks是python 3.3新增的参数
shutil.copy2(src, dst, *, follow_symlinks=true)
# 这个工厂方法接收一个或多个通配符字符串,然后创建一个可以被传递给copytree()方法的’ignore’参数的函数。文件名与指定的通配符匹配时,则不会被赋值。
shutil.ignore_patterns(*patterns)
# (递归)拷贝整个src目录到目标目录dst,且目标目录dst必须是不存在的。该函数相当于 ‘cp -pr’;目录的权限和时间通过shutilcopystat()来拷贝,单个文件通过shutil.copy2()来考虑诶
shutil.copytree(src, dst, symlinks=false, ignore=none, copy_function=copy2, ignore_dangling_symlinks=false)
# 递归删除,相当于 rm -r
shutil.rmtree(path, ignore_errors=false, onerror=none)
# 递归移动并返回目标路径,相当于move命令;如果dst是一个已经存在的目录,则src将会被移动到该目录里面;如果dst已经存在,但不是目录,他将会被覆盖;copy_function是python 3.5新加的关键字参数
shutil.move(src, dst, copy_function=copy2)
# 以一个命名tuple的形式返回磁盘使用信息(total, used, free),单位为字节;python 3.3新增方法
shutil.disk_usage(path)
# 更改指定路径的属主和属组,user可以是一个系统用户名或一个uid,group也是这样;这两个参数至少要提供一个;python 3.3新增方法
shutil.chown(path, user=none, group=none)
# 返回命名cmd的文件路径,相当于which命令;python 3.3新增方法
shutil.which(cmd, mode=os.f_ok|os.x_ok, path=none)2. 归档操作

shutil模块的当当操作是创建和读取压缩文件的高级工具,同时提供文档归档功能。这些高级工具的实现是基于zipfile和tarfile模块实现的,其中与make_archive相关的函数是在python 2.7版本新增的,而与unpack_archive相关的函数是在python3.2版本新增的。

# 创建一个归档文件(zip或tar)并返回它的名字;
# basename是要创建的文件名称,包含路径,但是不包含特定格式的扩展名;
# format是归档格式,可取值为’zip’, ‘tar’, ‘gztar’, ‘bztar’和 ‘xztar’
# root_dir表示归档文件的根目录,即在创建归档之前先切换到它指定的目录,
# base_dir表示要进行归档的目录,如果没有提供则对root_dir目录下的所有文件进行归档压缩(它可以是绝对路径,也可以是相对于root_dir的相对路径,它将是归档中所有文件和目录的公共前缀)
# root_dir和base_dir默认都是当前目录
# dry_run如果值为ture表示不会创建归档,但是操作输出会被记录到logger中,可用于测试
# loggger必须是一个兼容pep 282的对象,通常是logging.logger的一个实例
# verbose该参数没有用处且已经被废弃
# python 3.5新增对xztar格式的支持
shutil.make_archive(base_name, format, root_dir=none, base_dir=none, verbose=0,
dry_run=0, owner=none, group=none, logger=none)
# 解压归档文件
# filename是归档文件的全路径
# extract_dir时解压归档的目标目录名称,如果没有提供,则取当前工作目录
# format是归档格式:’zip’, ‘tar’ 或 ‘gztar’中的一种。或者是通过register_unpack_format()注册时的其他格式,如果未提供则会根据归档文件的扩展名去查找相应的解压器,如果没找到则会引发valueerror。
shutil.unpack_archive(filename[, extract_dir[, format]])
# 返回支持的归档格式列表,且该列表中的每个元素是一个元组(name, description)
# shutil默认提供以下归档格式:
# gztar: gzip’ed tar-file
# bztar: bzip2’ed tar-file(如果bz2模块可用)
# xztar: xz’ed tar-file(如果lzma模块可用)
# tar: uncompressed tar file
# zip: zip file
# 我们可以通过register_archive_format()来注册新的归档格式或者为已存在的格式提供我们自己的归档器
shutil.get_archive_formats()
# 以列表形式返回所有已注册的解压格式,每个列表中的每个元素都是一个元组(name, extensions, description)
# shutil默认提供的解压格式与shutil.get_archive_formats()返回结果一直
# 我们可以通过register_unpack_format()来注册新的格式或为已存在的格式提供我们自己的解压器
shutil.get_unpack_formats()
# 注册一个新的归档格式对应的归档器
shutil.register_archive_fromat(name, function[, extra_args[, description]])
# 从支持的归档格式列表中移除指定的归档格式
shutil.unregister_archive_fromat(name)
# 注册一个新的解压格式对应的解压器
shutil.register_unpack_format(name, extensions, function[, extra_args[, description]])
# 从支持的解压格式列表中移除指定的挤压格式
shutil.unregister_unpack_format(name)3. 实例shutil.copyfile(‘/tmp/myprog/hello.py’, ‘/tmp/hello.py’)
# 仅复制文件内容
# -rw-r–r– 1 root root 46 feb 21 16:22 /tmp/hello.py
shutil.copymode(‘/tmp/myprog/hello.py’, ‘/tmp/hello.py’)
# 仅复制文件权限位
# -rwxr-xr-x 1 root root 46 feb 21 16:46 /tmp/hello.py
shutil.copystat(‘/tmp/myprog/hello.py’, ‘/tmp/hello.py’)
# 仅复制文件元数据(atime, mtime)
# -rwxr-xr-x 1 root root 46 feb 18 17:32 /tmp/hello.py
shutil.copy(‘/tmp/myprog/hello.py’, ‘/tmp/hello1.py’)
# 复制文件内容和权限位
# -rwxr-xr-x 1 root root 46 feb 21 16:54 /tmp/hello1.py
shutil.copy2(‘/tmp/myprog/hello.py’, ‘/tmp/hello2.py’)
# 同时赋值文件内容、权限为和时间
# -rwxr-xr-x 1 root root 46 feb 18 17:32 /tmp/hello2.py
shutil.copytree(‘/tmp/myprog’, ‘/tmp/myprog1’)
# 复制一个目录(包括子目录和文件)
shutil.move(‘/tmp/myprog1’, ‘/tmp/myprog2’)
# 移动文件或目录,也可以看做是“重命名”
shutil.rmtree(‘/tmp/myprog2’)
# 删除一个目录(包括子目录和文件)
shutil.make_archive(‘/data/myprog’, ‘gztar’, root_dir=’/tmp/’, base_dir=’myprog’)
# 切换到/tmp目录下,将myprog目录以gzip的格式进行归档压缩,压缩文件路径为/data/myprog.tar.gz六、其他相关模块(tempfile和fileinput模块)

tempfile模块用于创建和操作临时文件;fileinput模块用于同时读取多个文件的内容(包括sys.stdin)。这两个模块比较简单,大家自己翻下官方文档就可以了。

七、总结

使用os.path模块进行路径相关操作,如:路径分割,路径拼接,获取路径对应文件的大小、绝对路径、3个时间属性、目录名(dirname)和文件名(basename),判断路径对应文件的类型等;

使用os模块进行文件及目录相关基础操作,如:删除单个文件或空目录,设置文件或目录的权限和属主、属组,文件和目录的移动、重命名,创建目录、层级目录、fifo管道文件、硬链接和软链接(创建普通文件使用open()函数),判断有无对文件或目录有指定的权限,查询指定目录下的所有文件列表等;

使用shutil模块进行高级文件和目录操作,如:文件(内容、权限位、时间属性、全部)复制,目录递归复制、非空目录递归删除;

使用zipfile或tarfile模块进行文件的归档压缩操作,shutil模块提供的解压函数是python 3.2版本才提供的,因此对于使用python 2进行开发的项目是无法使用shutil模块提供的所有功能函数的;当然运维的同学有时也会直接执行tar命令是实现压缩和解压缩,但是跨平台性就无法保证了。

更多python之文件与目录操作及压缩模块(os、zipfile、tarfile、shutil)相关文章请关注php中文网!

Posted in 未分类

发表评论