timeslug 1.0.0

Generate a base36 timestamp from an ISO 8601 datetime string

timeslug

A lightweight Python CLI tool that generates base36 timestamps from ISO 8601 datetime strings. Has no dependencies.

Installation

You can install the package via pip:

pip install timeslug

CLI usage

Generate a base36 code from any ISO 8601 datetime string:

timeslug "2026-05-26T15:30:00Z"

If no timezone is specified in the input string, timeslug falls back to UTC.

Options

• -o, --offset: Number of days to increment from the epoch (1970-01-01) before generating the code. Defaults to 0.

The following example increments the epoch by 10,957 days (to 2000-01-01) and generates a code from 2026-05-26 15:30:00 UTC:

timeslug "2026-05-26T15:30:00" -o 10957

Python API

You can import the functions in your Python projects:

from timeslug import generate_code, encode_base36

# Generate a base36 code from an ISO 8601 string
slug = generate_code("2026-05-26T15:30:00Z")
print(slug)

# Encode any integer to base36
encoded = encode_base36(12345)
print(encoded)

License

This project is licensed under the MIT License.