مختبر تحقق التسجيل

التحقق من بيانات المستخدم نقطة يلتقي فيها كل ما تعلمته: استثناءات مخصصة، تسلسل هرمي، إطلاق والتقاط، وجمع أخطاء متعددة. في هذا المختبر ستبني منظومة تحقق كاملة من نموذج تسجيل — كما تجدها في تطبيقات Python الحقيقية.

لماذا التسجيل مثالاً ممتازاً؟ لأن المستخدم يرسل بيانات متعددة في آنٍ واحد، وأي منها قد يكون خاطئاً. التحقق الجيد لا يقف عند أول خطأ ويعود بـ “البريد غير صالح” — بل يجمع جميع المشاكل ويُرسلها دفعة واحدة حتى يُصلح المستخدم كل شيء في مرة واحدة لا عشر مرات.

بنية المنظومة

سنبني المنظومة على ثلاث طبقات:

ValidationError (الأب)
├── EmailError     — أخطاء البريد الإلكتروني
├── PasswordError  — أخطاء كلمة المرور
└── UsernameError  — أخطاء اسم المستخدم

كل مُحقّق (validator) يُطلق الاستثناء المناسب. المنسّق (composer) يشغّل جميع المُحققين ويُقرر: هل نتوقف عند أول خطأ أم نجمعها كلها؟

خطوة 1: تسلسل هرمي الاستثناءات

main.go

# الطبقة 1: بناء التسلسل الهرمي — Layer 1: Build the hierarchy

class ValidationError(Exception):
    # الأب لجميع أخطاء التحقق — Base for all validation errors
    def __init__(self, field, message):
        self.field = field        # الحقل المتأثر — Affected field
        self.message = message    # وصف المشكلة — Problem description
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    # خطأ خاص بالبريد — Email-specific error
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    # خطأ خاص بكلمة المرور — Password-specific error
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    # خطأ خاص باسم المستخدم — Username-specific error
    def __init__(self, reason):
        super().__init__("username", reason)

# اختبار التسلسل الهرمي — Test the hierarchy
errors = [
    EmailError("يجب أن يحتوي على @"),
    PasswordError("يجب أن تكون 8 أحرف على الأقل"),
    UsernameError("يجب أن يكون 3 أحرف على الأقل"),
]

for err in errors:
    print(f"الحقل: {err.field} | الرسالة: {err.message}")
    print(f"  هل هو ValidationError؟ {isinstance(err, ValidationError)}")

print()
# التقاط بالأب يعمل لجميع الأنواع الفرعية — Catching by base catches all subtypes
for err in errors:
    try:
        raise err
    except EmailError:
        print(f"التقطنا EmailError: {err}")
    except PasswordError:
        print(f"التقطنا PasswordError: {err}")
    except UsernameError:
        print(f"التقطنا UsernameError: {err}")

Output:

خطوة 2: المُحققون الفرديون

كل مُحقق يفحص قاعدة واحدة. إذا فشلت، يُطلق الاستثناء المناسب:

main.go

# المحققون الفرديون — Individual validators

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

def validate_email(email):
    # التحقق من البريد: يجب أن يحتوي @ — Email must contain @
    email = email.strip()
    if not email:
        raise EmailError("البريد لا يمكن أن يكون فارغاً")
    if "@" not in email:
        raise EmailError("يجب أن يحتوي على @")
    # تحقق أن هناك نطاق بعد @ — Domain must exist after @
    parts = email.split("@")
    if len(parts) != 2 or not parts[1]:
        raise EmailError("نطاق البريد غير صالح")

def validate_password(password):
    # التحقق: 8 أحرف على الأقل وحرف رقمي واحد — 8+ chars and at least one digit
    if len(password) < 8:
        raise PasswordError(
            f"يجب أن تكون 8 أحرف على الأقل (لديك {len(password)})"
        )
    if not any(c.isdigit() for c in password):
        raise PasswordError("يجب أن تحتوي على رقم واحد على الأقل")

