الصنف 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

تاريخ وزمن آخر تعديل أجري على العضو في الأرشيف. هذه الخاصية عبارة عن صفّ يحتوي على ستّ قيم:

التسلسل القيمة
0 السنة (>= 1980)
1 الشهر (يبدأ من 1)
2 اليوم في الشهر (يبدأ من 1)
3 الساعات (تبدأ من 0)
4 الدقائق (تبدأ من 0)
5 الثواني (تبدأ من 0)

ملاحظة: لا تدعم ملفات 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.from_file()

ينشئ تابع الصنف هذا كائن ZipInfo للملف المعطى، ويهيّئه لإضافته إلى ملف zip.

التابع ZipInfo.is_dir()‎

يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا.

أمثلة

يبين المثال التالي طريقة إنشاء كائن PyZipFile يدعم الكتابة:

>>> import zipfile
>>> pyzip = zipfile.PyZipFile('files.zip', 'w')

انظر أيضًا

  • الصنف ZipFile: يستخدم هذا الصنف لقراءة ملفات ZIP والكتابة فيها.
  • الصنف PyZipFile‎: يستخدم هذا الصنف لإنشاء ملفات ZIP تتضمّن مكتبات بايثون. 

مصادر