شارك المقالة
شرح try وexcept في Python وقراءة ZIP بكلمة مرور معروفة

شرح try وexcept في Python وقراءة ZIP بكلمة مرور معروفة

تعلم try وexcept في Python لمعالجة الأرقام والملفات وأخطاء ZIP، مع قراءة ملف نصي بكلمة مرور معروفة وحد لحجم البيانات…

شرح try وexcept في Python يتعلق بتنظيم الأخطاء التي تتوقعها أثناء التشغيل. تحويل نص إلى رقم قد يفشل، والقسمة على صفر تختلف عن عدم وجود ملف أو تلف أرشيف. سنفصل هذه الحالات بدل استخدام except فارغة تبتلع كل شيء. الجزء الخاص بـZIP يقرأ ملفًا تختاره من أرشيف بكلمة مرور تعرفها، ولا ينفذ بحثًا عن كلمات مرور أو محاولات آلية متكررة. تبقى النتيجة نصًا في الذاكرة ولا تستخرج ملفات إلى مجلدات الجهاز.

التجهيز والتشغيل

استخدم Python 3.9 أو أحدث واحفظ المثال في ملف مستقل خارج مجلد مكتبات Python.

python lesson_25637.py

try وexcept وelse وfinally

ضع في try العملية التي قد تفشل، ثم حدد نوع الاستثناء الذي تعرف كيف تتعامل معه. تنفذ else عندما تنتهي try دون استثناء، وتستخدم finally لتنظيف مورد مهما كانت النتيجة. مع الملفات يكون with غالبًا أوضح لإغلاق الملف تلقائيًا. لا تضع البرنامج كاملًا في try ثم تعرض الرسالة نفسها لكل خطأ؛ يصعب عندها معرفة هل المشكلة إدخال المستخدم أم اسم متغير خاطئ في الكود.

أرقام وقراءة ملفات بصورة صحيحة

تحول divide_text الطرفين إلى float ثم تقسمهما، فتختلف ValueError عن ZeroDivisionError. وتستخدم count_lines عدادًا على أسطر الملف داخل with دون محاولة تمرير نص إضافي إلى len. إذا قرأت ملفًا بعد إغلاقه سيظهر خطأ مورد مغلق؛ لذلك لا تحتفظ بقارئ يعتمد على الملف وتؤجل استعماله لما بعد نهاية السياق. حدد UTF-8 عندما يكون هذا هو ترميز بيانات المثال بدل الاعتماد على إعداد الجهاز.

المثال البرمجي الكامل

from pathlib import Path
from zipfile import ZipFile, BadZipFile

def divide_text(first, second):
    return float(first) / float(second)

def count_lines(path):
    with Path(path).open(encoding="utf-8") as source:
        return sum(1 for _ in source)

def read_zip_text(archive_path, member, password=None, max_bytes=1000000):
    if max_bytes <= 0:
        raise ValueError("max_bytes must be positive")
    pwd = password.encode("utf-8") if password is not None else None
    with ZipFile(archive_path) as archive:
        info = archive.getinfo(member)
        if info.is_dir() or info.file_size > max_bytes:
            raise ValueError("Choose a small text file, not a directory")
        with archive.open(info, pwd=pwd) as source:
            data = source.read(max_bytes + 1)
        if len(data) > max_bytes:
            raise ValueError("Uncompressed content exceeds the limit")
        return data.decode("utf-8")

if __name__ == "__main__":
    import argparse
    import getpass
    parser = argparse.ArgumentParser()
    parser.add_argument("--archive")
    parser.add_argument("--member", default="notes.txt")
    parser.add_argument("--password", action="store_true")
    args = parser.parse_args()
    try:
        if args.archive:
            password = getpass.getpass("Known ZIP password: ") if args.password else None
            print(read_zip_text(args.archive, args.member, password))
        else:
            print(divide_text("10", "2"))
    except ZeroDivisionError:
        print("The denominator cannot be zero")
    except (ValueError, UnicodeDecodeError):
        print("Check numbers, file size and UTF-8 encoding")
    except (FileNotFoundError, KeyError):
        print("Archive or selected member not found")
    except BadZipFile:
        print("Invalid ZIP archive or damaged content")
    except (RuntimeError, NotImplementedError):
        print("Check the known password and supported ZIP encryption/compression")

