c_uuid_v7 0.0.9

Fast UUID v7 generator implemented as a CPython C extension

c_uuid_v7

Fast UUID v7 generator implemented as a CPython C extension

🐍 PyPI	🐙 GitHub

Features

• The fastest UUID v7 generator in Python (see benchmarks)

Installation

Using pip

pip install c_uuid_v7

Using uv

uv pip install c_uuid_v7

Example

import c_uuid_v7

print(c_uuid_v7.uuid7())  # 019d1ab2-cfea-71f3-ab07-0bf844ff9149
print(c_uuid_v7.compat.uuid7())  # 019d1ab2-cfea-71f3-ab07-0bf98a94016c

Compatibility with Python uuid.UUID

In some cases, for example if you are using Django, you might need uuid.UUID instances to be returned from the standard-library uuid, not a custom UUID class.

In that case you can use the c_uuid_v7.compat which comes with a performance penalty in comparison with the c_uuid_v7 default behaviour, but is still faster than the standard-library.

import c_uuid_v7.compat as uuid

# make a random UUID
print(repr(uuid.uuid7()))
# UUID('019d1ab3-f95a-79df-b868-56fe41c33af3')

Supported wheels

OS	Archs	manylinux	musllinux	CPython	PyPy
Linux	x86_64, i686, aarch64, ppc64le, s390x	manylinux_2_28	musllinux_1_2	3.10 – 3.14	3.11
Linux	armv7l	manylinux_2_31	musllinux_1_2	3.10 – 3.14	3.11
Linux	riscv64	manylinux_2_39	musllinux_1_2	3.10 – 3.14	3.11
Windows	AMD64, x86, ARM64	—	—	3.10 – 3.14	3.11
macOS	x86_64, arm64, universal2	—	—	3.10 – 3.14	3.11