Skip to content

Small utility to define version string for Poetry-style Python project

License

Notifications You must be signed in to change notification settings

shadeofblue/single-version

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

single-version

https://madewithlove.now.sh/vn?heart=true&colorA=%23ffcd00&colorB=%23da251d

https://badgen.net/pypi/v/single-version

Utility to let you have a single source of version in your code base.

This utility targets modern Python projects which have layout generated by Poetry, with a pyproject.toml file in place of setup.py. With this layout, the project initially has two places to maintain version string: one in pyproject.toml file and one in some *.py file (normally __init__.py):

# pyproject.toml
[tool.poetry]
name = "your-package"
version = "0.1.0"
# your_package/__init__.py
__version__ = "0.1.0"

This duplicity often leads to inconsistency when you, the author, forget to update both.

single-version is born to solve that headache circumstance. By convention, it chooses the pyproject.toml file as original source of version string. Your project's __version__ variable then is computed from it. When your package is already deployed and installed to some system, the version string will be retrieved from that Python environment (the pyproject.toml is not included in distribution file).

Years ago, to retrieve version for an installed package, ones often used pkg_resources, which has well-known issue of causing slow import. Learning from that mistake, single-version use importlib.metadata, which becomes standard from Python 3.8, instead.

Usage

Add single_version as your project dependency:

poetry add single-version

Assume that your package source tree is like this:

.
├── awesome_name
│  └── __init__.py
├── pyproject.toml
├── README.rst
└── tests/

where the __version__ variable is defined in awesome_name/__init__.py file. The file content can be like this:

from pathlib import Path

from single_version import get_version


__version__ = get_version('awesome_name', Path(__file__).parent.parent)

API Reference

def get_version (package_name: str, looked_path: Path) -> str

  • package_name: Your package's name (same as in pyproject.toml file).
  • looked_path (of pathlib.Path type): Folder where your project's pyproject.toml resides.

About

Small utility to define version string for Poetry-style Python project

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%