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标签实现动态版本管理让你的Python项目版本管理更加自动化和高效。本文将从基础设置到高级定制全面介绍如何使用这款插件提升你的开发 workflow。 快速安装指南安装poetry-dynamic-versioning插件非常简单只需在你的项目中执行以下命令poetry dynamic-versioning enable这条命令会自动配置Poetry以启用动态版本管理功能。安装完成后你可以通过poetry dynamic-versioning命令查看插件状态和执行版本更新操作。⚙️ 基础配置步骤项目设置首先确保你的pyproject.toml文件中包含以下基础配置[tool.poetry-dynamic-versioning]这个配置块是插件的核心设置区域所有与动态版本相关的选项都将在这里定义。版本模板设置最基础的配置是设置版本号模板。你可以在配置块中添加如下设置[tool.poetry-dynamic-versioning] version-format 0.1.{commit-count}{git-sha}这个配置将生成类似0.1.42abc1234的版本号其中包含提交次数和Git SHA值。 核心功能详解自动版本生成poetry-dynamic-versioning最核心的功能是根据VCS标签自动生成版本号。当你运行poetry dynamic-versioning插件会分析你的Git历史查找最新的标签并基于此生成新版本号。运行后会输出版本变更摘要让你清晰了解版本更新情况。与Poetry命令集成插件与Poetry的常用命令如build和publish无缝集成。你可以直接运行poetry build这将自动应用动态生成的版本号到构建产物中无需手动干预。️ 高级定制选项自定义版本格式你可以通过version-format选项高度定制版本号格式。例如[tool.poetry-dynamic-versioning] version-format {major}.{minor}.{patch}-{pre-release}{build-metadata}支持的占位符包括{major}: 主版本号{minor}: 次版本号{patch}: 补丁版本号{commit-count}: 提交次数{git-sha}: Git提交哈希{branch}: 当前分支名分支特定配置对于多分支开发场景你可以为不同分支设置不同的版本规则[tool.poetry-dynamic-versioning.branch.dev] version-format {major}.{minor}.{patch}-dev.{commit-count} [tool.poetry-dynamic-versioning.branch.main] version-format {major}.{minor}.{patch} 使用场景示例持续集成/持续部署在CI/CD流程中你可以添加以下步骤自动更新版本poetry dynamic-versioning poetry build poetry publish --no-interaction这将确保每次构建都使用基于最新代码状态的准确版本号。本地开发版本管理在本地开发时运行poetry dynamic-versioning可以快速生成开发版本号帮助你在不同开发阶段跟踪版本差异。 官方文档与资源详细配置选项docs/poetry-dynamic-versioning.1插件源代码poetry_dynamic_versioning/集成测试示例tests/test_integration.py单元测试示例tests/test_unit.py❓ 常见问题解决版本号不更新如果发现版本号没有按预期更新请检查是否创建了Git标签配置文件格式是否正确是否有未提交的更改可以使用poetry dynamic-versioning --verbose命令查看详细日志帮助诊断问题。与其他插件冲突如果遇到与其他Poetry插件的冲突建议在pyproject.toml中调整插件加载顺序或尝试更新所有相关插件到最新版本。通过本指南你应该已经掌握了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），仅供参考