Generate and Work with GUIDs in Python

A GUID is Microsoft terminology for a 128-bit globally unique identifier. In practice, the canonical textual form is compatible with UUID formatting, although platform APIs may expose additional GUID-specific formats.

Quick Start#

The following example uses the standard Python API or a widely used package for this task.

Quick start#

1import uuid23id_value = uuid.uuid4()4print(id_value)

Common Operations#

This second pattern covers a common production operation or a safer way to handle real input.

Parsing input#

1import uuid23def parse_guid(value: str) -> uuid.UUID | None:4    try:5        return uuid.UUID(value)6    except (ValueError, AttributeError, TypeError):7        return None89parsed = parse_guid("d2719d7e-4050-4b1c-a7e0-4dbd1b7c8705")

Important Notes#

Python calls the type UUID; its canonical string form interoperates cleanly with GUID values used by .NET systems.

Best Practices#

1. Treat external input as untrusted and handle parse/validation errors explicitly.
2. Keep encoding, units, formats, and library-specific mapping rules explicit at system boundaries.
3. Add test vectors that cover empty input, Unicode text, malformed input, and representative production data.

References#

• RFC 9562: UUIDs
• Python Documentation