uuidcheck

uuidcheck

مكتبة GO الصغيرة ذات الاعتماد الصفر التي تتحقق من صحة UUID ضد تنسيق RFC 4122 القياسي ، وتحول UUIDV7 () إلى الطابع الزمني من خلال ضمان الدقة وحساب الضوء.

لماذا؟ في بعض الأحيان ، تحتاج فقط إلى معرفة ما إذا كانت هذه السلسلة عبارة عن uuid مناسبة دون سحب المكتبات الثقيلة أو كتابة الشيكات العسكرية. uuidcheck يفعل شيئًا واحدًا ويفعله جيدًا.

سمات

• بسيط وضوء: لا تعبيرات منتظمة ، لا تبعيات خارجية وفحص تمرير واحد.
• تنسيق RFC 4122 الصارم: يضمن الطول الصحيح ومواقف الواصلة والأحرف السداسية الصالحة.
• دعم UUIDV7: مقتطفات مُدمجة الطوابع الزمنية من الإصدار 7 UUIDs.
• تم اختباره بالكامل: يشمل اختبارات الوحدة الشاملة ، تغطي مجموعة من حالات الحافة.

ابدء

go get github.com/ashwingopalsamy/uuidcheck

كيف تعمل

يدير IsValidUUID سلسلة سريعة من الشيكات:

• التحقق من الطول: يجب أن يكون بالضبط 36 حرفًا.
• مواقف الواصلة: يجب أن تظهر الواصلة في المواضع 8 و 13 و 18 و 23.
• أرقام Hex: يجب أن تكون جميع الأحرف الأخرى صالحة ( 0-9 ، AF ، af ).

يتحقق IsUUIDv7 من الإصدار من حقل time_hi_and_version ، مما يضمن "7".

يستخلص UUIDv7ToTimestamp أول 48 بت من UUID (مزيج من time_low وجزء من time_mid ) ويفسرها كطالب UNIX بالميلي ثانية.

أمثلة

صالح:

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

غير صالح:

• 01939c-282d-782f-9cc2-887 (قصير جدًا)
• f01939c00-282d-782f-9cg2-887dc7b40629 (Hex Char g )
• 01939c00282d782f9cc2887dc7b40629 (بدون واصلات)

الاختبار

نحن نؤمن بتغطية اختبار صلبة. فقط الجري:

go test -v ./...

ستجد اختبارات الوحدة وسيناريوهات حالة الحافة في uuidcheck_test.go .

المساهمة

المساهمات مرحب بها! لا تتردد في فتح المشكلات أو تقديم PRS أو اقتراح الميزات. ما عليك سوى الاحتفاظ بها بسيطة ومتوافقة مع هدف المكتبة: التحقق من صحة UUID واضحة ومباشرة.

رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.