5分钟上手poetry-dynamic-versioningPoetry动态版本控制插件安装教程【免费下载链接】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的标签自动生成项目版本号。本教程将帮助你快速完成插件的安装与基础配置让版本管理变得简单高效插件简介什么是poetry-dynamic-versioningpoetry-dynamic-versioning是Python 3.7环境下的Poetry插件通过Dunamai实现基于VCS标签的动态版本控制。它支持Git、Mercurial等多种版本控制系统能够在执行poetry build等命令时自动将版本号注入pyproject.toml和代码文件如包含__version__的Python文件并在操作完成后自动还原修改保持仓库清洁。准备工作安装前的环境检查在开始安装前请确保你的环境满足以下条件Poetry版本 ≥ 1.2.0推荐2.0.0Python版本 ≥ 3.7已安装Git等版本控制系统用于标签管理你可以通过以下命令检查Poetry版本poetry --version快速安装3种方式任选方式1Poetry 2.0.0 项目内安装推荐在项目的pyproject.toml中添加插件依赖[tool.poetry.requires-plugins] poetry-dynamic-versioning { version 1.0.0,2.0.0, extras [plugin] }执行安装命令poetry install方式2全局安装适用于Poetry 1.2.0-1.9.0直接通过Poetry命令全局安装poetry self add poetry-dynamic-versioning[plugin]方式3Pipx安装如果Poetry通过Pipx安装若你的Poetry是通过Pipx安装的使用以下命令pipx 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兼容[build-system] requires [poetry-core1.0.0, poetry-dynamic-versioning1.0.0,2.0.0] build-backend poetry_dynamic_versioning.backend基础使用创建标签与构建项目1. 创建版本标签使用Git创建版本标签以v0.1.0为例git tag v0.1.0 -m Initial release git push origin v0.1.02. 构建项目执行poetry build命令插件会自动读取标签并生成版本号poetry build构建完成后生成的sdist和wheel文件将包含正确的版本号。插件会自动还原对pyproject.toml的修改无需担心仓库污染。常见问题解决安装与使用中的痛点Q1安装后插件不生效怎么办A检查pyproject.toml中[tool.poetry-dynamic-versioning]下的enable true是否配置正确或尝试重新执行poetry dynamic-versioning enable。Q2如何自定义版本格式A通过format或format-jinja配置项自定义版本格式。例如[tool.poetry-dynamic-versioning] format v{base}{distance}.{commit}Q3支持哪些版本控制系统A支持Git、Mercurial、Darcs、Bazaar、Subversion、Fossil、Pijul等具体可参考Dunamai文档。总结开启高效版本管理之旅通过本教程你已掌握poetry-dynamic-versioning的安装、配置和基础使用方法。这款插件能帮助你告别手动修改版本号的繁琐让版本管理完全基于VCS标签自动化特别适合持续集成和频繁发布的项目。现在就尝试在你的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），仅供参考