uuid7-standard

What it is and what it does

uuid7-standard generates UUIDv7 identifiers that embed creation timestamps and can extract those timestamps back out, following the final RFC 9562 specification. It wraps Python's standard datetime and UUID facilities rather than exposing raw millisecond values or strings, making it natural to use in Pythonic code. The main use case is creating sortable, time-ordered identifiers suitable for database primary keys or distributed systems where you want both uniqueness and temporal ordering.

The package explicitly avoids the older abandoned `uuid7` package on PyPI, which implemented a draft RFC with incorrect timestamps. Since Python's standard library has no UUIDv7 support yet, this fills that gap for developers who need RFC 9562-compliant UUIDs with timestamp extraction. It has no runtime dependencies beyond the standard library.

Use it for:

• Generate sortable primary keys for database records that also encode creation time.
• Create time-ordered identifiers in distributed systems where you need both uniqueness and temporal ordering.
• Extract the creation timestamp from an existing UUIDv7 to audit or filter records by when they were created.
• Migrate from millisecond-based or string-based timestamp schemes to standard-compliant UUIDs.
• Build event logs or audit trails where the UUID itself carries the event timestamp.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Generates and parses UUIDv7 identifiers with embedded creation timestamps, following the final RFC 9562 specification and providing Python datetime integration.

Yes, if you need RFC 9562-compliant UUIDv7 generation with Python datetime integration and no external dependencies. The package is new (first release 2025-07-03) and marked aging, so verify that maintenance will continue before adopting it in production systems. It explicitly solves the problem of the older, broken `uuid7` package on PyPI, so check that you're not accidentally installing the wrong one.

Install

uuid7-standard on PyPI

pip install uuid7-standard

uv add uuid7-standard

poetry add uuid7-standard

Installing uuid7-standard

Before you install

Low friction: pure Python wheel with no runtime dependencies. Maintenance status is aging—last commit was 2025-07-04 and the package is only days old, so long-term support trajectory is unclear.

License in practice

Permissive license (MIT and Public Domain) means you can use this in commercial and proprietary projects with minimal restrictions.

Quickstart

pip install uuid7-standard

import uuid7
from datetime import datetime, UTC

# Create UUIDv7 with current timestamp
u = uuid7.create()

# Extract timestamp from UUID
timestamp = uuid7.time(u)

Requires Python 3.8 or later. Conflicts with the older abandoned `uuid7` package on PyPI—uninstall it first if present.

Verify before relying

• Whether the package will receive active maintenance beyond its initial release window.
• Real-world performance characteristics when generating large volumes of UUIDs.
• Compatibility with existing UUID libraries or ORMs that may have their own UUIDv7 implementations.

Package facts

Evidence: uuid7_standard-1.1.0-py3-none-any.whl

Keywords: database, ordering, primary-key, timestamp, uuid, uuid7

Tags

More Python Modules packages