Metadata-Version: 2.4
Name: hatch-timestamp-version
Version: 0.0.1
Summary: plugin that provides a custom version scheme using UTC timestamps for development versions.
Project-URL: Homepage, https://viseshrp.github.io/hatch-timestamp-version/
Project-URL: Repository, https://github.com/viseshrp/hatch-timestamp-version
Project-URL: Documentation, https://viseshrp.github.io/hatch-timestamp-version/
Author-email: Visesh Prasad <viseshrprasad@gmail.com>
License: MIT
License-File: LICENSE
Keywords: python
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Hatch
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: <4.0,>=3.9
Requires-Dist: hatchling
Description-Content-Type: text/markdown

# hatch-timestamp-version

[![PyPI version](https://img.shields.io/pypi/v/hatch_timestamp_version.svg)](https://pypi.org/project/hatch_timestamp_version/)
[![Python versions](https://img.shields.io/pypi/pyversions/hatch_timestamp_version.svg?logo=python&logoColor=white)](https://pypi.org/project/hatch_timestamp_version/)
[![CI](https://github.com/viseshrp/hatch-timestamp-version/actions/workflows/main.yml/badge.svg)](https://github.com/viseshrp/hatch-timestamp-version/actions/workflows/main.yml)
[![Coverage](https://codecov.io/gh/viseshrp/hatch-timestamp-version/branch/main/graph/badge.svg)](https://codecov.io/gh/viseshrp/hatch-timestamp-version)
[![License: MIT](https://img.shields.io/github/license/viseshrp/hatch-timestamp-version)](https://github.com/viseshrp/hatch-timestamp-version/blob/main/LICENSE)
[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://black.readthedocs.io/en/stable/)
[![Lint: Ruff](https://img.shields.io/badge/lint-ruff-000000.svg)](https://docs.astral.sh/ruff/)
[![Typing: mypy](https://img.shields.io/badge/typing-checked-blue.svg)](https://mypy.readthedocs.io/en/stable/)

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

![Demo](https://raw.githubusercontent.com/viseshrp/hatch-timestamp-version/main/demo.gif)

## 🚀 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

## 🛠️ Features

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

## 📦 Installation

```bash
pip install hatch-timestamp-version
```

## 🧪 Usage

In your ``pyproject.toml``:
```toml
[build-system]
requires = ["hatchling", "hatch-vcs"]
build-backend = "hatchling.build"

[tool.hatch.version]
source = "vcs"
path = "yourpkg/_version.py"
version_scheme = "timestamp-dev"

[tool.hatch.version.raw-options]
local_scheme = "no-local-version"
```

## 📐 Requirements

* Python >= 3.9

## 🧾 Changelog

See [CHANGELOG.md](https://github.com/viseshrp/hatch-timestamp-version/blob/main/CHANGELOG.md)

## 🙏 Credits

* Inspired by [Simon Willison](https://github.com/simonw)'s work.

## 📄 License

MIT © [Visesh Prasad](https://github.com/viseshrp)
