用途:这是一套 Python 最佳实践规则,用于在编写 Python 代码、使用类型注解或遵循 PEP 标准时提供规范约束。
主要能力:要求所有函数签名使用类型注解;要求使用 Google 风格文档字符串,包含 Args、Returns、Raises;要求使用自定义异常而非通用 Exception。提供决策树:格式化用 f-strings,异步用 asyncio 与 async/await,数据类用 @dataclass 或 Pydantic,环境管理用 poetry 或 uv,类型检查在 CI 中运行 mypy。示例涵盖 3.10+ 模式匹配、dataclass、同步与异步上下文管理器。
使用方式:按规则编写代码,并可用命令执行:python -m venv .venv 创建虚拟环境,source .venv/bin/activate 激活(Unix),pip install -r requirements.txt 安装依赖,mypy src/ 类型检查,ruff check src/ 代码检查,pytest tests/ 运行测试。
适用场景:Python 项目开发、代码审查与规范统一。
限制:资料未提供具体版本兼容范围、性能数据或收费信息;扩展文档(PEP 8、FastAPI、Django、深度学习、网页抓取)仅列出文件名,内容暂未提供。