40 lines
956 B
Markdown
40 lines
956 B
Markdown
---
|
||
paths:
|
||
- "**/*.py"
|
||
- "**/*.pyi"
|
||
---
|
||
# Python 模式 (Patterns)
|
||
|
||
> 本檔案擴展了 [common/patterns.md](../common/patterns.md)，包含 Python 特定內容。
|
||
|
||
## 協定 (Protocol / 鴨子型別)
|
||
|
||
```python
|
||
from typing import Protocol
|
||
|
||
class Repository(Protocol):
|
||
def find_by_id(self, id: str) -> dict | None: ...
|
||
def save(self, entity: dict) -> dict: ...
|
||
```
|
||
|
||
## 使用 Dataclasses 作為 DTO (資料傳輸物件)
|
||
|
||
```python
|
||
from dataclasses import dataclass
|
||
|
||
@dataclass
|
||
class CreateUserRequest:
|
||
name: str
|
||
email: str
|
||
age: int | None = None
|
||
```
|
||
|
||
## 上下文管理器 (Context Managers) 與 生成器 (Generators)
|
||
|
||
- 使用上下文管理器 (`with` 語句) 進行資源管理。
|
||
- 使用生成器進行延遲求值與具備記憶體效率的迭代。
|
||
|
||
## 參考資源
|
||
|
||
參見技能 (Skill)：`python-patterns`，獲取包含裝飾器 (Decorators)、併發 (Concurrency) 與包組織 (Package organization) 的全面模式。
|