Function lesson_2_dependency_injection

tutorials/18_design_patterns_for_agents.py:179–338

对应源码: conversation.rs:100-110 pub struct ConversationRuntime { api_client: C, ← 从外部传入 tool_executor: T, ← 从外部传入 permission_policy: ..., ← 从外部传入 hook_runner: ..., ← 从外部传入 } 112-116: im

()

# ============================================================

def lesson_2_dependency_injection():
    """
    对应源码:
      conversation.rs:100-110
        pub struct ConversationRuntime<C, T> {
            api_client: C,          ← 从外部传入
            tool_executor: T,       ← 从外部传入
            permission_policy: ..., ← 从外部传入
            hook_runner: ...,       ← 从外部传入
        }

      112-116:
        impl<C, T> ConversationRuntime<C, T>
        where
            C: ApiClient,       ← 只要求实现 ApiClient 接口
            T: ToolExecutor,    ← 只要求实现 ToolExecutor 接口

    "依赖注入" 听起来很可怕, 其实就是:
    不要在内部 new, 而是从外部传进来。

    日常类比: 手机壳
    ─────────────
    手机不会在出厂时焊死一个壳。
    你从外面套上去——想换透明的? 硅胶的? 皮革的? 随便换。
    "手机" = ConversationRuntime, "手机壳" = ApiClient/ToolExecutor。
    """
    print("=" * 60)
    print("第二课: 依赖注入 — 插座: 从外部传入, 不在内部写死")
    print("=" * 60)

    # ---- 反面教材: 写死依赖 (不要这样!) ----
    print()
    print("  反面教材 (耦合):")
    print("  ──────────────")

    class BadRuntime:
        """糟糕的设计: API 客户端在内部写死"""
        def __init__(self):
            # 问题: 测试时怎么办? 没网络怎么办? 想换 API 怎么办?
            import urllib.request  # noqa: F401 — 演示"写死"
            self.api_url = "https://api.anthropic.com/v1/messages"

        def run(self, user_input: str):
            # 这里直接调 API——无法测试、无法替换
            pass

    print("    class BadRuntime:")
    print("        def __init__(self):")
    print("            self.api_url = 'https://api.anthropic.com/...'  # 写死!")
    print("    问题: 测试? 没网? 换服务? 全部改代码!")
    print()

    # ---- 正面教材: 依赖注入 ----
    print("  正面教材 (注入):")
    print("  ──────────────")

    class ApiClient(ABC):
        @abstractmethod