现代蟒蛇

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用此技能

创建新的 Python 项目或包 设置 pyproject.toml 配置 配置开发工具(linting、格式化、测试) 编写具有外部依赖项的 Python 脚本 从旧工具迁移(当用户请求时)

何时不使用此技能

用户希望保留遗留工具:如果明确请求,则尊重现有工作流程 需要 Python < 3.11:这些工具针对现代 Python 非 Python 项目:Python 不是主要的混合代码库

要避免的反模式

避免 · 使用 [tool.ty] python-version · [tool.ty.environment] python-version uv pip install · uv add 和 uv sync 手动编辑 pyproject.toml 以添加 deps · uv add <pkg> / uv remove <pkg> hatchling 构建后端 · uv_build (更简单,足以满足大多数情况)

工具概述

工具 · 用途 · 替换 uv · 包/依赖管理 · pip、virtualenv、pip-tools、pipx、pyenv ruff · 代码检查和格式化 · flake8、black、isort、pyupgrade、pydocstyle ty · 类型检查 · mypy、pyright(更快的替代方案) pytest · 覆盖率测试 · unittest

安全工具

工具 · 用途 · 运行时 shellcheck · Shell 脚本检查 · 预提交检测秘密 · 秘密检测 · 预提交 actionlint · 工作流语法验证 · 预提交,CI zizmor · 工作流安全审核 · 预提交,CI

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 modern-python.preview
# Create project with uv
uv init myproject
cd myproject

# Add dependencies
uv add requests rich

# Add dev dependencies
uv add --group dev pytest ruff ty

# Run code
uv run python src/myproject/main.py

# Run tools
uv run pytest
uv run ruff check .

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。