ما هو Validated ولماذا هو مطلوب؟
Validated هي مكتبة خفيفة الوزن للـ Swift، مصممة للتحقق من صحة البيانات بشكل تصريحي. بدلاً من كتابة سلاسل if-else الطويلة أو استخدام NSPredicate، يمكنك وصف قواعد التحقق على شكل سلسلة من الدوال. هذا مفيد بشكل خاص عند معالجة النماذج، واستجابات API، وإدخال المستخدم في تطبيقات iOS/macOS.
كيفية تثبيت Validated؟
يتم توزيع المكتبة عبر Swift Package Manager. أضف التبعية في Package.swift:
dependencies: [ .package(url: "https://github.com/your-repo/Validated.git", from: "1.0.0")]أو عبر Xcode: File → Add Packages → الصق رابط المستودع.
الوظائف الأساسية
- التحقق من صحة النصوص — التحقق من البريد الإلكتروني، الطول، التعبيرات المنتظمة.
- التحقق من صحة الأرقام — النطاق، القيمة الدنيا/القصوى.
- الفحوصات المركبة — دمج عدة قواعد عبر AND/OR.
- الأخطاء المترجمة — ترجمة تلقائية للرسائل إلى لغة الجهاز.
- التحقق غير المتزامن — للفحوصات التي تتطلب طلبات شبكة.
مثال على كود Swift (iOS)
import Validated
struct RegistrationForm { @Validated(.email, .nonEmpty) var email: String @Validated(.range(6...20), .alphanumeric) var password: String func validate() -> Bool { return $email.isValid && $password.isValid }}
// الاستخدامvar form = RegistrationForm()form.email = "user@example.com"form.password = "Pass123"
if form.validate() { print("النموذج صحيح")} else { print("خطأ: \\(form.$email.errors.first ?? "")")}متى تستخدم Validated؟
المكتبة مثالية لـ:
- نماذج التسجيل وتسجيل الدخول
- التحقق من صحة حقول الإدخال في الوقت الفعلي
- التحقق من البيانات قبل إرسالها إلى الخادم
- إنشاء كود نظيف مع فصل المسؤوليات
استخدم Validated إذا كنت ترغب في تقليل كود boilerplate وجعل التحقق شفافاً وقابلاً للاختبار. المكتبة مدعومة بنشاط ومتوافقة مع iOS 13+ وmacOS 10.15+.