sys.argv / sys.exit() / sys.path

import sys

# コマンドライン引数のリスト（0番目がスクリプト名）
sys.argv

# スクリプトを終了します（終了コードを指定できます）。
sys.exit(0)   # 正常終了
sys.exit(1)   # 異常終了

# モジュールの検索パスのリスト
sys.path

# Pythonのバージョン文字列
sys.version

# 実行環境のプラットフォーム
sys.platform

import sys

# sys.argv でコマンドライン引数を取得します。
# python script.py hello 42 と実行した場合:
print(sys.argv[0])  # スクリプト名: 『script.py』と出力されます。
print(sys.argv[1])  # 1番目の引数: 『hello』と出力されます。
print(sys.argv[2])  # 2番目の引数: 『42』と出力されます。
print(len(sys.argv))  # 引数の数: 『3』と出力されます。

# 引数が不足している場合のエラーチェック
if len(sys.argv) < 2:
    print('使い方: python script.py <ファイル名>', file=sys.stderr)
    sys.exit(1)  # 異常終了します。

# 引数を受け取って処理します。
filename = sys.argv[1]
print(f'処理するファイル: {filename}')

# sys.path にパスを追加してモジュールを読み込めるようにします。
sys.path.append('/path/to/my/modules')

# sys.version でバージョンを確認します。
print(sys.version)  # 例: 『3.12.0 (main, ...)』と出力されます。

# バージョン比較には version_info を使います。
if sys.version_info >= (3, 10):
    print('Python 3.10以降です。match文が使えます。')

# sys.platform で環境を判定します。
if sys.platform == 'win32':
    print('Windowsで実行中です。')
elif sys.platform == 'darwin':
    print('macOSで実行中です。')
else:
    print('Linuxで実行中です。')

# 標準エラー出力にメッセージを出力します。
print('エラーが発生しました。', file=sys.stderr)

『sys.argv』はコマンドラインからスクリプトに引数を渡すための基本的な仕組みです。すべての引数は文字列として格納されるため、数値として扱う場合は『int()』や『float()』で変換してください。より複雑な引数処理が必要な場合は標準ライブラリの『argparse』モジュールを使うと、ヘルプメッセージの自動生成や型変換・省略可能な引数などを簡単に実装できます。

『sys.exit()』は内部的に『SystemExit』例外を発生させます。そのため『try/except』で捕捉することも可能ですが、通常は捕捉せずにスクリプトを終了させます。終了コードはシェルスクリプトやCI/CDシステムが成功・失敗の判定に使います。エラー時は必ず0以外のコードで終了してください。

環境変数の取得は『os.environ / os.getenv()』を参照してください。