6.7 filecmp -- ファイルおよびディレクトリの比較

6.7 filecmp -- ファイルおよびディレクトリの比較

filecmp モジュールでは、ファイルおよびディレクトリを比較するため、様々な時間／正確性のトレードオフに関するオプションを備えた関数を定義しています。

filecmp モジュールでは以下の関数を定義しています:

cmp( f1, f2[, shallow[, use_statcache]])

名前が f1 および f2 のファイルを比較し、二つのファイルが同じらしければ True を返し、そうでなければ false を返します。

shallow が与えられておりかつ偽でなければ、os.stat() の返すシグネチャが一致するファイルは同じであると見なされます。バージョン 2.3 で変更された仕様: use_statcache は廃止され、指定しても無視されます。

この関数で比較されたファイルは os.stat() シグネチャが変更されるまで再び比較されることはありません。use_statcache を真にすると、キャッシュ無効化機構を失敗させます -- そのため、 statcache のキャッシュから古いファイル stat 値が使われます。

可搬性と効率のために、個の関数は外部プログラムを一切呼び出さないので注意してください。

cmpfiles( dir1, dir2, common[, shallow[, use_statcache]])

ファイル名からなる 3つのリスト: match、mismatch、 errors を返します。match には双方のディレクトリで一致したファイルのリストが含まれ、mismatch にはそうでないファイル名のリストが入ります。そして errors は比較されなかったファイルが列挙されます。ファイルによっては、ユーザにそのファイルを読む権限がなかったり、比較を完了することができなかった場合以外のその他諸々の理由により、 errors に列挙されることがあります。

引数 common は両方のディレクトリにあるファイルのリストです。引数 shallow および use_statcache はその意味も標準の設定も filecmp.cmp() と同じです。

例:

>>> import filecmp
>>> filecmp.cmp('libundoc.tex', 'libundoc.tex')
True
>>> filecmp.cmp('libundoc.tex', 'lib.tex')
False

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。