poetry-dynamic-versioning
Plugin for Poetry to enable dynamic versioning based on VCS tags
Decision gist · record as of 2026-08-14
Yes. This is a stable, actively maintained plugin with no known vulnerabilities, low install friction, and a clear use case for projects that want version control to be the single source of truth for versioning. Install it if you use Poetry 1.2.0+ and want to eliminate manual version management in your build workflow.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Poetry 1.2.0+ and a supported VCS (Git, Mercurial, Darcs, Bazaar, Subversion, Fossil, or Pijul) with at least one version tag present.
- Low friction install via Poetry's plugin system.
- Actively maintained with recent commits and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2026-02-15 (180 days) · last repo commit 2026-02-15 · 667 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,990,242 downloads/mo, #2,407 on PyPI
Alternatives
Verify before relying
# Install with plugin support
poetry self add "poetry-dynamic-versioning[plugin]"
# Enable in your project
poetry dynamic-versioning enable
# Or manually add to pyproject.toml:
# [tool.poetry-dynamic-versioning]
# enable = true
# Then tag your repo and build
git tag v1.0.0
poetry build- Whether the plugin works seamlessly with all Poetry 2.0+ workflows beyond the documented install path.
- Performance impact on large projects or repositories with many tags.
- Compatibility with monorepo setups or projects with multiple pyproject.toml files.
What it is and what it does
poetry-dynamic-versioning is a Poetry plugin that automatically derives your project's version from version control tags at build time. Instead of manually maintaining a version string in pyproject.toml, you tag your repository (e.g., `git tag v1.0.0`), and the plugin reads that tag, injects the version into your build artifacts, then cleans up so your working directory stays unchanged. It uses Dunamai under the hood to parse tags from Git, Mercurial, and several other VCS systems, and supports custom tag patterns and version formatting via regular expressions or Jinja templates.
The plugin integrates with Poetry's build system at two levels: as a PEP 517 build backend for compatibility with other build frontends, and as a Poetry CLI command for direct integration with `poetry build` and related commands. Configuration is minimal—enable it in pyproject.toml, set your VCS and tag pattern if needed, and the plugin handles the rest. It's designed for projects that want version numbers to stay in sync with their release tags without manual edits or commits.
Use it for
- Automatically version Python packages from Git tags in CI/CD pipelines without editing pyproject.toml.
- Maintain a clean repository by keeping version strings as placeholders and deriving real versions at build time.
- Support multiple VCS systems (Git, Mercurial, etc.) with a single configuration.
- Inject custom version metadata (commit hash, dirty flag, branch name) into build artifacts using Jinja templates.
- Ensure build artifacts always reflect the exact VCS state they were built from, improving reproducibility.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is a stable, actively maintained plugin with no known vulnerabilities, low install friction, and a clear use case for projects that want version control to be the single source of truth for versioning. Install it if you use Poetry 1.2.0+ and want to eliminate manual version management in your build workflow.
Install
poetry-dynamic-versioning on PyPI
Before you install
Low friction install via Poetry's plugin system. Actively maintained with recent commits and no known vulnerabilities. Requires Poetry 1.2.0+ and Python 3.7+.
Requires Poetry 1.2.0+ and a supported VCS (Git, Mercurial, Darcs, Bazaar, Subversion, Fossil, or Pijul) with at least one version tag present.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
# Install with plugin support
poetry self add "poetry-dynamic-versioning[plugin]"
# Enable in your project
poetry dynamic-versioning enable
# Or manually add to pyproject.toml:
# [tool.poetry-dynamic-versioning]
# enable = true
# Then tag your repo and build
git tag v1.0.0
poetry buildVerify before relying
- Whether the plugin works seamlessly with all Poetry 2.0+ workflows beyond the documented install path.
- Performance impact on large projects or repositories with many tags.
- Compatibility with monorepo setups or projects with multiple pyproject.toml files.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesdunamaitomlkitjinja2 |
| Maintenance | Actively maintained 180 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,990,242 / month, #2,407 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: PluginsIntended Audience :: End Users/DesktopLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Version ControlTopic :: Software Development :: Version Control :: BazaarTopic :: Software Development :: Version Control :: GitTopic :: Software Development :: Version Control :: Mercurial |
Evidence: poetry_dynamic_versioning-1.10.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “poetry dynamic versioning plugin”
- poetry-dynamic-versioningA Poetry plugin that automatically derives and injects version…
- uv-dynamic-versioningA Hatch plugin that automatically derives package versions from VCS…
- poetry-dotenv-pluginA Poetry plugin that automatically loads environment variables from…
Give your agent the search over MCP, or paste the wish link into any chat.
More Version Control packages
Automatically extracts and manages Python package versions from git or Mercurial metadata instead of hardcoding them, and includes SCM-tracked files in source distributions.
Dulwich provides pure Python access to Git repositories—both local and remote—without requiring Git or native code to be installed, offering an alternative to calling Git directly.
setuptools-rust is a setuptools plugin that compiles and packages Python extensions written in Rust, using PyO3 or rust-cpython bindings.
pygit2 provides Python bindings to libgit2, enabling direct programmatic access to Git repository operations at the plumbing level without shelling out to the git command-line tool.
Parses and applies patch files in multiple diff formats (unified, context, normal, ed, rcs) and from several source control systems (Git, SVN, CVS).
Automatically determines your Python package's version from Git or Mercurial tags and writes it to your build system, with customizable version formatting and optional runtime file generation.
See also dunamai · uv-dynamic-versioning · poetry-multiproject-plugin · poetry-plugin-shell · poetry · poetry-core · versioneer-518 · poethepoet · poetry-plugin-export