uuidcheck

uuidcheck

Uma pequena biblioteca GO de dependência zero dependente que valida os UUIDs contra a formatação padrão RFC 4122, converte uuidv7 () em registro de data e hora, garantindo a precisão e a computação da luz.

Por que? Às vezes, você só precisa saber se essa string é um UUID adequado sem arrastar bibliotecas pesadas ou escrever cheques desajeitados. uuidcheck faz uma coisa e faz bem.

Características

• Simples e leve: sem expressões regulares, sem dependências externas e uma verificação de passagem única.
• Formato RFC 4122 rígido: garante o comprimento correto, as posições do hífen e os caracteres hexáticos válidos.
• Suporte UUIDV7: Extratos de registro de data e hora incorporados da versão 7 UUIDs.
• Totalmente testado: inclui testes de unidade abrangentes, cobrindo uma variedade de casos de borda.

Começando

go get github.com/ashwingopalsamy/uuidcheck

Como funciona

IsValidUUID executa uma rápida série de cheques:

• Verificação de comprimento: Deve ser exatamente 36 caracteres.
• Posições do hífen: Os hífens devem aparecer nas posições 8, 13, 18 e 23.
• Dígitos Hex: Todos os outros personagens devem ser válidos Hex ( 0-9 , AF , af ).

IsUUIDv7 verifica a versão da versão do campo time_hi_and_version , garantindo seu '7'.

UUIDv7ToTimestamp extrai os primeiros 48 bits do UUID (a combinação de time_low e parte do time_mid ) e os interpreta como um registro de data e hora UNIX em milissegundos.

Exemplos

Válido:

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

Inválido:

• 01939c-282d-782f-9cc2-887 (muito curto)
• f01939c00-282d-782f-9cg2-887dc7b40629 (HEX INVALID CHAR g )
• 01939c00282d782f9cc2887dc7b40629 (sem hífens)

Teste

Acreditamos na cobertura de teste sólido. Apenas corra:

go test -v ./...

Você encontrará testes de unidade e cenários de casos de borda em uuidcheck_test.go .

Contribuindo

As contribuições são bem -vindas! Sinta -se à vontade para abrir problemas, enviar PRs ou propor recursos. Apenas mantenha-o simples e alinhado com o objetivo da biblioteca: validação UUID direta e rápida e simples.

Licença

Este projeto está licenciado sob a licença do MIT.