11.5. filecmp — 文件和目录比较 — Python 文档

来自菜鸟教程
Python/docs/3.6/library/filecmp
跳转至:导航、​搜索

11.5. 文件 — 文件和目录比较

源代码: :source:`Lib/filecmp.py`



filecmp 模块定义了比较文件和目录的函数,具有各种可选的时间/正确性权衡。 要比较文件,另请参阅 difflib 模块。

filecmp 模块定义了以下函数:

filecmp.cmp(f1, f2, shallow=True)

比较名为 f1f2 的文件,如果它们看起来相等则返回 True,否则返回 False

如果 shallow 为真,具有相同 os.stat() 签名的文件被视为相等。 否则,将比较文件的内容。

请注意,此函数不会调用任何外部程序,因此具有可移植性和效率。

此函数使用缓存用于过去的比较和结果,如果文件的 os.stat() 信息发生更改,则缓存条目将失效。 可以使用 clear_cache() 清除整个缓存。

filecmp.cmpfiles(dir1, dir2, common, shallow=True)

比较两个目录 dir1dir2 中名称由 common 给出的文件。

返回三个文件名列表:matchmismatcherrorsmatch 包含匹配的文件列表,mismatch 包含不匹配的文件名,errors 列出无法比较的文件名. 如果文件不存在于其中一个目录中、用户没有读取它们的权限或由于某些其他原因无法进行比较,则这些文件会列在 errors 中。

shallow 参数与 filecmp.cmp() 具有相同的含义和默认值。

例如,cmpfiles('a', 'b', ['c', 'd/e']) 会将 a/cb/ca/d/eb/d/e 进行比较。 'c''d/e' 将分别位于返回的三个列表之一中。

filecmp.clear_cache()

清除 filecmp 缓存。 如果文件在修改后很快被比较,以至于它在底层文件系统的 mtime 分辨率内,这可能很有用。

3.4 版中的新功能。

11.5.1. 这目录班级

class filecmp.dircmp(a, b, ignore=None, hide=None)

构造一个新的目录比较对象,比较目录abignore 是要忽略的名称列表,默认为 filecmp.DEFAULT_IGNOREShide 是要隐藏的名称列表,默认为 [os.curdir, os.pardir]

dircmp 类通过执行 比较来比较文件,如 filecmp.cmp() 所述。

dircmp 类提供以下方法:

report()

打印(到 sys.stdoutab 之间的比较。

report_partial_closure()

打印 ab 与公共直接子目录之间的比较。

report_full_closure()

打印 ab 与公共子目录之间的比较(递归)。

dircmp 类提供了许多有趣的属性,可用于获取有关正在比较的目录树的各种信息。

请注意,通过 __getattr__() 钩子,所有属性都是惰性计算的,因此如果只使用那些轻量级计算的属性,则不会有速度损失。

left

目录 a

right

目录 b

left_list

a 中的文件和子目录,通过 hideignore 过滤。

right_list

b 中的文件和子目录,通过 hideignore 过滤。

common

ab 中的文件和子目录。

left_only

仅在 a 中的文件和子目录。

right_only

仅在 b 中的文件和子目录。

common_dirs

ab 中的子目录。

common_files

ab 中的文件。

common_funny

ab 中的名称,使得目录之间的类型不同,或者 os.stat() 报告错误的名称。

same_files

ab 中相同的文件,使用类的文件比较运算符。

diff_files

ab 中的文件,其内容根据类的文件比较运算符而有所不同。

funny_files

ab 中的文件,但无法进行比较。

subdirs

common_dirs 中的名称映射到 dircmp 对象的字典。

filecmp.DEFAULT_IGNORES

3.4 版中的新功能。

dircmp 默认忽略的目录列表。

以下是使用 subdirs 属性递归搜索两个目录以显示常见不同文件的简化示例:

>>> from filecmp import dircmp
>>> def print_diff_files(dcmp):
...     for name in dcmp.diff_files:
...         print("diff_file %s found in %s and %s" % (name, dcmp.left,
...               dcmp.right))
...     for sub_dcmp in dcmp.subdirs.values():
...         print_diff_files(sub_dcmp)
...
>>> dcmp = dircmp('dir1', 'dir2') 
>>> print_diff_files(dcmp)