poetry-dynamic-versioning实战案例让你的项目版本号自动更新【免费下载链接】poetry-dynamic-versioningPlugin for Poetry to enable dynamic versioning based on VCS tags项目地址: https://gitcode.com/gh_mirrors/po/poetry-dynamic-versioningpoetry-dynamic-versioning是一款为Poetry打造的动态版本管理插件能够根据VCS标签自动生成和更新项目版本号彻底告别手动修改版本的繁琐流程。无论是开发测试还是正式发布它都能帮你实现版本管理的自动化与标准化。 快速安装三步开启自动版本管理1. 安装插件通过Poetry命令快速安装最新版插件poetry add poetry-dynamic-versioning[plugin] --dev如果你使用Pipx安装Poetry需执行pipx inject poetry poetry-dynamic-versioning[plugin]2. 配置pyproject.toml在项目配置文件中添加以下内容启用动态版本管理[tool.poetry-dynamic-versioning] enable true vcs git # 支持git、hg等版本控制系统3. 初始化版本控制执行以下命令完成插件初始化poetry dynamic-versioning enable⚙️ 核心功能让版本号自己生长基于Git标签的智能版本生成插件会自动分析Git标签历史生成符合语义化版本规范的版本号。例如当最新标签为v1.2.3且有3个新提交时版本号会自动生成为1.2.4.dev3打上新标签v1.3.0后版本号会同步更新为正式版1.3.0多场景版本应用通过配置pyproject.toml可以将动态生成的版本号应用到多个场景1. 项目元数据pyproject.toml[tool.poetry] name your-project version 0.0.0 # 此处会被插件自动替换2. 源码文件如__init__.py添加版本占位符__version__ 0.0.0 # {poetry-dynamic-versioning}在配置文件中指定替换规则[tool.poetry-dynamic-versioning.substitution] files [your_project/__init__.py]3. 文档文件自动更新文档中的版本信息[tool.poetry-dynamic-versioning.files.docs/version.txt] content Current version: {version} 实战应用从开发到发布的全流程开发阶段自动生成开发版本在日常开发中每次提交代码后版本号会自动更新为开发版本格式主版本.次版本.修订号.dev提交次数。执行poetry build时插件会自动注入当前动态版本poetry build # 生成包含动态版本的分发包发布阶段一键打标签发布当需要发布正式版本时只需创建Git标签并推送git tag v1.0.0 git push origin v1.0.0插件会自动识别新标签并将版本号更新为1.0.0无需手动修改任何文件。️ 高级配置定制你的版本规则自定义版本格式通过format选项定制版本号格式[tool.poetry-dynamic-versioning] format v{major}.{minor}.{patch}-{commit}分支特定版本规则为不同分支设置差异化版本策略[tool.poetry-dynamic-versioning.branch.dev] format {version}-dev [tool.poetry-dynamic-versioning.branch.release/*] format {version}-rc{distance}完整配置示例查看项目中的pyproject.toml文件可获取完整的配置样例和参数说明。 常见问题与解决方案Q: 版本号没有自动更新怎么办A: 请检查是否正确安装了poetry-dynamic-versioning[plugin]Git仓库是否有提交记录和标签配置文件中[tool.poetry-dynamic-versioning]部分是否正确设置Q: 如何在CI/CD流程中使用A: 在CI脚本中添加poetry self add poetry-dynamic-versioning[plugin] poetry dynamic-versioning 学习资源官方文档README.md配置参考pyproject.toml变更记录CHANGELOG.md通过poetry-dynamic-versioning你可以将版本管理从手动操作转变为自动化流程让团队更专注于代码开发而非版本号维护。立即尝试体验现代化版本管理的便捷与高效【免费下载链接】poetry-dynamic-versioningPlugin for Poetry to enable dynamic versioning based on VCS tags项目地址: https://gitcode.com/gh_mirrors/po/poetry-dynamic-versioning创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考