الصنف ZipInfo في بايثون
يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف. يعيد التابعان getinfo() و infolist() في كائنات ZipFile نسخًا من هذا الصنف. لن تحتاج في أغلب الأحيان إلى إنشاء نسخة من هذا الصنف بنفسك، بل ستستخدم النسخ التي تنشئها الوحدة zipfile.
البنية العامة
class zipfile.ZipInfo(filename='NoName', date_time=(1980, 1, 1, 0, 0, 0))
المعاملات
filename
الاسم الكامل لعضو الأرشيف.
date_time
يجب أن يكون هذا المعامل صفًّا يتضمن ستة حقول تمثّل الوقت الذي جرى فيه آخر تعديل للملف. راجع قسم كائنات ZipInfo للاطلاع على وصف مفصّل لهذه الحقول.
ملاحظات:
- هذا الكائن جديد في الإصدار 3.2 من بايثون.
- أصبحت إضافات ZIP64 مفعّلة بصورة افتراضية في الإصدار 3.4 من بايثون.
خصائص الصنف ZipInfo
ZipInfo.filename
اسم الملف في الأرشيف.
ZipInfo.date_time
تاريخ وزمن آخر تعديل أجري على العضو في الأرشيف. هذه الخاصية عبارة عن صفّ يحتوي على ستّ قيم:
Index Value 0 Year (>= 1980) 1 Month (one-based) 2 Day of month (one-based) 3 Hours (zero-based) 4 Minutes (zero-based) 5 Seconds (zero-based)
ملاحظة: لا تدعم ملفات ZIP الأختام الزمنية التي تسبق التاريخ 1980.
ZipInfo.compress_type
نوع عملية الضغط المطبّقة على العضو في الأرشيف.
ZipInfo.comment
التعليق المرتبط بالعضو في الأرشيف.
ZipInfo.extra
بيانات Expansion field. تحتوي الملاحظات الخاصة بتطبيق PKZIP على بعض التوضيحات بخصوص البنية الداخلية للبيانات التي تتضمّنها هذه السلسلة النصية.
ZipInfo.create_system
النظام الذي أنشأ ملف ZIP.
ZipInfo.create_version
إصدار تطبيق PKZIP الذي أنشأ ملف ZIP.
ZipInfo.extract_version
إصدار تطبيق PKZIP الواجب استخدامه لاستخراج الملفات من ملف ZIP.
ZipInfo.reserved
يجب أن تكون صفرًا.
ZipInfo.flag_bits
رايات البتات flag bits الخاصّة بملف ZIP.
ZipInfo.volume
رقم الإصدار volume لترويسة الملف.
ZipInfo.internal_attr
الخصائص الداخلية.
ZipInfo.external_attr
الخصائص الخارجية للملف.
ZipInfo.header_offset
مقدار الإزاحة بالبايتات إلى ترويسة الملف.
ZipInfo.CRC
CRC-32 للملفات غير المضغوطة.
ZipInfo.compress_size
حجم البيانات المضغوطة.
ZipInfo.file_size
حجم الملفات غير المضغوطة.
توابع الصنف ZipInfo
تابع الصنف ZipInfo.fromfile()
ينشئ تابع الصنف هذا كائن ZipInfo للملف المعطى، ويهيّئه لإضافته إلى ملف zip.
التابع ZipInfo.is_dir()
يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا.
أمثلة
يبين المثال التالي طريقة إنشاء كائن PyZipFile يدعم الكتابة:
>>> import zipfile
>>> pyzip = zipfile.PyZipFile('files.zip', 'w')
انظر أيضًا
- الصنف
ZipFile: يستخدم هذا الصنف لقراءة ملفات ZIP والكتابة فيها. - الصنف
ZipInfo: يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف.