python标准库shutil

shutil 模块提供了一系列对文件和文件集合的高阶操作。 特别是提供了一些支持文件拷贝和删除的函数。

shutil.copyfileobj(fsrc, fdst[, length])
#将文件类对象 fsrc 的内容拷贝到文件类对象 fdst。

shutil.copyfile(src, dst, *, follow_symlinks=True)
将名为 src 的文件的内容（不包括元数据）拷贝到名为 dst 的文件并以尽可能高效的方式返回 dst。 src 和 dst 均为路径类对象或以字符串形式给出的路径名。

dst 必须是完整的目标文件名；对于接受目标目录路径的拷贝请参见 copy()。

shutil.copymode(src, dst, *, follow_symlinks=True)
从 src 拷贝权限位到 dst。 文件的内容、所有者和分组将不受影响。 src 和 dst 均为路径类对象或字符串形式的路径名。

shutil.copystat(src, dst, *, follow_symlinks=True)
从 src 拷贝权限位、最近访问时间、最近修改时间以及旗标到 dst。

shutil.copy(src, dst, *, follow_symlinks=True)
将文件 src 拷贝到文件或目录 dst。 src 和 dst 应为 路径类对象 或字符串。 如果 dst 指定了一个目录，文件将使用 src 中的基准文件名拷贝到 dst 中。 将返回新创建文件所对应的路径。


shutil.copy2(src, dst, *, follow_symlinks=True)
类似于 copy()，区别在于 copy2() 还会尝试保留文件的元数据。


shutil.ignore_patterns(*patterns)
这个工厂函数会创建一个函数，它可被用作 copytree() 的 ignore 可调用对象参数，以忽略那些匹配所提供的 glob 风格的 patterns 之一的文件和目录。

shutil.copytree(src, dst, symlinks=False, ignore=None, copy_function=copy2, ignore_dangling_symlinks=False, dirs_exist_ok=False)
将以 src 为根起点的整个目录树拷贝到名为 dst 的目录并返回目标目录。

shutil.rmtree(path, ignore_errors=False, onerror=None)
删除一个完整的目录树；path 必须指向一个目录（但不能是一个目录的符号链接）。

shutil.move(src, dst, copy_function=copy2)
递归地将一个文件或目录 (src) 移至另一位置 (dst) 并返回目标位置。

如果目标是已存在的目录，则 src 会被移至该目录下。 如果目标已存在但不是目录，它可能会被覆盖，具体取决于 os.rename() 的语义。


shutil.disk_usage(path)
返回给定路径的磁盘使用统计数据，形式为一个 named tuple，其中包含 total, used 和 free 属性，分别表示总计、已使用和未使用空间的字节数。 path 可以是一个文件或是一个目录。


shutil.chown(path, user=None, group=None)
修改给定 path 的所有者 user 和/或 group。


shutil.which(cmd, mode=os.F_OK | os.X_OK, path=None)
返回当给定的 cmd 被调用时将要运行的可执行文件的路径。 如果没有 cmd 会被调用则返回 None。