UUID (PyPI Backport for Python 2.x)

Warnings

• breaking This PyPI package (version 1.30) is a backport specifically for Python versions 2.3-2.5. For Python 2.6 and newer, the `uuid` module is included in the Python standard library. Installing this PyPI package on Python 2.6+ or Python 3.x is unnecessary and can lead to confusion or potential conflicts, as the standard library version should be used instead.
  Fix: For Python 2.6+, simply `import uuid` without `pip install uuid`. If you must support older Python 2.x versions (2.3-2.5), then `pip install uuid` is appropriate.
• gotcha The `uuid.uuid1()` function generates a UUID using the computer's network address (MAC address) and the current time. This can compromise privacy if the generated UUIDs are exposed, as they could potentially be traced back to the originating machine.
  Fix: If privacy is a concern, prefer `uuid.uuid4()` for generating random UUIDs or `uuid.uuid7()` (available in Python 3.14+) for time-ordered UUIDs without MAC address exposure.
• gotcha Storing UUIDs as plain strings in databases is inefficient. It consumes more space and can degrade query performance compared to using native UUID data types (e.g., in PostgreSQL) or storing them as 16-byte binary data.
  Fix: Use your database's native UUID type if available (e.g., `UUID` in PostgreSQL). If not, store UUIDs as 16-byte binary fields (e.g., `VARBINARY(16)` or `BINARY(16)`) and convert using `my_uuid.bytes` in Python.
• gotcha This specific PyPI `uuid` package (v1.30) and older standard library versions only support UUID versions 1, 3, 4, and 5. Newer, potentially more optimized or privacy-friendly versions like UUIDv6, UUIDv7, and UUIDv8 were added to the standard library starting with Python 3.14.
  Fix: If you require newer UUID versions (6, 7, or 8), you must use Python 3.14 or a newer version of the standard library. Otherwise, adhere to versions 1, 3, 4, or 5. Consider `uuid4()` for general randomness.
• gotcha While UUIDs are designed to be highly unique (e.g., collision probability for UUIDv4 is extremely low), they are not absolutely guaranteed to be unique. In extremely high-volume, distributed systems, theoretical collision possibilities exist.
  Fix: For mission-critical applications where absolute uniqueness is paramount, consider implementing additional collision detection logic or relying on database-side UUID generation functions where the database ensures uniqueness with constraints.
• gotcha The hardware address retrieved by `uuid.getnode()` (used internally by `uuid.uuid1()`) is tied to the system's network interfaces and can change if network configurations are altered (e.g., switching Wi-Fi, using USB Ethernet adapters).
  Fix: Avoid relying on `uuid1()` for persistent identifiers that must remain constant across hardware or network changes. Use `uuid4()` or name-based UUIDs (`uuid3()`, `uuid5()`) instead, or store and reuse a generated UUID.

Install

• pip install uuid Install PyPI package (for Python 2.3-2.5)

Imports

• uuid

  import uuid

  Imports the module. Functions like uuid.uuid4() are then accessible.
• UUID

  from uuid import UUID
  my_uuid_obj = UUID('a1b2c3d4-e5f6-7890-1234-567890abcdef')

  The UUID class constructor expects a single string, bytes, a fields tuple, or an integer. Passing a list or other incorrect types will often lead to an AttributeError (e.g., trying to call .replace() on a list) rather than a direct TypeError.

Quickstart

Demonstrates generating version 1 and version 4 UUIDs, and reconstructing a UUID object from its string representation using the PyPI `uuid` package, which mirrors the standard library's API for older Python versions.

import uuid

# Generate a random UUID (version 4)
new_uuid = uuid.uuid4()
print(f"Generated UUID (version 4): {new_uuid}")
print(f"UUID as hex string: {new_uuid.hex}")

# Generate a time-based UUID (version 1)
# Note: uuid1() may expose the computer's MAC address.
time_uuid = uuid.uuid1()
print(f"Generated UUID (version 1): {time_uuid}")

# Reconstruct a UUID from a string
from uuid import UUID
recovered_uuid = UUID(str(new_uuid))
print(f"Recovered UUID: {recovered_uuid}")
print(f"Are they equal? {new_uuid == recovered_uuid}")