filecmp —- 文件及目录的比较

源代码: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 所确定名称的文件。

返回三组文件名列表: match, mismatch, errorsmatch 含有相匹配的文件, mismatch 含有那些不匹配的,然后 errors 列出那些未被比较文件的名称。如果文件不存在于两目录中的任一个,或者用户缺少读取它们的权限,又或者因为其他的一些原因而无法比较,那么这些文件将会被列在 errors 中。

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

例如, cmpfiles('a', 'b', ['c', 'd/e']) 将会比较 a/cb/c 以及 a/d/eb/d/e'c''d/e' 将会各自出现在返回的三个列表里的某一个列表中。

  • filecmp.clear_cache()
  • 清除 filecmp 缓存。如果一个文件过快地修改,以至于超过底层文件系统记录修改时间的精度,那么该函数可能有助于比较该类文件。

3.4 新版功能.

dircmp 类

  • class filecmp.dircmp(a, b, ignore=None, hide=None)
  • 创建一个用于比较目录 ab 的新的目录比较对象。 ignore 是需要忽略的文件名列表,且默认为 filecmp.DEFAULT_IGNOREShide 是需要隐藏的文件名列表,且默认为 [os.curdir, os.pardir]

dircmp 类如 filecmp.cmp() 中所描述的那样对文件进行 shallow 比较。

dircmp 类提供以下方法:

  • report()
  • ab 之间的比较打印(到 sys.stdout )。

  • report_partial_closure()

  • 打印 ab 及共同直接子目录的比较结果。

  • report_full_closure()

  • 打印 ab 及共同子目录比较结果(递归地)。

dircmp 类提供了一些有趣的属性,用以得到关于参与比较的目录树的各种信息。

需要注意,通过 getattr() 钩子,所有的属性将会惰性求值,因此如果只使用那些计算简便的属性,将不会有速度损失。

  • left
  • 目录 a

  • right

  • 目录 b

  • left_list

  • hideignore 过滤,目录 a 中的文件与子目录。

  • right_list

  • hideignore 过滤,目录 b 中的文件与子目录。

  • 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 属性递归搜索两个目录以显示公共差异文件:

  1. >>> from filecmp import dircmp
  2. >>> def print_diff_files(dcmp):
  3. ... for name in dcmp.diff_files:
  4. ... print("diff_file %s found in %s and %s" % (name, dcmp.left,
  5. ... dcmp.right))
  6. ... for sub_dcmp in dcmp.subdirs.values():
  7. ... print_diff_files(sub_dcmp)
  8. ...
  9. >>> dcmp = dircmp('dir1', 'dir2')
  10. >>> print_diff_files(dcmp)