shutil

--High-level file operations，高级的文件操作模块~
shutil 模块的使用主要包括对文件及目录的移动、复制、打包、压缩（解压）、删除等操作。是对os模块的一个补充~

使用示例

shutil.copyfileobj(fsrc, fdst[, length])

复制一个文件到另一个文件。
 
copyfileobj函数源码：

def copyfileobj(fsrc, fdst, length=16*1024):
    """copy data from file-like object fsrc to file-like object fdst"""
    while 1:
        buf = fsrc.read(length)     # length 为缓冲大小
        if not buf:
            break
        fdst.write(buf)

示例：

import shutil

f_read = open(file='/Users/luyi/tmp/a.txt', mode='r')
f_write = open(file='/Users/luyi/tmp/b.txt', mode='w')

shutil.copyfileobj(f_read, f_write)

使用 copyfileobj 进行复制略显麻烦，源文件和目标文件都需要打开（open）才能进行复制操作~

shutil.copyfile(src, dst)

同样是复制操作~
 
示例：

import shutil

f_src = '/Users/luyi/tmp/a.txt'
f_dest = '/Users/luyi/tmp/b.txt'
shutil.copyfile(f_src, f_dest)

相比于 copyfileobj，copyfile 实现的复制操作要简单的多，在日常的使用中，也是更多的使用 copyfile 函数。其实在内部，copyfile 函数调用了 copyfileobj函数~

shutil.copymode(src, dst)

复制文件的权限，即读写权限，不会复制源文件的内容及属主和属组~

示例：

➜  ls -l
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-r--r--  1 root  wheel  4 Nov  7 22:46 b.txt

>>> import shutil
>>> shutil.copymode('a.txt','b.txt')

➜ ls -l
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-rw-r--  1 root  wheel  4 Nov  7 22:46 b.txt

复制权限的过程，源文件和目标文件都必须存在，若目标文件不存在，则会报错。这里区别于 copyfile 函数，copyfile函数的目标文件可以存在也可以不存在，不存在则直接进行复制，若存在则进行覆盖~

➜  tmp ll
total 8
-rw-r--r--  1 baby  staff     4B Nov  6 23:48 a.txt

>>> import shutil
>>> shutil.copymode('a.txt','b.txt')
Traceback (most recent call last):
  File "", line 1, in 
  File "/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py", line 91, in copymode
    os.chmod(dst, mode)
OSError: [Errno 2] No such file or directory: 'b.txt'

shutil.copystat(src, dst)

复制文件的所有状态信息，包括 mode bits，atime，mtime，flags，但不复制文件内容，以及文件的属主和属组~

➜ ls -l
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-r--r--  1 root  wheel  4 Nov  7 22:50 b.txt
➜ stat a.txt 
16777220 8603112152 -rw-rw-r-- 1 baby wheel 0 4 "Nov  7 22:48:16 2018" "Nov  7 22:46:22 2018" "Nov  7 22:46:46 2018" "Nov  7 22:46:06 2018" 4096 8 0 a.txt
➜ stat b.txt 
16777220 8603112261 -rw-r--r-- 1 root wheel 0 4 "Nov  7 22:50:32 2018" "Nov  7 22:50:37 2018" "Nov  7 22:50:37 2018" "Nov  7 22:50:32 2018" 4096 8 0 b.txt

>>> import shutil
>>> shutil.copystat('a.txt','b.txt')     # 执行复制状态操作

stat 输出的信息中包含3个时间，其中第一个是atime，第二个是mtime，最后一个是ctime。复制完成后，查看两个文件的状态信息：

➜ ls -l
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-rw-r--  1 root  wheel  4 Nov  7 22:46 b.txt
➜ stat a.txt 
16777220 8603112152 -rw-rw-r-- 1 baby wheel 0 4 "Nov  7 22:48:16 2018" "Nov  7 22:46:22 2018" "Nov  7 22:46:46 2018" "Nov  7 22:46:06 2018" 4096 8 0 a.txt
➜ stat b.txt 
16777220 8603112261 -rw-rw-r-- 1 root wheel 0 4 "Nov  7 22:48:16 2018" "Nov  7 22:46:22 2018" "Nov  7 22:52:02 2018" "Nov  7 22:46:22 2018" 4096 8 0 b.txt

