hatch-timestamp-version 0.0.6

plugin that provides a custom version scheme using UTC timestamps for development versions.

hatch-timestamp-version

A hatch plugin that provides a custom version scheme using UTC timestamps for development versions. It is based on top of hatch-vcs.

🚀 Why this project exists

I have CI continuously deploy to 'Test PyPI' and I want packages to have the datetime as dev versions.

Eg: reelname-1.0.1.dev20250503202530-py3-none-any.whl

📐 Requirements

• Python >= 3.9

📦 Installation

pip install hatch-timestamp-version

🧪 Usage

In your pyproject.toml:

[build-system]
requires = ["hatchling", "hatch-timestamp-version>=0.0.5"]
build-backend = "hatchling.build"

[tool.hatch.version]
path = "yourpkg/_version.py"
source = "timestamp-dev"
scheme = "timestamp-dev"
validate-bump = true

[tool.hatch.version.raw-options]
local_scheme = "no-local-version"
timestamp_format = "short"  # or "long" for full datetime or any strftime string like "%Y%m%d%H%M"

🛠️ Features

• Uses datetime for the dev versions, when used with hatch-vcs

$ hatch version
# => reelname-1.0.3.dev20250524011230

🧾 Changelog

See CHANGELOG.md

🙏 Credits

• Inspired by Simon Willison's work.

📄 License

MIT © Visesh Prasad