uuidcheck

uuidcheck

Una pequeña biblioteca GO de dependencia cero que valida UUID contra el formato estándar RFC 4122, convierte UUIDV7 () en marcas de tiempo asegurando precisión y cómputo de luz.

¿Por qué? A veces solo necesita saber si esa cadena es un UUID adecuado sin arrastrar bibliotecas pesadas o escribir cheques torpes. uuidcheck hace una cosa y lo hace bien.

Características

• Simple y ligero: sin expresiones regulares, sin dependencias externas y una verificación de un solo paso.
• Formato estricto RFC 4122: garantiza la longitud correcta, las posiciones de guiones y los caracteres hexagonales válidos.
• Soporte de UUIDV7: extrae marcas de tiempo integradas de la versión 7 UUID.
• Totalmente probado: incluye pruebas unitarias completas, que cubren una gama de casos de borde.

Empezando

go get github.com/ashwingopalsamy/uuidcheck

Cómo funciona

IsValidUUID ejecuta una serie rápida de cheques:

• Verificación de longitud: debe ser exactamente 36 caracteres.
• Posiciones de guión: los guiones deben aparecer en las posiciones 8, 13, 18 y 23.
• Dígitos hexadecimales: todos los demás personajes deben ser válidos ( 0-9 , AF , af ).

IsUUIDv7 verifica la versión mordisco del campo time_hi_and_version , asegurando su '7'.

UUIDv7ToTimestamp extrae los primeros 48 bits del UUID (la combinación de time_low y parte de time_mid ) y los interpreta como una marca de tiempo UNIX en milisegundos.

Ejemplos

Válido:

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

Inválido:

• 01939c-282d-782f-9cc2-887 (demasiado corto)
• f01939c00-282d-782f-9cg2-887dc7b40629 (HEX CHAR g )
• 01939c00282d782f9cc2887dc7b40629 (sin guiones)

Pruebas

Creemos en la cobertura de prueba sólida. Solo corre:

go test -v ./...

Encontrará pruebas unitarias y escenarios de casos de borde en uuidcheck_test.go .

Que contribuye

¡Las contribuciones son bienvenidas! Siéntase libre de abrir problemas, enviar PRS o proponer características. Simplemente mantenlo simple y alineado con el objetivo de la biblioteca: validación de UUID directa, sencilla.

Licencia

Este proyecto tiene licencia bajo la licencia MIT.