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

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

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

filecmp 模块定义了以下函数：

filecmp.cmp(f1, f2[, shallow])

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

除非给出 shallow 并且为假，否则具有相同 os.stat() 签名的文件被视为相等。

除非 os.stat() 签名更改，否则不会再次比较使用此函数比较的文件。

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

filecmp.cmpfiles(dir1, dir2, common[, shallow])

比较两个目录 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' 将分别位于返回的三个列表之一中。

例子：

>>> import filecmp
>>> filecmp.cmp('undoc.rst', 'undoc.rst') 
True
>>> filecmp.cmp('undoc.rst', 'index.rst') 
False

10.5.1. 这目录班级

dircmp 实例是使用这个构造函数构建的：

class filecmp.dircmp(a, b[, ignore[, hide]])

构造一个新的目录比较对象，比较目录a和b。 ignore 是要忽略的名称列表，默认为 ['RCS', 'CVS', 'tags']。 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 对象的字典。

以下是使用 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)

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

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

10.5.1. 这目录班级