可以看到源文件 a.txt 的 atime，mtime 和 mode bits 已经复制到 b.txt 上，文件的属主和属组 并没有发生变化。其中文件的 ctime 由系统自行维护~

shutil.copy(src, dst)

复制文件的内容以及权限，即先 copyfile，然后再 copymode~

shutil.copy2(src, dst)

复制文件的内容以及文件的状态信息，先 copyfile，再 copystat~

shutil.copytree(src, dst, symlinks=False, ignore=None)

递归的复制目录，以及文件的所有状态信息（不包括文件的属主和属组）
示例：

➜  ls -l test1
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-r--r--  1 root  wheel  4 Nov  7 22:56 b.txt

>>> import shutil
>>> shutil.copytree('test1', 'test2')
'test2'

➜  ls -l test2
total 16
-rw-rw-r--  1 root  wheel  4 Nov  7 22:46 a.txt
-rw-r--r--  1 root  wheel  4 Nov  7 22:56 b.txt

shutil.rmtree(path[, ignore_errors[, onerror]])

递归的删除文件~
示例：

➜ ls -l test1
total 16
-rw-rw-r--  1 baby  wheel  4 Nov  7 22:46 a.txt
-rw-r--r--  1 root  wheel  4 Nov  7 22:56 b.txt

>>> import shutil
>>> shutil.rmtree('test1')

rmtree相当于 rm -fr 命令，谨慎操作~

shutil.move(src, dst)

递归的移动文件，作用与通过move命令移动目录类似~
示例：

➜  tmp ll
total 0
drwxr-xr-x  4 baby  staff   128B Nov  7 23:09 test

>>> import shutil
>>> shutil.move('test','/Users/luyi')
'/Users/luyi/test'

➜  tmp ll /Users/luyi/test   
total 16
-rw-r--r--  1 baby  staff     4B Nov  6 23:48 a.txt
-rw-r--r--  1 baby  staff     4B Nov  7 23:06 b.txt

shutil.make_archive(base_name, format,root_dir=None,...)

打包或压缩文件，并且返回操作后的文件路径~
 
参数说明：
  base_name：压缩包的文件名（abc.tar.gz，则base_name为abc），也可以是绝对路径；若是文件名，则压缩后的文件默认存放于当前目录，若是绝对路径，则压缩有的文件就保存到指定路径~
  format：指定压缩或打包的类型，"zip"，"tar"，"bztar"，"gztar"
  root_dir：需要压缩的文件或目录路径
  owner：属主，默认为当前用户
  group：属组，默认为当前组
  logger：指定日志对象，通常是logging.Logger对象~
 
示例：

➜  tmp ll
total 0
drwxr-xr-x  4 baby  staff   128B Nov  7 23:09 test

>>> import shutil
>>> shutil.make_archive(base_name='test',format='zip',root_dir='test')
'/Users/luyi/tmp/test.zip'
>>> shutil.make_archive(base_name='test',format='gztar',root_dir='test')
'/Users/luyi/tmp/test.tar.gz'
>>> shutil.make_archive(base_name='test',format='tar',root_dir='test')
'/Users/luyi/tmp/test.tar'
>>> shutil.make_archive(base_name='test',format='bztar',root_dir='test')
'/Users/luyi/tmp/test.tar.bz2'

➜  tmp ll
total 48
drwxr-xr-x  4 baby  staff   128B Nov  7 23:09 test
-rw-r--r--  1 baby  staff    10K Nov  7 23:25 test.tar
-rw-r--r--  1 baby  staff   187B Nov  7 23:25 test.tar.bz2
-rw-r--r--  1 baby  staff   195B Nov  7 23:25 test.tar.gz
-rw-r--r--  1 baby  staff   206B Nov  7 23:25 test.zip

.................^_^