Pythonのsys.argvでコマンドライン引数を取得する基本と使い方

# file: show_argv.py
import sys  # sysモジュールをインポート

def main():
    # sys.argvは「リスト」。中身と個数を表示します。
    print("argv:", sys.argv)
    print("length:", len(sys.argv))
    # 先頭要素(argv[0])はスクリプト名(パス)であることが多い
    print("argv[0]:", sys.argv[0])

if __name__ == "__main__":
    main()

# file: where_to_import.py
import sys  # 1. 先頭でインポート(推奨)

def parse_args():
    # 2. 関数内でsys.argvを使える
    return sys.argv[1:]  # スクリプト名を除いた引数部分

def main():
    args = parse_args()
    print("args:", args)

if __name__ == "__main__":
    # 3. エントリーポイントから処理開始
    main()

# Windows (PowerShell/Command Prompt)
python show_argv.py apple 123 --debug

# macOS / Linux (bash/zsh)
python3 show_argv.py apple 123 --debug

# file: greet_and_age.py
import sys

def main():
    if len(sys.argv) < 3:
        print("使い方: python greet_and_age.py <name> <age>")
        return

    name = sys.argv[1]             # 文字列のまま使う
    age_str = sys.argv[2]          # 文字列として受け取る
    try:
        age = int(age_str)         # 必要に応じて数値に変換
    except ValueError:
        print(f"年齢は数値で指定してください: {age_str!r}")
        return

    print(f"こんにちは、{name}さん。あなたは{age}歳ですね。")

if __name__ == "__main__":
    main()

# file: list_args.py
import sys

def main():
    args = sys.argv[1:]  # スクリプト名を除く全部
    if not args:
        print("引数がありません。")
        return

    # インデックスも使いたい場合はenumerateを利用
    for i, arg in enumerate(args, start=1):
        print(f"第{i}引数: {arg}")

if __name__ == "__main__":
    main()

# file: need_two_args.py
import sys

def main():
    if len(sys.argv) < 3:
        print("使い方: python need_two_args.py <src> <dst>")
        # 終了コードを明示すると親プロセスに失敗を伝えられる
        sys.exit(2)

    src = sys.argv[1]
    dst = sys.argv[2]
    print(f"コピー元: {src}, コピー先: {dst}")

if __name__ == "__main__":
    main()

# file: count_lines.py
import sys

def count_lines(path: str) -> int:
    # 可能ならwith構文で安全にファイルを開く
    with open(path, "r", encoding="utf-8") as f:
        return sum(1 for _ in f)

def main():
    if len(sys.argv) < 2:
        print("使い方: python count_lines.py <file>")
        sys.exit(2)

    path = sys.argv[1]
    try:
        n = count_lines(path)
    except FileNotFoundError:
        print(f"ファイルが見つかりません: {path!r}")
        sys.exit(1)
    except UnicodeDecodeError:
        print(f"文字コードの問題が発生しました。encodingの指定を見直してください: {path!r}")
        sys.exit(1)

    print(f"{path}: {n} 行")

if __name__ == "__main__":
    main()

# file: sum_to_n.py
import sys

def sum_to_n(n: int) -> int:
    # 高速に求める公式: n(n+1)//2
    return n * (n + 1) // 2

def main():
    if len(sys.argv) < 2:
        print("使い方: python sum_to_n.py <N>")
        sys.exit(2)

    try:
        n = int(sys.argv[1])
    except ValueError:
        print("Nは整数で指定してください。")
        sys.exit(2)

    if n < 0:
        print("Nは0以上で指定してください。")
        sys.exit(2)

    total = sum_to_n(n)
    print(f"1から{n}までの総和: {total}")

if __name__ == "__main__":
    main()

# file: flags_demo.py
import sys
from datetime import datetime

def main():
    args = sys.argv[1:]

    # --debug が含まれているかを判定(位置はどこでもOK)
    debug = "--debug" in args

    # 位置引数(フラグ以外)だけを取り出す簡易処理
    positional = [a for a in args if not a.startswith("--")]
    if not positional:
        print("使い方: python flags_demo.py [--debug] <name>")
        sys.exit(2)

    name = positional[0]

    if debug:
        print(f"[DEBUG {datetime.now()}] argv={sys.argv!r}")

    print(f"Hello, {name}!")

if __name__ == "__main__":
    main()

# 悪い例: 直接アクセスしてしまう
# name = sys.argv[1]  # 引数がなければIndexError

# 良い例: 先にチェック
import sys
if len(sys.argv) < 2:
    print("使い方: python script.py <name>")
    sys.exit(2)
name = sys.argv[1]
print(f"name={name}")

# Windows (PowerShell/Command Prompt) は通常ダブルクォート
python3 show_argv.py "My Document.txt" "こんにちは 世界"

# macOS / Linux (bash/zsh) はシングル or ダブルどちらも可
python3 show_argv.py 'My Document.txt' 'こんにちは 世界'

# file: show_paths.py
import sys, os

print("cwd:", os.getcwd())
print("argv[0]:", sys.argv[0])
if len(sys.argv) > 1:
    print("arg1 (as given):", sys.argv[1])

# file: debug_argv.py
import sys
print("argv(repr):", repr(sys.argv))