uuid7

library0.1.0pypypi✓ verified 23d ago

This library implements UUID version 7 based on an *earlier draft* of the specification, offering time-sorted UUIDs with approximately 50ns resolution. Released at version 0.1.0 in late 2021, it appears to be unmaintained. Crucially, it **does NOT conform to the final RFC 9562 standard for UUIDv7**, which specifies millisecond precision, leading to significant compatibility issues with compliant implementations.

serialization

pip install uuid7

github ↗package ↗

INSTALL

IMPORT

SIG · UUID7

uuid7

serializationpythonv0.1.0

Install

1.5s avg

Import

22ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.024s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.5s · import 0.020s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

uuid7

✓ from uuid_extensions import uuid7

✗ from uuid7 import uuid7

uuid7str

✓ from uuid_extensions import uuid7str

uuid_to_datetime

✓ from uuid_extensions import uuid_to_datetime

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}")

Debug

Known issues

breakingThis 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.

affects: 0.1.0 (all versions)

deprecatedThe `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+.

affects: 0.1.0 (all versions)

gotchaThe 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`.

affects: 0.1.0 (all versions)

gotchaPython 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`.

affects: 0.1.0 (all versions) when used with Python 3.14+

Upgrade

Version history

0.1.0latest on PyPI · released Dec 29, 2021

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/stevesimmons/uuid7 ↗

packagehttps://pypi.org/project/uuid7/ ↗