printで違いが出る__str__と__repr__についてわかりやすく解説

# Python 3.x

class User:
    # オブジェクト生成時に初期設定する (__init__)
    def __init__(self, name: str, age: int, token: str) -> None:
        # selfはインスタンス自身を指す
        self.name = name          # インスタンス変数
        self.age = age
        self.token = token        # 機密情報(表示しない)

    def __repr__(self) -> str:
        # 良いrepr: 型名 + 主要属性、機密は出さない。文字列は!rでrepr表示。
        return f"User(name={self.name!r}, age={self.age})"

    def __str__(self) -> str:
        # 読みやすい要約表示(ユーザー向け)
        return f"{self.name} ({self.age})"


# 悪い例: 機密を出す、情報が曖昧、型名が分からない、など
class BadUser:
    def __init__(self, name: str, age: int, token: str) -> None:
        self.name = name
        self.age = age
        self.token = token

    def __repr__(self) -> str:
        # 悪いrepr: 情報が少ない上に機密を漏洩している
        return f"name={self.name}, age={self.age}, token={self.token}"

    # __str__未定義 → str(obj)はrepr(obj)にフォールバック
    # (printでもこのreprが使われてしまい危険)
    

u = User("Taro", 29, token="SECRET-123456")
b = BadUser("Jiro", 31, token="TOP-SECRET-ABC")

print(u)           # __str__が使われる
print(repr(u))     # __repr__が使われる
print(f"{u}")      # __str__
print(f"{u!r}")    # __repr__
print([u, b])      # コンテナ表示は要素のreprを使う点に注意

class Plain:
    pass

p = Plain()
print(p)
print(repr(p))

import logging

class User:
    # オブジェクト生成時に初期設定する (__init__)
    def __init__(self, name: str, age: int, token: str) -> None:
        # selfはインスタンス自身を指す
        self.name = name          # インスタンス変数
        self.age = age
        self.token = token        # 機密情報(表示しない)

    def __repr__(self) -> str:
        # 良いrepr: 型名 + 主要属性、機密は出さない。文字列は!rでrepr表示。
        return f"User(name={self.name!r}, age={self.age})"

    def __str__(self) -> str:
        # 読みやすい要約表示(ユーザー向け)
        return f"{self.name} ({self.age})"

logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")

u = User("Taro", 29, token="SECRET-123456")

# ユーザー向け: 読みやすいstr
logging.info("処理対象ユーザー: %s", u)       # %s → str(u)
# 開発者向け: 詳細なrepr
logging.info("詳細(デバッグ用): %r", u)       # %r → repr(u)

# f文字列でも同様
print(f"対象: {u}")       # __str__
print(f"詳細: {u!r}")     # __repr__

import reprlib
from typing import Optional

class DataPacket:
    def __init__(self, title: str, payload: str) -> None:
        self.title = title
        self.payload = payload  # 大きい文字列を想定

    def __repr__(self) -> str:
        # 長い文字列はreprlibで短縮し、サイズも併記する
        r = reprlib.Repr()
        r.maxstring = 30  # 上限を調整可能
        payload_preview = r.repr(self.payload)
        return f"DataPacket(title={self.title!r}, payload={payload_preview}, size={len(self.payload)})"

    def __str__(self) -> str:
        # 要約: タイトルとサイズだけ
        return f"{self.title} [{len(self.payload)} bytes]"


# 再帰的なリンクを持つノード
class Node:
    def __init__(self, value: int, next: Optional["Node"]=None) -> None:
        self.value = value
        self.next = next

    def __repr__(self) -> str:
        # 簡易的な再帰ガード:
        # 自己参照っぽいときは...で省略
        nxt = "..." if self.next is self else repr(self.next)
        return f"Node(value={self.value}, next={nxt})"

    def __str__(self) -> str:
        # 要約表示
        return f"Node[{self.value}]"


packet = DataPacket("snapshot", "X" * 120)
n = Node(1)
n.next = n  # 自己参照

print(packet)       # __str__
print(repr(packet)) # __repr__ 短縮を確認
print(n)            # __str__
print(repr(n))      # __repr__ 再帰省略を確認

users = [User("A", 20, "tok1"), User("B", 30, "tok2")]
print(users)           # reprで並ぶ
print(", ".join(str(u) for u in users))  # 必要なら自分でstrを明示
print(f"{users!r}")    # f文字列でも!rでreprを強制