short-unique-id 🐍⚡️

Tiny, dependency-free Snowflake-style ordered IDs and ultra-short unique IDs for Python 3.9+

Need a sortable primary-key like Twitter’s Snowflake, or just a compact URL-safe slug? short-unique-id gives you both—without C extensions or heavy dependencies.

✨ Features

• Ordered Snowflake IDs – 64-bit, monotonic & k-sortable (100 μs precision at default mult)
• Short base-64 string IDs – compact, URL-safe tokens for URLs, files, IoT messages, …
• Sortable or shuffled – ordered alphabet for lexicographic sort, or shuffled alphabet for opaque tokens
• Stateless & thread-safe – no Redis, no database round-trips
• Zero dependencies – pure-Python, install in seconds
• Python 3.9 → 3.14 – fully typed, passes pytest & Ruff
• MIT licensed

🚀 Install

pip install short-unique-id

Or grab the latest dev build:

pip install git+https://github.com/Purushot14/short-unique-id.git

⚡ Quick-start

import short_unique_id as suid

# URL-safe, lexicographically sortable string (default is_ordered=True)
slug = suid.generate_short_id()
print(slug)             # → "1vAo4-1g-1---"

# Opaque token using shuffled alphabet
token = suid.generate_short_id(is_ordered=False)
print(token)            # → "qZ8Ft1jK2L3R"

# Ordered, 64-bit Snowflake integer
snowflake = suid.get_next_snowflake_id()
print(snowflake)        # → 489683493715968001

Need higher precision or longer range? Pass a custom mult (ticks per second):

slug      = suid.generate_short_id(mult=1_000_000)
snowflake = suid.get_next_snowflake_id(mult=1_000_000)

🔬 Micro-benchmark^†

^{† MacBook M3, Python 3.13, single thread, timeit.repeat 5 × 1000.}

🛠️ API Reference

📚 When to use it

• Primary keys in distributed databases (fits in BIGINT)
• Short share links or invite codes
• File/folder names on S3 / GCS (lexicographic sort ≈ creation time)
• Message IDs in event streams & IoT payloads
• Anywhere you’d reach for UUIDs but want shorter or ordered IDs

🤝 Contributing

1. git clone https://github.com/Purushot14/short-unique-id && cd short-unique-id
2. poetry install – sets up venv & dev tools
3. poetry run pytest – all green? start hacking!
4. Run ruff check . --fix && ruff format . before PRs
5. Open a PR – stars and issues welcome ⭐

🛡️ Pre-commit (via Poetry)

Make sure you’ve added pre-commit as a dev dependency:

poetry add --dev pre-commit

Set up the Git hook and run it against all files:

poetry run pre-commit install
poetry run pre-commit run --all-files

📝 Changelog

Notable releases:

🪪 License

Distributed under the MIT License © 2018–2025 Purushot14. See LICENSE.

Made with ❤️ for hackers who hate 36‑byte IDs.