コマンドライン引数をスマートに！Pythonの「argparse」でスクリプトをもっと使いやすく

import argparse

def process_file(filename, verbose):
    """
    指定されたファイルを処理する関数。
    verboseがTrueの場合、詳細なメッセージを出力します。
    """
    print(f"--- ファイル処理開始: {filename} ---")
    if verbose:
        print("詳細モードが有効です。")

    # ここにファイルの処理ロジックを記述
    print(f"ファイル '{filename}' を無事に処理しました。")

def main():
    # 1. ArgumentParserオブジェクトの作成
    # description引数でスクリプトの概要を説明できます
    parser = argparse.ArgumentParser(description='このスクリプトは指定されたファイルを処理します。')

    # 2. 引数の追加
    # 必須引数 'filename' を追加
    parser.add_argument('filename', type=str, help='処理対象のファイル名を指定します。')

    # オプション引数 '--verbose' を追加
    # action='store_true' は、このオプションが指定されたらTrue、されなければFalseを格納します
    parser.add_argument('--verbose', '-v', action='store_true', 
                        help='詳細な処理メッセージを表示します。')

    # オプション引数 '--count' を追加
    # typeで引数の型を指定できます。defaultでデフォルト値を設定できます。
    parser.add_argument('--count', type=int, default=1, 
                        help='処理を繰り返す回数を指定します (デフォルト: 1回)。')

    # 3. コマンドライン引数の解析
    args = parser.parse_args()

    # 解析された引数を使って処理を実行
    print(f"ファイル '{args.filename}' を {args.count} 回処理します。")
    for _ in range(args.count):
        process_file(args.filename, args.verbose)

if __name__ == '__main__':
    main()

python your_script_name.py --help
# または
python your_script_name.py -h

python your_script_name.py my_data.txt

ファイル 'my_data.txt' を 1 回処理します。
--- ファイル処理開始: my_data.txt ---
ファイル 'my_data.txt' を無事に処理しました。

python your_script_name.py another_data.csv --verbose --count 3
# または
python your_script_name.py another_data.csv -v -count 3

ファイル 'another_data.csv' を 3 回処理します。
--- ファイル処理開始: another_data.csv ---
詳細モードが有効です。
ファイル 'another_data.csv' を無事に処理しました。
--- ファイル処理開始: another_data.csv ---
詳細モードが有効です。
ファイル 'another_data.csv' を無事に処理しました。
--- ファイル処理開始: another_data.csv ---
詳細モードが有効です。
ファイル 'another_data.csv' を無事に処理しました。