def validate_username(username):
    # التحقق: حروف وأرقام فقط، 3 أحرف على الأقل — Alphanumeric, 3+ chars
    username = username.strip()
    if len(username) < 3:
        raise UsernameError(
            f"يجب أن يكون 3 أحرف على الأقل (لديك {len(username)})"
        )
    if not username.isalnum():
        raise UsernameError("يجب أن يحتوي على حروف وأرقام فقط (بدون مسافات أو رموز)")

# اختبار المحققين — Test validators
tests = [
    ("ahmed.example.com", "secret1", "ahmed"),    # بريد بدون @
    ("ahmed@example.com", "weak",    "ahmed"),    # كلمة مرور قصيرة
    ("ahmed@example.com", "secret1", "a b"),      # اسم بمسافة
    ("ahmed@example.com", "secret1", "ahmed"),    # كل شيء صحيح
]

for email, password, username in tests:
    print(f"--- اختبار: {email}, {password!r}, {username!r} ---")
    for validator, value in [
        (validate_email, email),
        (validate_password, password),
        (validate_username, username),
    ]:
        try:
            validator(value)
        except ValidationError as e:
            print(f"  خطأ في {e.field}: {e.message}")

Output:

التحدي الأول: مُحقق البريد

تحدي — Challenge

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

def validate_email(email):
    # أكمل التحقق: @ موجود، ونطاق صالح بعده
    # Complete validation: @ exists, valid domain follows
    email = email.strip()
    if not email:
        raise EmailError("البريد لا يمكن أن يكون فارغاً")
    # أضف تحقق @ والنطاق هنا — Add @ and domain checks here
    pass

# اختبر — Test
for email in ["no-at-sign.com", "missing@", "ahmed@example.com"]:
    try:
        validate_email(email)
        print(f"البريد صالح: {email}")
    except EmailError as e:
        print(f"خطأ في {e.field}: {e.message}")

التحدي الثاني: مُحقق كلمة المرور

تحدي — Challenge

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

def validate_password(password):
    # تحقق: 8 أحرف على الأقل ورقم واحد على الأقل
    # Validate: 8+ chars and at least one digit
    # أضف الكود هنا — Add code here
    pass

for pw in ["short1", "ndigitshere", "secret42"]:
    try:
        validate_password(pw)
        print(f"كلمة المرور صالحة: {pw}")
    except PasswordError as e:
        print(f"خطأ في {e.field}: {e.message}")

التحدي الثالث: مُحقق اسم المستخدم

تحدي — Challenge

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

def validate_username(username):
    # تحقق: 3 أحرف على الأقل، حروف وأرقام فقط
    # Validate: 3+ chars, alphanumeric only
    username = username.strip()
    # أضف الكود هنا — Add code here
    pass

for name in ["ab", "bad name!", "ahmed99"]:
    try:
        validate_username(name)
        print(f"اسم المستخدم صالح: {name}")
    except UsernameError as e:
        print(f"خطأ في {e.field}: {e.message}")

خطوة 3: التحقق المُركّب — التوقف عند أول خطأ

الآن ننسّق المُحققين الثلاثة معاً. أبسط شكل: نتوقف عند أول خطأ.

main.go

# التحقق المركب — Composed validation (stop at first error)

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

def validate_email(email):
    email = email.strip()
    if "@" not in email:
        raise EmailError("يجب أن يحتوي على @")
    parts = email.split("@")
    if len(parts) != 2 or not parts[1]:
        raise EmailError("نطاق البريد غير صالح")

def validate_password(password):
    if len(password) < 8:
        raise PasswordError(f"يجب أن تكون 8 أحرف على الأقل (لديك {len(password)})")
    if not any(c.isdigit() for c in password):
        raise PasswordError("يجب أن تحتوي على رقم واحد على الأقل")

def validate_username(username):
    username = username.strip()
    if len(username) < 3:
        raise UsernameError(f"يجب أن يكون 3 أحرف على الأقل (لديك {len(username)})")
    if not username.isalnum():
        raise UsernameError("يجب أن يحتوي على حروف وأرقام فقط")

def validate_signup(email, password, username):
    # التحقق المتسلسل — يتوقف عند أول خطأ
    # Sequential validation — stops at first error
    validate_email(email)
    validate_password(password)
    validate_username(username)

