Python 项目工程化开发指南

文档目标：

以通俗易懂结构清晰的文档向读者展示如何做 Python 工程化

受众目标：

• Python 初学者
• Python 初级开发
• Python 中级开发

指南主要包含以下主题：

• [x] 快速上手（一个最通用，最初级的示例项目）
• [x] 开发前准备
  • [x] Python 环境的安装
  • [x] 虚拟环境管理
  • [x] IDE 的选择
• [x] Python 规范
  • [x] 风格规范
  • [x] 语言规范
• [x] 应用开发实践
  • [x] 初级教程(一个包含完整开发流程的示例项目)
    • [x] 初始化项目
    • [x] 功能开发
    • [x] 测试
    • [x] 打包发布
  • [x] 进阶教程
    • [x] 类型标注
    • [x] 使用配置系统
    • [x] 如何用好日志
    • [x] 异常管理
    • [x] 如何更好得测试
    • [x] 用信号解耦逻辑
    • [x] 支持插件化
  • [x] 项目管理
    • [x] 代码检测
    • [x] 项目结构
    • [x] 文档管理
    • [x] 打包发布
  • [ ] 开发实践
    • [ ] Web
      • [x] Fastapi
      • [ ] Django
      • [ ] Flask
    • [ ] 爬虫
      • [ ] Scrapy
      • [ ] aiohttp
    • [ ] 数据库
      • [ ] SQLAlchemy
• [x] 数据开发实践
  • [x] 初级教程

如果您对文档有任何建议或意见，欢迎提交 issues 进行讨论。当然我们更期待与您共同协作开发，让文档变得更加完善。

使用方式

1. 克隆项目

git clone https://github.com/pyloong/pythonic-project-guidelines

2. 初始化环境

项目预览需要安装 Python 环境来启动 server，强烈建议使用 Python 3.10+ 的版本。如果本地没有 Python 环境，也可以使用 Docker预览服务器 来启动。

2.1 本地初始化

创建虚拟环境：

python3 -m venv .venv
source .venv/bin/activate

安装依赖：

pip install -r requirements.txt

2.2 使用 Docker 初始化

docker pull squidfunk/mkdocs-material:9.1.11

3. 预览

3.1 本地预览

mkdocs serve

3.2 使用 Docker 预览

unix:

docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material:9.1.11

Windows:

docker run --rm -it -p 8000:8000 -v "%cd%":/docs squidfunk/mkdocs-material:9.1.11

协作规范

文档使用 Markdown 编写，使用 mkdocs 配合 mkdocs-material 主题构建。

• fork
• code
• pr