11.5.1 dircmp クラス

dircmp のインスタンスは以下のコンストラクタで生成されます:

クラス dircmp( a, b[, ignore[, hide]])
ディレクトリ a および b を比較するための新しいディレクトリ 比較オブジェクトを生成します。ignore は比較の際に無視する ファイル名のリストで、標準の設定では ['RCS', 'CVS', 'tags'] です。hide は表示しない名前のリストで、標準の設定では [os.curdir, os.pardir] です。

dircmp クラスは以下のメソッドを提供しています:

report( )
a および b の間の比較結果を (sys.stdout に) 出力します。

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 オブジェクトに 対応付けた辞書です。
ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。