Pythonのexit(1)とは？終了コードの意味も解説！（プログラム終了：戻り値：エラーコード：sys.exit：正常終了と異常終了など）

import sys

# 正常終了（終了コード0）
# exit(0)

# 異常終了（終了コード1）
# exit(1)

# 終了コードの確認方法
print("終了コードの基本ルール：")
print("exit(0) → 正常終了")
print("exit(1) → 異常終了（一般的なエラー）")
print("exit(2) → コマンドライン引数のエラーなど")

# 出力結果：終了コードの基本ルール：
# 出力結果：exit(0) → 正常終了
# 出力結果：exit(1) → 異常終了（一般的なエラー）
# 出力結果：exit(2) → コマンドライン引数のエラーなど

import sys

def check_data(data):
    if data is None:
        print("エラー：データがNoneです。")
        sys.exit(1)   # 異常終了

    if len(data) == 0:
        print("エラー：データが空です。")
        sys.exit(1)   # 異常終了

    return True

# 正常なデータ
data = ["アボカド", "サーモン", "ドラゴンフルーツ"]
if check_data(data):
    print(f"データ件数：{len(data)}件")
    sys.exit(0)   # 正常終了

# 出力結果：データ件数：3件

import sys

def process():
    print("処理を開始します。")
    sys.exit(1)   # SystemExit例外を発生させる
    print("ここは実行されません。")

try:
    process()
except SystemExit as e:
    print(f"SystemExitを捕捉：終了コード = {e.code}")
    # 終了コードに応じた後処理
    if e.code != 0:
        print("異常終了を検知しました。後処理を実行します。")

# 出力結果：処理を開始します。
# 出力結果：SystemExitを捕捉：終了コード = 1
# 出力結果：異常終了を検知しました。後処理を実行します。

import sys

# exit()とquit()の実体を確認
print(type(exit))    # siteモジュールのQuitter型
print(type(quit))    # siteモジュールのQuitter型

# sys.exit()はsysモジュールの関数
print(type(sys.exit))

# どちらもSystemExitを発生させる点は同じ
# exit(0) → SystemExit(0)
# sys.exit(0) → SystemExit(0)

# 出力結果：<class 'site.Quitter'>
# 出力結果：<class 'site.Quitter'>
# 出力結果：

import os
import atexit

# atexit登録した関数はsys.exit()では呼ばれるが
# os._exit()では呼ばれない
def cleanup():
    print("後処理を実行しました。")

atexit.register(cleanup)

print("処理中...")

# sys.exit(0)なら後処理（cleanup）が実行される
# os._exit(0)は後処理をスキップして即座に終了する

# 通常はsys.exit()を使用
# マルチプロセスのワーカープロセスなど特殊な場合のみos._exit()を使う
print("sys.exit()を使う場合は後処理が実行されます。")

# 出力結果：処理中...
# 出力結果：sys.exit()を使う場合は後処理が実行されます。
# 出力結果：後処理を実行しました。（プログラム終了時に実行）

import sys
import os

def process_file(filepath):
    # ファイルの存在確認
    if not os.path.exists(filepath):
        print(f"エラー：ファイルが見つかりません → {filepath}")
        sys.exit(1)

    # ファイルの読み込み処理
    try:
        with open(filepath, "r", encoding="utf-8") as f:
            lines = f.readlines()
        print(f"読み込み成功：{len(lines)}行")
        sys.exit(0)   # 正常終了

    except PermissionError:
        print(f"エラー：ファイルの読み込み権限がありません → {filepath}")
        sys.exit(1)

    except Exception as e:
        print(f"予期しないエラー：{e}")
        sys.exit(1)

# テスト用ファイルを作成して処理
with open("/home/claude/test.txt", "w") as f:
    f.write("アボカド\nサーモン\nゴリラ茶")

process_file("/home/claude/test.txt")

# 出力結果：読み込み成功：3行

import sys

def validate_args(args):
    # 引数が必要な数あるか確認
    if len(args) < 2:
        print(f"使い方：python script.py <商品名>")
        print(f"エラー：引数が不足しています。")
        sys.exit(2)   # 引数エラーは終了コード2が慣例

    product_name = args

    # 入力値のバリデーション
    if not product_name.strip():
        print("エラー：商品名が空です。")
        sys.exit(1)

    return product_name

# sys.argvをシミュレート
simulated_args = ["script.py", "アボカド"]

product = validate_args(simulated_args)
print(f"商品名：{product}")
print("バリデーション成功")

# 出力結果：商品名：アボカド
# 出力結果：バリデーション成功

import sys

def run_checks():
    results = []

    # チェック1：データ件数の確認
    data = ["アボカド", "サーモン", "ドラゴンフルーツ"]
    if len(data) > 0:
        print("✓ データ件数チェック：OK")
        results.append(True)
    else:
        print("✗ データ件数チェック：NG")
        results.append(False)

    # チェック2：必須項目の確認
    required = ["アボカド", "ゴリラ茶"]
    missing = [item for item in required if item not in data]
    if not missing:
        print("✓ 必須項目チェック：OK")
        results.append(True)
    else:
        print(f"✗ 必須項目チェック：NG（不足：{missing}）")
        results.append(False)

    # すべてのチェックが通った場合のみ正常終了
    if all(results):
        print("すべてのチェックが完了しました。")
        sys.exit(0)
    else:
        print("一部のチェックが失敗しました。")
        sys.exit(1)

run_checks()

# 出力結果：✓ データ件数チェック：OK
# 出力結果：✗ 必須項目チェック：NG（不足：['ゴリラ茶']）
# 出力結果：一部のチェックが失敗しました。

import sys
import subprocess

# Pythonスクリプトの終了コードをsubprocessで確認
script_success = """
import sys
print("正常処理完了")
sys.exit(0)
"""

script_failure = """
import sys
print("エラーが発生しました")
sys.exit(1)
"""

# 正常終了のスクリプトを実行
result = subprocess.run(
    ["python3", "-c", script_success],
    capture_output=True, text=True
)
print(f"正常終了の終了コード：{result.returncode}")

# 異常終了のスクリプトを実行
result2 = subprocess.run(
    ["python3", "-c", script_failure],
    capture_output=True, text=True
)
print(f"異常終了の終了コード：{result2.returncode}")

# 出力結果：正常終了の終了コード：0
# 出力結果：異常終了の終了コード：1

import sys
import subprocess

# 未処理の例外でプログラムが終了した場合の終了コード
script_with_exception = """
# 未処理の例外は自動的に終了コード1で終了する
raise ValueError("予期しないエラーが発生しました")
"""

result = subprocess.run(
    ["python3", "-c", script_with_exception],
    capture_output=True, text=True
)
print(f"例外発生時の終了コード：{result.returncode}")
print(f"エラー出力：{result.stderr.strip()}")

# 出力結果：例外発生時の終了コード：1
# 出力結果：エラー出力：Traceback (most recent call last): ... ValueError: 予期しないエラーが発生しました

import sys

# sys.exit()には文字列も渡せる（終了コードは1として扱われる）
def check_config(config):
    if "api_key" not in config:
        # 文字列を渡すとstderrに出力されて終了コード1で終了する
        sys.exit("エラー：api_keyが設定されていません。")

    return True

config = {"host": "localhost", "port": 8080}

try:
    check_config(config)
except SystemExit as e:
    print(f"終了メッセージ：{e}")
    print(f"終了コード相当：{1 if e.code else 0}")

# 出力結果：終了メッセージ：エラー：api_keyが設定されていません。
# 出力結果：終了コード相当：1