compare_dir_files プログラム仕様

ディレクトリ間のファイル構成を比較するスクリプト。

このスクリプトは、特定の除外パターンに合致するファイルを無視し、 2つのディレクトリツリー間でどちらか一方にのみ存在するファイルを報告します。 主にソースコードの同期状態や、予期せぬファイルの有無を確認する際に役立ちます。

compare_dir_files.py テクニカルドキュメント

converter.compare_dir_files.compare_directories(source_dir, target_dir, extension='*.py')

2つのディレクトリの内容を比較し、一方にのみ存在するファイルを報告する。

この関数は、ネストされた is_excluded 関数と get_filtered_files 関数を使用して、 除外パターンにマッチしないファイルを収集します。収集したファイルセットの差分を計算し、 結果を標準出力に表示します。パスのセパレータはPOSIX形式 ('/') に統一されます。

パラメータ:

• source_dir -- str 比較元のディレクトリパス。

• target_dir -- str 比較先のディレクトリパス。

• extension -- str 検索するファイルの拡張子パターン (例: "*.py")。

戻り値:

None 結果は標準出力に表示されるため、明示的な戻り値はない。

converter.compare_dir_files.main()

コマンドライン引数を解析し、ディレクトリ比較処理を実行する。

この関数は argparse を使用して、比較元ディレクトリ、比較先ディレクトリ、 検索拡張子パターンを引数として受け取ります。 デフォルト値も設定されており、指定されたパスが有効なディレクトリであるかを確認し、 compare_directories 関数を呼び出します。

パラメータ:

None -- コマンドライン引数は argparse によって処理されるため、明示的な引数はない。

戻り値:

None 処理結果は標準出力に表示される。