为什么选择poetry-dynamic-versioning5大优势助你提升开发效率【免费下载链接】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设计的动态版本管理插件能够基于Git、Mercurial等版本控制系统VCS的标签自动生成版本号让开发者告别手动修改版本的繁琐流程。作为Poetry生态中不可或缺的工具它通过自动化版本管理、灵活配置和无缝集成帮助团队提升开发效率确保版本信息的准确性和一致性。1. 基于VCS标签的全自动版本生成 ✨传统版本管理需要手动修改pyproject.toml或__version__变量容易出现疏漏或冲突。而poetry-dynamic-versioning通过分析VCS标签如git tag v1.2.3自动生成版本号彻底解放人工操作。当你执行poetry build等命令时插件会从Git/Mercurial等VCS中读取最新标签自动计算距离上次标签的提交次数如1.2.3.post5检测未提交修改并添加dirty标记如1.2.3dirty生成符合PEP 440规范的版本字符串配置示例pyproject.toml[tool.poetry-dynamic-versioning] enable true vcs git # 支持git/mercurial/subversion等 style pep440 # 自动生成符合PEP 440规范的版本2. 多文件版本同步保持一致性 项目中通常需要在多处维护版本信息如__init__.py、_version.py或文档文件手动同步容易出错。poetry-dynamic-versioning提供强大的版本替换功能自动更新所有指定文件的版本占位符。核心特性默认替换*.py文件中的__version__ 0.0.0和__version_tuple__ (0, 0, 0)支持自定义正则表达式匹配任意版本格式如VERSION dev可配置文件路径和替换规则覆盖源码、文档等多种场景配置示例[tool.poetry-dynamic-versioning.substitution] files [*.py, docs/version.txt] # 需要替换的文件 patterns [ (^__version__\s*\s*[])[^]*([]), # 匹配字符串格式版本 (^VERSION\s*\s*[])[^]*([]), # 自定义格式 ]3. 灵活的版本格式定制满足多样化需求 ️不同项目可能需要遵循不同的版本规范如SemVer、PEP 440或自定义格式。poetry-dynamic-versioning提供丰富的配置选项支持从简单到复杂的版本格式定义。主要定制方式预设风格直接选择pep440、semver或pvp自定义格式通过format参数组合版本组件如v{base}{distance}.{commit}Jinja模板使用format-jinja实现复杂逻辑如条件判断、版本递增Jinja模板示例[tool.poetry-dynamic-versioning] format-jinja {% if distance 0 %} {{ base }} # 无新提交时使用纯标签版本 {% else %} {{ base }}.dev{{ distance }}{{ commit }} # 有新提交时添加开发标记 {% endif %} 4. 与Poetry生态无缝集成零侵入工作流 作为官方认证的Poetry插件poetry-dynamic-versioning与Poetry命令体系深度融合无需改变现有开发习惯。插件在执行poetry build、poetry publish等命令时自动激活完成版本注入后自动还原文件修改保持工作区清洁。关键集成点支持Poetry 1.2.0的插件系统通过poetry self add poetry-dynamic-versioning[plugin]安装兼容PEP 517构建后端确保pip install .等命令正常工作提供poetry dynamic-versioning命令支持手动触发版本生成和文件更新安装命令# 全局安装插件 poetry self add poetry-dynamic-versioning[plugin] # 项目初始化配置 poetry dynamic-versioning enable5. 严格遵循规范兼容主流工具链 poetry-dynamic-versioning生成的版本号严格遵循PEP 440规范确保与PyPI、setuptools等工具兼容。同时支持多种高级场景满足复杂项目需求版本递增bump自动递增补丁号如从1.2.3变为1.2.4.dev5分支特定版本通过tag-branch参数为不同分支生成独立版本环境变量覆盖使用POETRY_DYNAMIC_VERSIONING_BYPASS强制指定版本适合CI/CD持久化替换通过persistent-substitution保留部分文件的版本修改适合可编辑安装快速开始使用指南 安装插件poetry self add poetry-dynamic-versioning[plugin]初始化项目配置poetry dynamic-versioning enable创建VCS标签git tag v1.0.0 -m Initial stable release构建项目poetry build # 自动生成版本并注入到构建产物中通过以上步骤你的项目即可实现基于VCS标签的全自动版本管理告别手动操作专注核心开发总结poetry-dynamic-versioning通过自动化版本生成、多文件同步、灵活定制、无缝集成和规范兼容五大优势为Poetry项目提供了完整的动态版本解决方案。无论是小型库还是大型应用都能显著减少版本管理的工作量降低人为错误风险让开发流程更高效、更可靠。立即尝试将其集成到你的Poetry项目中体验现代化版本管理的便捷与强大【免费下载链接】poetry-dynamic-versioningPlugin for Poetry to enable dynamic versioning based on VCS tags项目地址: https://gitcode.com/gh_mirrors/po/poetry-dynamic-versioning创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考