# اختبار — Test
test_cases = [
    ("noemail.com",          "secret123",  "ahmed",    "بريد خاطئ"),
    ("user@example.com",     "weak",       "ahmed",    "مرور قصير"),
    ("user@example.com",     "nodigit!!",  "ahmed",    "بلا رقم"),
    ("user@example.com",     "secret123",  "ab",       "اسم قصير"),
    ("user@example.com",     "secret123",  "ahmed",    "كل شيء صحيح"),
]

for email, password, username, label in test_cases:
    print(f"\n--- {label} ---")
    try:
        validate_signup(email, password, username)
        print("تم قبول التسجيل")
    except ValidationError as e:
        print(f"رُفض ({e.field}): {e.message}")
        print(f"  نوع الخطأ: {type(e).__name__}")

Output:

التحدي الرابع: التحقق المُركّب مع تقرير الحقل الفاشل

تحدي — Challenge

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

def validate_email(email):
    if "@" not in email.strip():
        raise EmailError("يجب أن يحتوي على @")

def validate_password(password):
    if len(password) < 8:
        raise PasswordError(f"يجب أن تكون 8 أحرف على الأقل (لديك {len(password)})")

def validate_username(username):
    if len(username.strip()) < 3:
        raise UsernameError(f"يجب أن يكون 3 أحرف على الأقل")

def validate_signup(email, password, username):
    # استدع المحققين الثلاثة بالترتيب — Call all three validators in order
    # أضف الكود هنا — Add code here
    pass

test_cases = [
    ("no-at.com",         "secret123", "ahmed",   "بريد خاطئ"),
    ("user@example.com",  "abc",       "ahmed",   "مرور قصير"),
    ("user@example.com",  "secret123", "ahmed",   "كل شيء صحيح"),
]

for email, password, username, label in test_cases:
    try:
        validate_signup(email, password, username)
        print(f"{label} — تم قبول التسجيل")
    except ValidationError as e:
        print(f"{label} — رُفض ({e.field}): {e.message}")

خطوة 4: جمع جميع الأخطاء — Collect ALL Errors

التوقف عند أول خطأ مزعج للمستخدم — يصلح البريد ويُرسل، ثم يكتشف أن كلمة المرور خاطئة أيضاً. النمط الأفضل: اجمع جميع الأخطاء وأرجعها دفعة واحدة.

main.go

# جمع جميع الأخطاء — Collect all errors

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

class MultiValidationError(Exception):
    # حاوية لأخطاء متعددة — Container for multiple errors
    def __init__(self, errors):
        self.errors = errors  # قائمة ValidationError — List of ValidationError
        messages = [str(e) for e in errors]
        super().__init__("أخطاء متعددة:\n" + "\n".join(f"  • {m}" for m in messages))

def validate_email(email):
    email = email.strip()
    if "@" not in email:
        raise EmailError("يجب أن يحتوي على @")
    parts = email.split("@")
    if len(parts) != 2 or not parts[1]:
        raise EmailError("نطاق البريد غير صالح")

def validate_password(password):
    if len(password) < 8:
        raise PasswordError(f"يجب أن تكون 8 أحرف على الأقل (لديك {len(password)})")
    if not any(c.isdigit() for c in password):
        raise PasswordError("يجب أن تحتوي على رقم واحد على الأقل")

def validate_username(username):
    username = username.strip()
    if len(username) < 3:
        raise UsernameError(f"يجب أن يكون 3 أحرف على الأقل (لديك {len(username)})")
    if not username.isalnum():
        raise UsernameError("يجب أن يحتوي على حروف وأرقام فقط")

def validate_signup_all(email, password, username):
    # جمع جميع الأخطاء بدلاً من التوقف عند أول خطأ
    # Collect all errors instead of stopping at first
    errors = []

    for validator, value in [
        (validate_email, email),
        (validate_password, password),
        (validate_username, username),
    ]:
        try:
            validator(value)
        except ValidationError as e:
            errors.append(e)  # سجّل الخطأ وتابع — Record and continue

    if errors:
        raise MultiValidationError(errors)

# اختبار بأخطاء متعددة — Test with multiple errors
test_cases = [
    ("noemail.com",      "abc",       "a",       "ثلاثة أخطاء"),
    ("user@example.com", "nod1git!!",  "ahmed",   "خطأ واحد"),
    ("user@example.com", "secret123",  "ahmed",   "لا أخطاء"),
]