قراءة عضو محدد من ZIP

تفتح read_zip_text الأرشيف وتطلب اسم member كما يظهر داخله، ثم تفحص أنه ليس مجلدًا وأن الحجم المعلن ضمن الحد. تقرأ حتى الحد زائد بايت للتأكد من عدم تجاوز النتيجة، وتفك UTF-8 بعد اكتمال القراءة. لا نستخدم extractall، ولذلك لا تكتب أسماء الأعضاء الموجودة داخل الأرشيف مسارات على القرص. اختر أرشيفًا موثوق المصدر وملفًا نصيًا صغيرًا؛ الحد هنا يقلل حجم النص المقروء ولا يمثل عزلًا كاملًا لكل أرشيف خبيث.

كلمة المرور وأنواع ZIP المدعومة

إذا كان العضو مشفرًا فمرر كلمة المرور المعروفة بعد اختيار –password ليطلبها getpass دون عرضها. لا تضع كلمة المرور نصًا في أمر الطرفية أو في الكود المنشور. تدعم مكتبة zipfile بعض آليات ZIP ولا تدعم كل أنواع التشفير والضغط، وقد يظهر RuntimeError أو NotImplementedError عند كلمة غير صحيحة أو نوع غير مدعوم. لا تعالج ذلك بحذف الخطأ وطباعة نجاح؛ راجع أداة إنشاء الأرشيف ونوع الحماية.

التشغيل والنتائج المتوقعة

عند تشغيل السكربت دون خيارات سيعرض ناتج 10 مقسومة على 2. لقراءة أرشيف نفذ python lesson_25637.py –archive sample.zip –member notes.txt، وأضف –password فقط عند الحاجة. إذا كان الملف بداخل مجلد فاستعمل اسمه الكامل داخل الأرشيف مثل docs/notes.txt. لا تغير اسم الملف في النظام وتفترض أن اسم العضو تغير داخله أيضًا. وعند اختلاف الترميز ستحتاج تحديد ترميز صحيح بدل تجاهل الحروف غير القابلة للفك.

اختبارات لحالات النجاح والفشل

جهز أرشيفًا تجريبيًا فيه نص صغير، ثم جرّب عضوًا غير موجود ومجلدًا وملفًا يتجاوز الحد. جرّب أرشيفًا تالفًا وكلمة مرور خاطئة مع أرشيف تجريبي أنشأته بنفسك، ولا تنفذ الاختبارات على بيانات مهمة. يجب أن يظهر سبب مفهوم وأن تغلق الموارد بعد كل محاولة. اختبر القسمة بإدخال غير رقمي وبصفر، ولا تعتبر ظهور رسالة واحدة دليلًا على أن كل أنواع الاستثناءات عولجت بالشكل المطلوب.

متى أعيد رفع الاستثناء؟

إذا كانت الدالة جزءًا من مكتبة، فقد يكون الأفضل ترك الاستثناء يصل إلى المستدعي ليقرر طريقة عرضه، بدل الطباعة داخل كل دالة وإعادة None دون توضيح. يفصل المثال الدوال التي تنفذ العمل عن رسائل كتلة main. يمكنك لاحقًا إضافة تسجيل للخطأ المناسب دون كلمات مرور أو محتوى حساس. لا تستخدم except Exception ثم تواصل الحساب بقيم غير مكتملة إلا إذا عرّفت مسارًا صحيحًا للتعافي واختبرته صراحة.

المراجع

الاستثناءات وملفات ZIP

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

شرح قاعدة try و except في python امثلة على استخدام try و catch  في البايثون التعرف على انواع except المختلفة في البايثون كيفية فك الضغط على ملف zip محمي برقم سري باستخدام ألبايثون كيفية فك الضغط على ملف zip محمي برقم سري باستخدام ألبايثون
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع