##
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` オブジェクトに 対応付けた辞書です。