SuperAPI AI 工具集

setup-python-project

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:在创建全新 Python 项目时使用,让新项目一开始就带上完整的工具与配置“安全网”。资料中的模板位于 ~/Projects/docs/dev/python_coding/templates/。

主要能力:按清单生成项目骨架,包括源码、单元测试、集成测试、fixtures、脚本、文档与 VS Code 配置目录;复制 pyproject.toml、AGENTS.md、.pre-commit-config.yaml、.gitignore、VS Code settings 与 extensions、coding_rules.md 等模板文件。

使用方式:先执行 mkdir -p src/APPNAME tests/unit tests/integration tests/fixtures scripts docs .vscode 创建目录;再将 templates/ 下对应文件复制到目标位置,并按提示更新 pyproject.toml 的 [project] 段与 AGENTS.md 的 TODO 部分;随后创建 src/APPNAME/init.py、src/APPNAME/main.py 入口与 tests/test_main.py 初始测试。最后执行 git init、uv sync --all-extras --group dev、uv run pre-commit install、uv run poe lint_full、uv run poe test,并用 uv run poe app 验证应用可运行、lint_full 零错误、test 通过。

可选定制:Qt 应用可取消注释 pyproject.toml 中的 PySide6/qasync 并新增 ui/ 目录;CLI 应用取消注释 typer 并新增 cli/ 目录;HTTP 客户端取消注释 httpx;需要封装限制时可添加 [tool.ruff.lint.flake8-tidy-imports.banned-api] 段。详细布局见 guides/project-layout.md。

限制:资料未提供模板文件的具体内容、支持的 Python 版本、平台范围与失败排查说明。