Python 3.15: 「引数が渡されなかった」を表す値は組み込みの sentinel で作る

これまでの書き方の困りごと

_MISSING = object()

def get(key, default=_MISSING):
    ...
    if default is _MISSING:
        raise KeyError(key)

• help() やエラーメッセージに <object object at 0x7f...> と出て読みにくい
• copy.deepcopy や pickle を通ると別のオブジェクトになり、is の比較が壊れる
• 型ヒントで「この番兵か int」を書きにくい（Enum を作るなどの回り道が必要だった）

3.15 の書き方

MISSING = sentinel("MISSING")

def get(key: str, default: int | MISSING = MISSING) -> int:
    if default is MISSING:
        raise KeyError(key)
    return default

print(MISSING)  # MISSING

• 比較は今まで通り is で行う。
• | で型式に使える。コピーしても同一性が保たれ、モジュールの名前と変数名でインポートできる位置に置けば pickle も通る。

注意点

• 3.15 より前もサポートするライブラリでは、まだ使えない（typing_extensions などの互換実装があるかは要確認）。
• 型チェッカー（mypy / pyright など）が int | MISSING を理解するかはそれぞれの対応状況による。
• 同じく 3.15 で組み込みに入った frozendict、明示的な遅延 import（lazy import）もあわせて確認しておくとよい。3.15 の別の変更は Python 3.15: contextmanager をジェネレータ・async 関数のデコレータにしたときの挙動が変わる。

出典

• @driscollis · 2026-10-21
• What's new in Python 3.15（PEP 661: Add sentinel built-in type）: docs.python.org