Documentation développeur
Python
Mis à jour le 19 septembre 2026

Générer et manipuler des GUID en Python

Générez, analysez, formatez et validez des valeurs GUID/UUID en Python.

GUID est le terme couramment utilisé dans l’écosystème Microsoft pour un identifiant global unique de 128 bits. Sa forme textuelle canonique est compatible avec le format UUID, même si certaines plateformes proposent des formats GUID supplémentaires.

Démarrage rapide#

L’exemple suivant utilise l’API standard de Python ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

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

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

Python
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")

Points importants#

Validez les identifiants reçus de l’extérieur et utilisez la forme canonique avec tirets pour l’interopérabilité entre plateformes.

Bonnes pratiques#

  1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
  2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
  3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

Implémenter GUID dans d'autres langages :