uuidcheck

uuidcheck

Perpustakaan GO kecil, nol ketergantungan yang memvalidasi UUID terhadap format RFC 4122 standar, mengubah uuidv7 () menjadi cap waktu dengan memastikan akurasi dan komputasi cahaya.

Mengapa? Terkadang Anda hanya perlu tahu apakah string itu adalah UUID yang tepat tanpa menyeret perpustakaan berat atau menulis cek kikuk. uuidcheck melakukan satu hal dan melakukannya dengan baik.

Fitur

• Sederhana & Cahaya: Tidak ada ekspresi reguler, tidak ada dependensi eksternal dan pemeriksaan tunggal.
• Format RFC 4122 yang ketat: Memastikan panjang yang benar, posisi tanda hubung dan karakter hex yang valid.
• Dukungan UUIDV7: Ekstrak cap waktu tertanam dari versi 7 UUIDS.
• Diuji sepenuhnya: Termasuk uji unit komprehensif, mencakup berbagai casing tepi.

Memulai

go get github.com/ashwingopalsamy/uuidcheck

Cara kerjanya

IsValidUUID menjalankan serangkaian cek cepat:

• Pemeriksaan Panjang: Harus persis 36 karakter.
• Posisi Hyphen: Hyphens harus muncul pada posisi 8, 13, 18, dan 23.
• Digit Hex: Semua karakter lain harus valid hex ( 0-9 , AF , af ).

IsUUIDv7 Memeriksa Versi Nibble of the time_hi_and_version , memastikan '7'.

UUIDv7ToTimestamp mengekstrak 48 bit pertama dari UUID (kombinasi time_low dan bagian dari time_mid ) dan menafsirkannya sebagai cap waktu UNIX dalam milidetik.

Contoh

Sah:

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

Tidak sah:

• 01939c-282d-782f-9cc2-887 (terlalu pendek)
• f01939c00-282d-782f-9cg2-887dc7b40629 (tidak valid char g )
• 01939c00282d782f9cc2887dc7b40629 (tidak ada tanda hubung)

Pengujian

Kami percaya pada cakupan tes yang solid. Jalankan saja:

go test -v ./...

Anda akan menemukan tes unit dan skenario edge case di uuidcheck_test.go .

Berkontribusi

Kontribusi dipersilakan! Jangan ragu untuk membuka masalah, mengirimkan PR, atau mengusulkan fitur. Tetap saja sederhana dan selaras dengan tujuan perpustakaan: validasi UUID yang cepat dan menyala-nyala.

Lisensi

Proyek ini dilisensikan di bawah lisensi MIT.