for email, password, username, label in test_cases:
    print(f"\n=== {label} ===")
    try:
        validate_signup_all(email, password, username)
        print("تم قبول التسجيل")
    except MultiValidationError as e:
        print(f"رُفض — {len(e.errors)} خطأ:")
        for err in e.errors:
            print(f"  [{err.field}] {err.message}")
    except ValidationError as e:
        print(f"رُفض ({e.field}): {e.message}")

Output:

التحدي الخامس: جمع الأخطاء بنفسك

تحدي — Challenge

class ValidationError(Exception):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f"{field}: {message}")

class EmailError(ValidationError):
    def __init__(self, reason):
        super().__init__("email", reason)

class PasswordError(ValidationError):
    def __init__(self, reason):
        super().__init__("password", reason)

class UsernameError(ValidationError):
    def __init__(self, reason):
        super().__init__("username", reason)

class MultiValidationError(Exception):
    def __init__(self, errors):
        self.errors = errors
        super().__init__(f"{len(errors)} أخطاء")

def validate_email(email):
    if "@" not in email.strip():
        raise EmailError("يجب أن يحتوي على @")

def validate_password(password):
    if len(password) < 8:
        raise PasswordError(f"يجب أن تكون 8 أحرف على الأقل (لديك {len(password)})")

def validate_username(username):
    if len(username.strip()) < 3:
        raise UsernameError(f"يجب أن يكون 3 أحرف على الأقل (لديك {len(username.strip())})")

def validate_signup_all(email, password, username):
    # اجمع جميع الأخطاء — Collect all errors
    errors = []
    # شغّل كل محقق في try/except منفصل — Run each validator in separate try/except
    # أضف الكود هنا — Add code here
    if errors:
        raise MultiValidationError(errors)

test_cases = [
    ("noemail.com", "abc", "a",         "ثلاثة أخطاء"),
    ("u@e.com",     "sec99999", "ahmed", "كل شيء صحيح"),
]

for email, password, username, label in test_cases:
    print(f"=== {label} ===")
    try:
        validate_signup_all(email, password, username)
        print("تم قبول التسجيل")
    except MultiValidationError as e:
        print(f"رُفض — {len(e.errors)} أخطاء:")
        for err in e.errors:
            print(f"  [{err.field}] {err.message}")

ملاحظات عملية

التقط المحدد، لا العام: في كل validator نلتقط ValidationError (الأب) لا Exception — هذا يضمن أن أخطاء البرمجة نفسها مثل AttributeError تصل للأعلى ولا تُخفى.

الترتيب جزء من العقد: عندما تُوقف عند أول خطأ، ترتيب استدعاء المُحققين يُحدد أي خطأ يظهر أولاً. هذا سلوك ضمني يجب أن تعرفه وتوثقه.

نص الرسالة للمطور، واجهة المستخدم لشيء آخر: استثناءات التحقق تحمل رسائل دقيقة للمطور. في تطبيق حقيقي، طبقة العرض (HTTP handler، CLI) تُحوّلها لرسائل ودية للمستخدم.

لا تستخدم استثناءات للتحكم في التدفق العادي: الاستثناءات للأحداث الاستثنائية. التحقق من المدخلات في حدوده مقبول، لكن لا تستخدم raise/except كـ if/else مُبطّن.

خلاصة المختبر

بنيت في هذا المختبر منظومة تحقق كاملة:

تسلسل هرمي يُتيح التقاط محددداً أو عاماً بحسب الحاجة
مُحققون فرديون بمسؤولية واحدة لكل منهم
منسّق يتوقف عند أول خطأ — مناسب للسيناريوهات التسلسلية
منسّق يجمع الأخطاء — مناسب للنماذج التي تعرض كل المشاكل دفعة واحدة

هذه الأنماط مباشرة ستجدها في مكتبات Python الكبيرة مثل Pydantic وDjango Forms وMarshmallow — التي تبني فوق نفس الأفكار بمزيد من المرونة. الآن أنت تفهم ما تفعله تحت الغطاء.

مختبر تحقق التسجيل