これだけで分かるPythonの_の使い方(一時変数/国際化/プライベート)

# 3回だけ処理したいが、カウンタ値自体は使わない例
for _ in range(3):
    print("tick")

# 緯度経度高度のタプルから、高度は捨てて緯度と経度だけ使う
def get_position():
    return (35.6895, 139.6917, 44)  # lat, lon, altitude

lat, lon, _ = get_position()  # 高度は捨てる
print(f"lat={lat}, lon={lon}")

names = ["Ada", "Grace", "Guido"]

# indexは不要
for _, name in enumerate(names):
    print(name.upper())

# 値は不要で、indexだけ使いたい
for i, _ in enumerate(names):
    print(f"position = {i}")

# 5要素の戻り値のうち、先頭と末尾だけ使う
def complex_result():
    return (1, "ignore1", "ignore2", "ignore3", 99)

head, _, _, _, tail = complex_result()
print(head, tail)

# 悪い例: 先に _ を翻訳関数として定義したのに、あとで捨て変数に使ってしまう
from gettext import gettext as _

print(_("Start"))  # ここはOK

for _ in range(3):  # ここで _ の束縛が int に上書きされる(モジュールスコープの場合)
    pass

print(_("End"))  # TypeError: 'int' object is not callable になる

# i18nの最小構成例: 資源がなければ原文のまま(フォールバック)
import gettext

# 実際には 'locale/<言語>/LC_MESSAGES/messages.mo' を用意します
localedir = "locale"
domain = "messages"
lang = "ja"

try:
    trans = gettext.translation(domain=domain, localedir=localedir, languages=[lang])
    _ = trans.gettext  # 慣習的に _ に束縛
except FileNotFoundError:
    _ = gettext.gettext  # フォールバック(翻訳なし)

print(_("Hello"))
name = "Taro"
# 変数埋め込みは f-string ではなく後段で format するのが定石
print(_("Hello, {name}!").format(name=name))

# よくある利用パターン
print(_("File not found"))
print(_("Permission denied"))

# 競合を避けるための別名パターン
from gettext import gettext as _t  # 翻訳関数は _t
for _ in range(3):  # こちらは捨て変数として _
    pass
print(_t("Done"))

# (REPLの例) 対話モードだけの振る舞い
# >>> 1 + 2
# 3
# >>> _
# 3
# >>> _ + 10
# 13

# スクリプトでは上記のような自動束縛は起きません。
# _ は自分で代入した時だけ意味を持ちます。

class Cache:
    def __init__(self):
        self._store = {}  # 内部用
    def set(self, key, value):
        self._store[key] = value
    def get(self, key, default=None):
        return self._store.get(key, default)

c = Cache()
c.set("x", 10)
print(c.get("x"))
# 可能だが非推奨: 外部から _store を直接触る
print("internal keys =", list(c._store.keys()))

class User:
    def __init__(self, token: str):
        self.__token = token  # マングリング対象
    def masked(self) -> str:
        return self.__token[:2] + "***"

u = User("ABCD1234")
print(u.masked())

# 直接アクセスは失敗する
try:
    print(u.__token)
except AttributeError as e:
    print("AttributeError:", e)

# 実際の属性名(マングリング後)を使えば参照できてしまう(非推奨)
print("mangled access =", u._User__token)

# 確認
print([name for name in dir(u) if "token" in name])

# mylib.py
__all__ = ["public_func"]  # 公開APIを明示

_public = "visible-but-not-exported"  # 先頭1つ -> import * では除外(ただし __all__ があればそちらが優先)
_internal = 42  # これも非公開意図

def public_func():
    return "I am public"

def _helper():
    return "I am internal"

# main.py
from mylib import *

print(public_func())

# 非公開名は import * で入ってこない
names = [n for n in dir() if n.endswith(("helper", "_internal", "_public"))]
print("imported names:", names)

# 明示的に import すれば取れるが、慣習上は避ける
import mylib
print("explicit:", mylib._helper(), mylib._internal)