NeteaseCloudMusic_PythonSDK/docs/开发指南.md

写个开发者的开发指南

开发

• 克隆项目 git clone git@github.com:2061360308/NeteaseCloudMusic_PythonSDK.git
• 安装依赖 pip install -r requirements.txt
• 目录/文件说明

├── package  项目包根目录
├── test_gender  生成测试代码的脚本
├── test.py  手动测试/ 使用示例

更新

项目使用towncrier自动生成更新日志

在 newsfragments 目录下，创建一个新的文本文件。这个文件的名字应该是一个唯一的编号，后缀是 .rst。 例如，如果你正在处理编号为 123 的问题，你可以创建一个名为 123.feature.rst 的文件。

注意在 towncrier 中，新闻片段的类型通常由文件名的后缀决定。以下是一些常见的新闻片段类型：

• .feature: 用于描述新的特性或者功能。
• .bugfix: 用于描述一个 bug 修复。
• .doc: 用于描述文档的更改。
• .removal: 用于描述移除的特性或者功能。
• .misc: 用于描述其他类型的更改。

在这个文件中，写下你的更改的描述。这个描述应该是简短的，通常只有一到两句话。 例如Added support for the XYZ feature.

发布新版本

自动： 运行 python publish.py

手动： 使用bumpversion自动更新版本号，提交并发布标签 你需要安装bumpversion然后执行

bumpversion patch  # for a patch level increase (e.g., 1.0.0 to 1.0.1)
bumpversion minor  # for a minor level increase (e.g., 1.0.0 to 1.1.0)
bumpversion major  # for a major level increase (e.g., 1.0.0 to 2.0.0)

接下来会自动更新版本号并提交到远程仓库，然后发布一个新的标签 workflow会依据标签自动发布相应资源并且发布到pypi