UUID version 7 (Pre-RFC Standard)

Warnings

• breaking This library implements an **outdated draft** of the UUIDv7 specification. It uses nanosecond (or ~50ns) time precision, whereas the final RFC 9562 standard specifies millisecond precision. UUIDs generated by this library are not compatible or correctly sortable with UUIDs from RFC 9562 compliant implementations (e.g., Python 3.14's `uuid.uuid7` or the `uuid-extension` PyPI package). Migrating to a compliant implementation will result in non-monotonic UUIDs if mixed with those from this package.
  Fix: Avoid using this `uuid7` package. Consider `uuid-extension` (on PyPI) for current Python versions, or Python's built-in `uuid.uuid7()` (available in Python 3.14+). If you must use a similar concept, ensure all systems use this exact non-compliant implementation, which is highly discouraged.
• deprecated The `uuid7` package appears to be unmaintained, with its last release (0.1.0) in December 2021. This indicates it will not be updated to conform to the final RFC 9562 specification or receive further bug fixes.
  Fix: Transition to a maintained and RFC 9562 compliant UUIDv7 library, such as `uuid-extension` on PyPI or the built-in `uuid.uuid7()` in Python 3.14+.
• gotcha The documentation on this package's PyPI page is misleading, often showing import examples for a *different* package (`uuid_extensions`). This can lead to confusion and incorrect installations or import paths.
  Fix: Always verify import paths against the actual installed package content. For RFC 9562 compliant UUIDv7, explicitly install and use `uuid-extension` (`pip install uuid-extension`) and import `from uuid_extension import uuid7`.
• gotcha Python 3.14 and later versions will include a built-in `uuid.uuid7()` function that is fully compliant with RFC 9562. Using this `uuid7` (pypi slug) package will conflict with future standard library behavior and lead to non-compliant UUIDs.
  Fix: For Python 3.14+, prefer `import uuid; uuid.uuid7()`. For earlier Python versions, use maintained third-party alternatives like `uuid-extension`.

Install

• pip install uuid7 Install `uuid7` package

Imports

• uuid7

  from uuid7 import uuid7

  While its own PyPI page suggests `from uuid_extensions import uuid7`, this is a different, compliant package. For the `uuid7` package (this entry), the direct import from the package name is expected, though its own documentation is confusing.

Quickstart

Generates a new UUID using the `uuid7` library. Note that UUIDs generated by this library are not compliant with the final RFC 9562 standard.

from uuid7 import uuid7

# Generate a new non-RFC 9562 compliant UUIDv7
my_uuid = uuid7()
print(f"Generated UUID: {my_uuid}")
print(f"UUID as string: {str(my_uuid)}")
print(f"UUID as integer: {my_uuid.int}")