23 Python的shutil模块

概述

        在上一节,我们介绍了Python的argparse模块,包括:argparse模块中一些常用的类和函数。在这一节,我们将介绍Python的shutil模块。shutil模块是一个用于文件和文件夹操作的实用模块,它提供了一组用于处理文件和文件夹的高级接口,包括:文件和文件夹的复制、删除、移动、重命名等操作。shutil模块是Python标准库中的一部分,因此无需安装任何第三方库即可直接使用。

        下面,我们将逐一介绍shutil模块中一些常用的函数。

shutil.copy(src, dst)函数

        shutil.copy(src, dst)函数用于复制文件src到dst。如果目标文件已存在,则覆盖它。这个函数只会复制文件的内容,不会复制文件的元数据,比如:修改时间、访问权限等。如果需要完整地复制文件,则应该使用下面的shutil.copy2函数。

import shutil

# 复制文件
shutil.copy('path_to_src_file', 'path_to_dest_dir')

        上面的示例代码会将"path_to_src_file"文件复制到"path_to_dest_dir"目录。如果目标目录不存在,则shutil.copy函数会抛出一个异常。

shutil.copy2(src, dst)函数

        shutil.copy2(src, dst)函数用于复制文件src到dst,同时保留原始文件的元数据,比如:修改时间、访问权限等。如果目标文件已存在,则覆盖它。

import shutil

# 复制文件
shutil.copy2('path_to_src_file', 'path_to_dest_dir')

shutil.copytree(src, dst)函数

        shutil.copytree(src, dst)函数用于递归地复制文件夹src到dst。与shutil.copy和shutil.copy2不同,shutil.copytree可以复制整个目录树,而不仅仅是单个文件。如果目标目录不存在,shutil.copytree会创建它。如果目标目录已经存在,shutil.copytree会抛出一个异常。

import shutil

# 复制文件夹
shutil.copytree('path_to_src_dir', 'path_to_dest_dir')

shutil.rmtree(path)函数

        shutil.rmtree(path)函数用于递归地删除文件夹path及其内容。如果文件夹不存在,则抛出异常。与os.rmdir 不同,shutil.rmtree可以删除一个包含文件和子目录的目录树。如果目录树中存在任何文件或子目录,os.rmdir会抛出一个异常。

import shutil

# 删除文件夹
shutil.rmtree('path_to_dir')

shutil.move(src, dst)函数

        shutil.move(src, dst)函数用于将文件或文件夹src移动到dst。如果目标位置已存在同名文件或文件夹,则覆盖它。

import shutil

# 将文件移动到另一个目录
shutil.move('path_to_src_file', 'path_to_dest_dir')

shutil.make_archive函数

        shutil.make_archive(base_name, format, root_dir=None, base_dir=None, verbose=0, dry_run=False, owner=None, group=None, logger=None)函数用于创建一个压缩文件,返回其名称。其各个参数的具体含义如下。

        base_name:要创建的归档文件的基本名称,可以包含路径。

        format:归档文件的格式,比如:'zip'、'tar'、'gztar' 等。

        root_dir:要归档的目录树的根目录。如果未指定,则使用当前目录。

        base_dir:相对于root_dir的基准目录,用于确定要归档的文件。如果未指定,则使用root_dir。

        verbose:日志记录级别,0表示不记录,大于0表示记录。

        dry_run:如果为True,则只打印要执行的操作,而不实际执行。

        owner、group:归档文件的用户和组,仅在Unix系统上有效。

        logger:用于记录日志的logger对象。

import shutil

# 创建一个名为archive.zip的zip归档文件,包含path_to_dir目录下的所有文件和子目录  
shutil.make_archive('archive', 'zip', 'path_to_dir')

shutil.unpack_archive函数

        shutil.unpack_archive(filename, extract_dir, format=None)函数用于解压缩给定的压缩文件到指定的目录。其各个参数的具体含义如下。

        filename:要解压缩的归档文件的路径。

        extract_dir:解压缩的目标目录。

        format:归档文件的格式,比如:'zip'、'tar'、'gztar' 等。如果未指定,则根据文件名自动检测。

        pwd:用于解压缩加密归档文件的密码。

import shutil
  
# 解压缩名为archive.zip的归档文件到path_to_dir目录
shutil.unpack_archive('archive.zip', 'path_to_dir')

shutil.disk_usage(path)函数

        shutil.disk_usage(path)函数用于返回指定路径的磁盘使用情况。这个函数会返回一个元组,包含三个属性:指定路径的总磁盘空间(total)、指定路径中被占用的磁盘空间(used)、指定路径中未被占用的磁盘空间(free),都以字节数为单位进行表示。

import shutil
  
info = shutil.disk_usage('./')
# 输出:usage(total=268436500480, used=36055289856, free=232381210624)
print(info)

猜你喜欢

转载自blog.csdn.net/hope_wisdom/article/details/133252554
今日推荐