BERKIOSDocs
Modules

Bibliothèque uuid (identifiants uniques) — v1.0.0

12 commandes pour BERKIOS CODE qui reprennent l'esprit du module uuid de Python : génération d'UUID version 4, formes dérivées (hexadécimal, URN, court), UUID nul et maximal, validation, lecture de la version, normalisation et comparaison. Chaque commande existe sous son nom Python/anglais, en français, en espagnol et en swahili ; la forme qualifiée uuid.<nom> fonctionne aussi. Aucune permission n'est demandée. Les commandes sont de simples macros vers des commandes intégrées (identifiant, generer-identifiant, uuid-reproductible, correspond, sous-texte…).

Exemple

quand clic
  uuid4 "$id"                  # 3f2b8c1e-9a4d-4e57-b1c6-0d2f7a9e5b34
  uuid-valide "$id" "$ok"      # true
  uuid-version "$id" "$v"      # 4
  uuid4-hex "$cle"             # 32 caractères hexadécimaux, sans tirets
  uuid-court "$code"           # 8 caractères, ex. 3f2b8c1e
  uuid-egal "$id" "$autre" "$meme"

Choisir la bonne commande

  • Identifiant d'enregistrement, de ligne, de commande : uuid4.
  • Jeton ou clé qui doit rester imprévisible : uuid4-secure (générateur sécurisé de l'hôte).
  • Tests reproductibles : randomy.seed 42 puis uuid4-seeded → mêmes identifiants à chaque exécution. Jamais pour un secret.
  • Code lisible : uuid-court (8 caractères : plus pratique, mais risque de collision bien plus élevé qu'un UUID complet).

Commandes

Noms (python/en · fr · es · sw)SyntaxeEffet
uuid4 · nouvel-uuid · nuevo-uuid · uuid-mpyauuid4 "Résultat"Génère un identifiant unique aléatoire (UUID version 4) comme uuid.uuid4() de Python, par exemple 3f2b8c1e-9a4d-4e57-b1c6-0d2f7a9e5b34.
uuid4-hex · uuid-hexa · uuid-hexadecimal · uuid-heksadesimaliuuid4-hex "Résultat"UUID v4 sans tirets : 32 caractères hexadécimaux (uuid.uuid4().hex).
uuid-urn · urn-uuid · urn-de-uuid · urn-ya-uuiduuid-urn "Résultat"UUID v4 au format URN : urn:uuid:… (uuid.uuid4().urn).
uuid-short · uuid-court · uuid-corto · uuid-fupiuuid-court "Résultat"Identifiant court : les 8 premiers caractères d'un UUID v4. Pratique pour un code lisible, mais moins unique qu'un UUID complet.
uuid4-secure · uuid-securise · uuid-seguro · uuid-salamauuid4-secure "Résultat"UUID v4 issu du générateur sécurisé de l'hôte (generer-identifiant) : à préférer pour un jeton ou une clé qui doit rester imprévisible.
uuid4-seeded · uuid-graine · uuid-semilla · uuid-mbeguuuid4-seeded "Résultat"UUID v4 tiré avec la graine courante (voir randomy.seed) : même graine, mêmes identifiants. Pour des tests reproductibles, jamais pour un secret.
uuid-nil · uuid-nul · uuid-nulo · uuid-tupuuuid-nil "Résultat"L'UUID nul 00000000-0000-0000-0000-000000000000 (« aucun identifiant »).
uuid-max · uuid-maximal · uuid-maximo · uuid-upeouuid-max "Résultat"L'UUID maximal ffffffff-ffff-ffff-ffff-ffffffffffff.
is-uuid · uuid-valide · uuid-valido · uuid-halaliuuid-valide "Source" "Résultat"Écrit true si la source est un UUID de forme 8-4-4-4-12 chiffres hexadécimaux (majuscules ou minuscules), sinon false.
uuid-version · version-uuid · version-del-uuid · toleo-la-uuiduuid-version "Source" "Résultat"Écrit la version de l'UUID (1 à 8 ; 4 pour un UUID aléatoire). Arrête le script si la source n'est pas un UUID valide.
uuid-normalize · uuid-normaliser · uuid-normalizar · uuid-sanifishauuid-normaliser "Cible"Met l'UUID de la cible en minuscules, sans espaces, accolades {…} ni préfixe urn:uuid:.
uuid-equal · uuid-egal · uuid-igual · uuid-sawauuid-egal "A" "B" "Résultat"Écrit true si deux UUID sont identiques, sans tenir compte de la casse, des accolades ni du préfixe urn:uuid:.

Limites

  • Seule la version 4 (aléatoire) est générée. Les versions 1, 3, 5 et 7 de Python ne sont pas fournies : une bibliothèque de macros ne dispose ni de l'adresse MAC, ni de MD5/SHA-1, ni de l'horloge à la précision requise.
  • uuid-valide et uuid-version n'acceptent que la forme canonique 8-4-4-4-12 ; utilisez uuid-normaliser d'abord pour une valeur avec accolades ou préfixe urn:uuid:. Un UUID sans tirets (32 caractères) est refusé.
  • uuid4-seeded (commande intégrée uuid-reproductible) et uuid4-secure suivent la disponibilité de ces commandes intégrées : uuid-reproductible n'est pas encore porté dans le runtime Dart des applications Flutter ; uuid4, uuid4-hex, uuid-urn, uuid-court et les commandes de validation n'en dépendent pas.
  • Dans ce document, le nom uuid seul reste la commande intégrée identifiant : pour la bibliothèque, écrivez uuid4 ou uuid.uuid4.

Vérifié par studio/tests/library-uuid.test.ts (8 tests, exécution réelle des macros).

Cette page en Markdown · llms.txt · documentation complète pour les IA