fastuuid

The fastuuid module provides high-performance UUID generation for Python, including support for various RFC 4122 versions (v1, v3, v4, v5, v7) and bulk generation methods.

Available Generation Functions:

• uuid4(): Generates a random UUID (v4).
• uuid7(): Generates a time-ordered UUID (v7).
• uuid1(node=..., clock_seq=...): Generates a v1 UUID. You can optionally provide a 48-bit node ID or a 16-bit clock_seq.
• uuid_v1mc(): A fast path for v1 UUIDs using a randomly generated multicast MAC address (similar to PostgreSQL's uuid-ossp).
• uuid3(namespace, name): Generates a v3 UUID using MD5 hashing.
• uuid5(namespace, name): Generates a v5 UUID using SHA-1 hashing.

Bulk Generation (High Performance):

For scenarios requiring many UUIDs at once, use the bulk functions to minimize Python overhead:

• uuid4_bulk(n): Returns a list of n UUID objects.
• uuid4_as_strings_bulk(n): Returns a list of n UUID strings.
• uuid7_bulk(n): Returns a list of n UUID objects.
• uuid7_as_strings_bulk(n): Returns a list of n UUID strings.

import fastuuid

# Single UUIDs
u1 = fastuuid.uuid4()
u7 = fastuuid.uuid7()

# Bulk UUIDs
uids = fastuuid.uuid4_bulk(1000)
strings = fastuuid.uuid4_as_strings_bulk(1000)

The UUID class represents a generated UUID and provides several ways to inspect or convert its data.

Creating a UUID from existing data

You can instantiate a UUID object using the UUID(..., ...) constructor with one of the following arguments (only one is required):

• hex: A hexadecimal UUID string.
• bytes: 16 bytes of data.
• bytes_le: 16 bytes of data in little-endian format.
• fields: A 6-tuple of (time_low, time_mid, time_hi_version, clock_seq_hi_variant, clock_seq_low, node).
• int: A 128-bit integer.
• version: (Optional) An integer specifying the version (1, 2, 3, 4, or 5).

Accessing UUID properties

• .int: Returns the 128-bit integer representation.
• .bytes: Returns the 16 bytes in big-endian order.
• .bytes_le: Returns the 16 bytes in little-endian order.
• .hex: Returns the lowercase hexadecimal string.
• .urn: Returns the UUID in URN format.
• .version: Returns the version number (e.g., 4) if it is an RFC 4122/9562 UUID.
• .variant: Returns a string describing the variant (e.g., 'specified in RFC 4122').
• .fields: Returns a 6-tuple of the UUID components.
• .time: Returns the timestamp associated with the UUID.
• .node: Returns the 48-bit node ID.

import fastuuid

# Create from hex
uid = fastuuid.UUID(hex='550e8400-e29b-41d4-a716-446655440000')

# Access properties
print(uid.hex)      # '550e8400-e29b-41d4-a716-446655440000'
print(uid.int)      # 113036677011111111111111111111111111111
print(uid.version)  # 4

The following properties and methods are available on the fastuuid.UUID class: