datestamp

Automated software version generator and replacer based on `year.month.day` as its format.


License
Unlicense
Install
pip install datestamp==2020.2.10

Documentation

DateStamp

Automatically generates new software version stamp as year.month.day format.

Install, update & uninstall (Alpha)

Use pip to install, upgrade & uninstall:

pip install datestamp

pip install --upgrade datestamp

pip uninstall datestamp

Example #1

# ./pyproject.toml
[build-system]
requires = ["datestamp"]

# ./setup.py
from datestamp import stamp

setup(...,
      version=stamp('package_name'),    # '2020.2.9'
      ...)

Example #2

# ./datestamp.py
...

# ./MANIFEST.in
include datestamp.py

# ./setup.py
from datestamp import stamp

setup(...,
      version=stamp('package_name'),    # '2020.2.9'
      ...)

Options

version=stamp('package_name')               # '2020.2.9'
version=stamp('package_name', '.post1')     # '2020.2.9.post1'
version=stamp('package_name', 'rc1')        # '2020.2.9rc1'

Note

  • Make sure to pre-install datestamp before running python3 setup.py sdist. This is only required for publishers, for users it will be build at setup time (but not installed).
  • New date stamp is only generated when you are ready to publish your project by python3 setup.py sdist or current version date is used.
  • When new date is generated at setup(version=stamp(...)) it also replaces __version__ line with __version__ = '2020.2.9' in __init__.py file.
  • Works for One-Off script file as well like datestamp.py package itself.

License

Free, No limit what so ever. Read more