GitHub - astral-sh/packse: Python 打包场景

主要观点:介绍了packse的相关功能,包括安装、使用场景、列出场景、查看场景、构建场景、发布场景、运行包索引、服务场景、测试场景、导出场景和编写新场景等。
关键信息:

  • 安装:通过pip install packse安装,安装后可使用packse命令行界面。
  • 使用场景:是依赖树的 JSON 描述,可在scenarios/examples/中查看示例。
  • 列出场景:使用packse list可列出可用场景,可指定文件读取,支持多个场景文件。
  • 查看场景:使用packse view可预览场景的依赖树,可指定场景名获取更多信息。
  • 构建场景:使用packse build生成包和构建分发,可指定场景文件,默认生成唯一标识符,可通过环境变量更改。
  • 发布场景:使用packse publish发布到 Python Package Index,默认到 Test PyPI 服务器,需提供凭证。
  • 运行包索引:安装index额外功能后可用packse index命令,可启动、停止本地包索引,可设置索引 URL 和离线模式。
  • 服务场景:安装serve额外功能后可用packse serve命令,可监控scenarios目录并发布更改。
  • 测试场景:使用pip install -i https://test.pypi.org/simple/安装发布的场景进行测试。
  • 导出场景:使用packse inspect导出场景信息为 JSON 格式。
  • 编写新场景:场景文件为 JSON 格式,可参考现有场景和Scenario类型的模式。

重要细节:

  • 场景文件可包含一个或多个场景,每个场景有唯一标识符。
  • 构建场景时默认生成基于场景内容和项目模板哈希的唯一标识符,可通过--no-hash排除。
  • 发布场景到 Test PyPI 服务器需提供PACKSE_PYPI_PASSWORD环境变量,可使用--anonymous或 API 令牌,非认证服务器可使用--anonymous
  • 运行本地包索引时,状态存储在~/.packse目录,可通过PACKSE_STATE_PATH环境变量更改,默认dist目录用于发布。
  • 服务场景时,使用--no-hash可避免确定场景的最新哈希。
阅读 12
0 条评论