affaan-m/python-patterns

Python 专属的设计模式与最佳实践，包括协议（Protocol）、数据类（dataclasses）、上下文管理器（context managers）、装饰器（decorators）、async/await、类型提示（type hints）以及包的组织方式。在编写 Python 代码以应用 Pythonic 模式时使用。

编程协作开发 Agent Agent 技能调研仓库问答 Python 设计模式类型提示规范装饰器开发异步编程实践数据类建模协议鸭子类型

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

Python Patterns

This skill provides comprehensive Python patterns extending common design principles with Python-specific idioms.

Protocol (Duck Typing)

Use Protocol for structural subtyping (duck typing with type hints):

from typing import Protocol

class Repository(Protocol):
    def find_by_id(self, id: str) -> dict | None: ...
    def save(self, entity: dict) -> dict: ...

# Any class with these methods satisfies the protocol
class UserRepository:
    def find_by_id(self, id: str) -> dict | None:
        # implementation
        pass

    def save(self, entity: dict) -> dict:
        # implementation
        pass

def process_entity(repo: Repository, id: str) -> None:
    entity = repo.find_by_id(id)
    # ... process

Benefits:

Type safety without inheritance
Flexible, loosely coupled code
Easy testing and mocking

Dataclasses as DTOs

Use dataclass for data transfer objects and value objects:

from dataclasses import dataclass, field
from typing import Optional

@dataclass
class CreateUserRequest:
    name: str
    email: str
    age: Optional[int] = None
    tags: list[str] = field(default_factory=list)

@dataclass(frozen=T…

以下为摘要预览，完整内容请查看 GitHub 原文。

Python 模式

本 skill 提供全面的 Python 模式，将常见的设计原则与 Python 特有的惯用法相结合。

Protocol（鸭子类型）

使用 Protocol 实现结构化子类型（带类型提示的鸭子类型）：

from typing import Protocol

class Repository(Protocol):
    def find_by_id(self, id: str) -> dict | None: ...
    def save(self, entity: dict) -> dict: ...

# 任何具备这些方法的类都满足该协议
class UserRepository:
    def find_by_id(self, id: str) -> dict | None:
        # implementation
        pass

    def save(self, entity: dict) -> dict:
        # implementation
        pass

def process_entity(repo: Repository, id: str) -> None:
    entity = repo.find_by_id(id)
    # ... process

优点：

不通过继承也能保证类型安全
灵活、低耦合的代码
易于测试和打桩（mock）

用 dataclass 作为 DTO

使用 dataclass 表示数据传输对象和值对象：

from dataclasses import dataclass, field
from typing import Optional

@dataclass
class CreateUserRequest:
    name: str
    email: str
    age: Optional[int] = None
    tags: list[str] = field(default_factory=list)

@dataclass(frozen=True)
class User:
    """不可变的用户实体"""
    id: str
    name: str
    email: str

特性：