Python Toolchain 是一项面向 Python 项目开发的工具链技能,提供项目常用命令的速查参考。其内容围绕虚拟环境、测试、代码检查与格式化、运行、调试、打包、依赖管理等环节展开,帮助开发者在实际项目中快速找到对应命令。
用途 该技能适用于需要在 Python 项目中执行环境创建、依赖安装、测试运行、代码质量检查、调试与打包等日常任务的场景。它以便于查阅的命令集合形式组织,覆盖从环境准备到发布打包的主要环节。
主要能力 虚拟环境方面,提供了 venv 的创建与激活命令,以及基于 requirements.txt 的依赖安装;同时给出 Poetry 的安装、激活、添加依赖与添加开发依赖命令,以及 uv 的虚拟环境创建与依赖安装命令。 测试方面,包含 pytest 的基本运行、详细输出与简短回溯、按文件和关键字筛选、覆盖率报告,以及 unittest 的自动发现命令。 代码检查与格式化方面,包含 Ruff 的检查、自动修复与格式化,Black 格式化,以及 Mypy 类型检查。 运行方面,包含直接运行脚本、以模块方式运行、Flask 调试运行、Django 的 runserver、migrate 与 createsuperuser 命令。 调试方面,包含 PDB 调试器启动,以及通过单行命令查看 Python 版本和指定包版本。 打包方面,包含安装 build 工具、构建 wheel 与 sdist、以及可编辑安装。 依赖管理方面,包含列出过期依赖、冻结依赖到 requirements.txt,以及 pip-audit 安全审计。
使用方式 该技能以命令清单形式呈现,用户可依据当前任务在对应小节中查找命令并执行。资料中的命令均以代码形式给出,涵盖了 venv、Poetry、uv、pytest、unittest、Ruff、Black、Mypy、Flask、Django、PDB、build、pip 等工具的具体调用方式。另有注意事项提示:通过检查 pyproject.toml、setup.py 或 requirements.txt 来理解项目结构;优先使用虚拟环境以避免全局包冲突;为可移植性显式使用 python3 而非 python。
适用场景 适用于 Python 项目的本地开发与维护,例如搭建开发环境、安装依赖、编写并运行测试、统一代码风格、进行类型检查、启动 Web 应用、排查问题,以及构建分发包。也适合作为团队内统一操作命令的参考。
限制 资料未提供该技能的具体安装方式、集成方式或运行机制说明。未提供支持的 Python 版本范围、各工具的最低版本要求、操作系统限制或平台差异说明。未提供收费、价格或授权信息。未提供关于工具性能、兼容性或效果的任何承诺或数据。未提供示例项目或端到端操作步骤,使用时应以实际项目结构和工具官方文档为准。