fastuuidv7 0.1.6

Python bindings for fast-uuid-v7.

fastuuidv7

Python bindings for the Rust fast-uuid-v7 generator.

This package is intentionally small. It exposes the fast Rust UUIDv7 generator to Python with a module name of fastuuidv7 and keeps the API close to the Rust crate.

Supported platforms

Prebuilt wheels are currently published for:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Windows ARM64 is not part of the current wheel build matrix yet, but source builds remain possible with a local Rust toolchain and Python development environment.

Install locally

cd python
maturin develop

Usage

import fastuuidv7

raw = fastuuidv7.gen_id()
raw_sub_ms_4 = fastuuidv7.gen_id_with_sub_ms_4()
raw_sub_ms_8 = fastuuidv7.gen_id_with_sub_ms_8()
raw_sub_ms_12 = fastuuidv7.gen_id_with_sub_ms_12()
text = fastuuidv7.gen_id_str()
data = fastuuidv7.gen_id_bytes()
uuid_obj = fastuuidv7.uuid7()

same_text = fastuuidv7.format_uuid(raw)
same_text_from_obj = fastuuidv7.format_uuid(uuid_obj)

Convenience aliases:

fastuuidv7.uuid7()      # fastuuidv7.UUID object
fastuuidv7.uuid7_str()  # str
fastuuidv7.uuid7_hex()  # str without dashes
fastuuidv7.uuid7_bytes()

Benchmarks

cd python
python3 bench/bench.py

The benchmark measures repeated single calls, so the numbers include Python/native boundary overhead.

Current results on macOS arm64 with Python 3.14.4:

Package	Callable	Time per call
uuid6	uuid6.uuid7	1999.5 ns
uuid-v7	uuid_v7.base.uuid7	2582.4 ns
uuid7	uuid_extensions.uuid7	1969.2 ns
uuid	uuid.uuid7	1579.9 ns
fastuuid7	uuidv7.uuid7	298.6 ns
uuid-utils	uuid_utils.uuid7	96.8 ns
c-uuid-v7	c_uuid_v7.uuid7	59.4 ns
fastuuidv7	fastuuidv7.uuid7_str	24.5 ns

The linux x86 GH runner shows similar times for fastuuidv7 as for c-uuid-v7.

Notes:

• These are single-call throughput measurements, so they include Python/native boundary overhead.
• Install comparison packages such as uuid-utils before running; missing packages are skipped.

Notes

• Python 3.14 includes uuid.uuid7() in the standard library.
• The main use case here is speed experiments and using a fast Rust-backed generator on older Python versions.