filecmp — 文件和目录比较

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

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

filecmp 模块定义了以下函数：

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

比较名为 f1 和 f2 的文件，如果它们看起来相等则返回 True，否则返回 False。

如果 shallow 为真，并且两个文件的 os.stat() 签名（文件类型、大小和修改时间）相同，则认为这两个文件相等。

否则，如果文件的大小或内容不同，则将它们视为不同的文件。

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

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

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

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

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

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

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

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

3.4 版中的新功能。

dircmp 类

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

构造一个新的目录比较对象，比较目录a和b。 ignore 是要忽略的名称列表，默认为 filecmp.DEFAULT_IGNORES。 hide 是要隐藏的名称列表，默认为 [os.curdir, os.pardir]。

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

dircmp 类提供以下方法：

report(): 打印（到 sys.stdout）a 和 b 之间的比较。

report_partial_closure(): 打印 a 和 b 与公共直接子目录之间的比较。

report_full_closure(): 打印 a 和 b 与公共子目录之间的比较（递归）。

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

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

left_list: a 中的文件和子目录，通过 hide 和 ignore 过滤。

right_list: b 中的文件和子目录，通过 hide 和 ignore 过滤。

common: a 和 b 中的文件和子目录。

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

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

common_dirs: a 和 b 中的子目录。

common_files: a 和 b 中的文件。

common_funny: a 和 b 中的名称，使得目录之间的类型不同，或者 os.stat() 报告错误的名称。

same_files: a 和 b 中相同的文件，使用类的文件比较运算符。

diff_files: 在 a 和 b 中的文件，其内容根据类的文件比较运算符而有所不同。

funny_files: 在 a 和 b 中的文件，但无法进行比较。

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)

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

filecmp — 文件和目录比较

dircmp 类