uuidcheck

uuidcheck

Une minuscule bibliothèque GO à dépendance zéro qui valide les UUIdes par rapport à la mise en forme RFC 4122 standard, convertit UUIDV7 () en horodatage en assurant une précision et une calcul légère.

Pourquoi? Parfois, il vous suffit de savoir si cette chaîne est un UUID approprié sans faire glisser dans des bibliothèques lourdes ou écrire des vérifications maladroites. uuidcheck fait une chose et le fait bien.

Caractéristiques

• Simple et léger: pas d'expressions régulières, pas de dépendances externes et une vérification unique.
• Format strict RFC 4122: assure une longueur correcte, des positions de trait d'union et des caractères hexadécimaux valides.
• Prise en charge UUIDV7: extrait les horodatages intégrés des Uuids de la version 7.
• Entièrement testé: comprend des tests unitaires complets, couvrant une gamme de cas de bord.

Commencer

go get github.com/ashwingopalsamy/uuidcheck

Comment ça marche

IsValidUUID exécute une série rapide de chèques:

• Vérification de la longueur: doit comporter exactement 36 caractères.
• Positions des traits d'union: Les traits de main doivent apparaître aux positions 8, 13, 18 et 23.
• Digits hexadécimaux: tous les autres personnages doivent être HEX valides ( 0-9 , AF , af ).

IsUUIDv7 vérifie la version à grignoter du champ time_hi_and_version , garantissant son «7».

UUIDv7ToTimestamp extrait les 48 premiers bits de l'UUID (la combinaison de time_low et une partie de time_mid ) et les interprète sous forme d'horodatage Unix en millisecondes.

Exemples

Valide:

• 01939c00-282d-782f-9cc2-887dc7b40629
• 01939C00-282D-782F-9CC2-887DC7B40629

Invalide:

• 01939c-282d-782f-9cc2-887 (trop court)
• f01939c00-282d-782f-9cg2-887dc7b40629 (INVALID HEX CHAR g )
• 01939c00282d782f9cc2887dc7b40629 (pas de traits

Essai

Nous croyons en une couverture de test solide. Il suffit de courir:

go test -v ./...

Vous trouverez des tests unitaires et des scénarios de cas de bord dans uuidcheck_test.go .

Contributif

Les contributions sont les bienvenues! N'hésitez pas à ouvrir des problèmes, à soumettre des PRS ou à proposer des fonctionnalités. Gardez simplement les choses simples et alignées sur l'objectif de la bibliothèque: la validation UUID à cas de flambée et rapide.

Licence

Ce projet est autorisé sous la licence du MIT.