从0到1掌握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标签实现动态版本管理。它支持Git、Mercurial等多种版本控制工具通过自动化处理版本号让开发者告别手动修改版本的繁琐流程专注于代码开发本身。为什么选择poetry-dynamic-versioning在软件开发过程中版本管理是至关重要的一环。传统的手动版本控制方式不仅效率低下还容易出现人为错误。poetry-dynamic-versioning的出现为开发者提供了一种简单、高效的动态版本管理解决方案。使用该插件后你只需在版本控制系统中创建标签如git tag v0.1.0 -m New release插件就会自动将版本号插入到相关文件中如pyproject.toml或包含__version__的Python文件并在Poetry命令如poetry build执行完毕后自动恢复文件状态保持仓库的整洁。快速安装指南安装poetry-dynamic-versioning非常简单根据你使用的Poetry版本选择以下方法之一方法一Poetry 2.0.0在项目的pyproject.toml文件中添加以下配置然后运行poetry install[tool.poetry.requires-plugins] poetry-dynamic-versioning { version 1.0.0,2.0.0, extras [plugin] }方法二旧版Poetry大多数情况下poetry self add poetry-dynamic-versioning[plugin]如果使用Pipx安装Poetrypipx inject poetry poetry-dynamic-versioning[plugin]安装完成后在项目中运行以下命令启用插件poetry dynamic-versioning enable基础配置步骤启用插件后需要对项目进行简单配置。你可以手动编辑pyproject.toml文件添加以下内容[project] dynamic [version] [tool.poetry] version 0.0.0 [tool.poetry-dynamic-versioning] enable true此外为了确保与PEP 517构建前端的兼容性还需要在pyproject.toml中添加构建系统配置[build-system] requires [poetry-core1.0.0, poetry-dynamic-versioning1.0.0,2.0.0] build-backend poetry_dynamic_versioning.backendPoetry仍然要求tool.poetry.version字段存在建议使用version 0.0.0作为标准占位符。核心功能详解动态版本生成poetry-dynamic-versioning的核心功能是根据VCS标签动态生成版本号。默认情况下插件会使用Dunamai库来解析版本控制历史生成符合PEP 440标准的版本号。你可以通过配置[tool.poetry-dynamic-versioning]部分来自定义版本生成规则例如[tool.poetry-dynamic-versioning] enable true vcs git style semver metadata true dirty true文件内容替换插件不仅会更新pyproject.toml中的版本号还会自动替换项目中其他文件的版本占位符。默认情况下它会查找并替换以下文件中的版本信息*.py*/__init__.py*/__version__.py*/_version.py替换的模式包括__version__ 0.0.0__version_tuple__ (0, 0, 0)你可以通过[tool.poetry-dynamic-versioning.substitution]配置来自定义替换规则和文件列表。命令行模式除了作为Poetry插件自动运行外poetry-dynamic-versioning还提供了命令行模式允许你按需执行版本更新# 使用Poetry插件命令 poetry dynamic-versioning # 或使用独立脚本 poetry-dynamic-versioning这种模式会将动态版本应用到所有相关文件并保留更改方便你检查结果。高级配置选项poetry-dynamic-versioning提供了丰富的配置选项让你可以根据项目需求定制版本管理策略。以下是一些常用的高级配置自定义版本格式你可以使用format或format-jinja选项来自定义版本号的格式。例如[tool.poetry-dynamic-versioning] enable true format v{base}{distance}.{commit}或使用Jinja模板进行更复杂的格式化[tool.poetry-dynamic-versioning] enable true format-jinja {% if distance 0 %}{{ base }}{% else %}{{ base }}{{ distance }}.{{ commit }}{% endif %}文件特定配置通过[tool.poetry-dynamic-versioning.files]部分你可以为特定文件设置个性化的处理方式。例如[tool.poetry-dynamic-versioning.files.package/_version.py] persistent-substitution true initial-content # These version placeholders will be replaced later during substitution. __version__ 0.0.0 __version_tuple__ (0, 0, 0) 环境变量覆盖poetry-dynamic-versioning支持通过环境变量来临时覆盖版本设置例如POETRY_DYNAMIC_VERSIONING_BYPASS直接指定静态版本号POETRY_DYNAMIC_VERSIONING_OVERRIDE为特定包设置静态版本POETRY_DYNAMIC_VERSIONING_COMMANDS指定在哪些Poetry命令中激活动态版本常见问题解答Q: 动态版本在poetry run或poetry shell中不可用怎么办A: 这是由于Poetry的设计限制插件无法在这些命令后清理自身。你可以使用命令行模式手动生成版本文件或在项目中添加一个简单的版本获取脚本。Q: 如何处理Pip的隔离构建问题A: 较新版本的Pip默认支持树内构建或可以使用--use-featurein-tree-build选项。对于旧版本Pip建议先导出依赖再构建poetry export -f requirements.txt -o requirements.txt --without-hashes pip wheel -r requirements.txtQ: 如何在没有完整版本历史的情况下使用插件A: 插件支持从VCS归档中检测版本具体请参考Dunamai文档。总结poetry-dynamic-versioning为Poetry用户提供了强大而灵活的动态版本管理能力通过自动化版本号生成和文件替换大大简化了版本管理流程。无论是小型个人项目还是大型团队协作这款插件都能帮助你更专注于代码开发而不是繁琐的版本管理。现在就尝试在你的项目中集成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），仅供参考