How to create a GUID/UUID in Python

The nitty-gritty: UUID versions and privacy essentials

Python's uuid module creates distinct UUID versions:

• uuid.uuid1() crafts a UUID using your system's MAC address and the current timestamp. While unique, this version could compromise user privacy.
• uuid.uuid4() concocts a UUID employing pure randomness. This is a popular pick due to its privacy guarantees: no hardware or temporal information included!

Notice that for groundbreaking applications, UUID versions 6 and 7 may be more applicable. However, Python's standard module does not yet provide native support. Fortunately, the uuid module's compatibility with both Python 2 and 3 ensures its use is universally consistent.

Converting UUIDs: The string and the hex

Once a UUID is born, you might find the need to change its outfit—convert it to a string or access its hex value:

my_uuid = uuid.uuid4()
print(str(my_uuid))  # Presto change-o! Now it's a string!
print(my_uuid.hex)   # Hexing the UUID. No magic wands required.


Storing UUIDs in a database? Remember to store them in binary form, a savvy strategy for both space and performance optimization. Most modern ORMs, like the SQLAlchemy, offer convenient interfaces for handling UUIDs.

UUIDs in the wild: The web-friendly version

In certain scenarios, your UUID will find itself navigating the labyrinth that is the web, potentially becoming part of URLs. In such cases, dress it up in a URL-safe uniform using base64 encoding:

import base64
import uuid

# Generate UUID
u = uuid.uuid4()

# Transmogrify to URL-safe encoding
url_safe_uuid = base64.urlsafe_b64encode(u.bytes).rstrip(b'=').decode('ascii')
print(url_safe_uuid)  # UUID is ready for its web debut!


This step carefully removes any '+' and '/' characters, ensuring the encoded UUID doesn't wreak havoc on your URLs' semantics.

Which UUID version to pick: A cheatsheet

• uuid.uuid4() for universal purposes and when privacy tops your requirements.
• uuid.uuid1() when you need the creation time or the machine's MAC address as part of the UUID. Watch out for privacy considerations, though!
• Python doesn't usually support versions 6 and 7, but these could be your key to sortable time-based UUIDs heralded by many modern applications and databases.
• For backwards compatibility or certain needs, consider exploring custom implementations or additional libraries supporting these versions.

Problem-solving with UUIDs: Common scenarios and tips

When embedding UUIDs in your system, here are some frequent scenarios and tips:

• Collisions: Theoretically possible with uuid.uuid4(), but the odds are on par with spotting a unicorn in the wild.
• Performance: Creating UUIDs isn't a cakewalk for your system's resources. If you're in need of a torrent of UUIDs in a jiffy, consider caching.
• Validation: Remember to validate UUIDs before tag-teaming them with your processing functions. Call in UUID(str) to ensure they're in the right form.
• Formatting: Some systems might show up to the party dressed in bracketed UUIDs ({UUID}) or don uppercase letters. Be ready to tweak the string representation as required.