hatch-timestamp-version 0.0.2

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.

🚀 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-vcs", "hatch-timestamp-version"]
build-backend = "hatchling.build"

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

[tool.hatch.version.raw-options]
local_scheme = "no-local-version"
version_scheme = "guess-next-dev"

🛠️ 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