主要观点:介绍了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
可避免确定场景的最新哈希。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。