التابع `ZipFile.extract()‎‎` في بايثون

يستخرج التابع الملف العضو المعطى من الأرشيف إلى المجلد الحالي.

البنية العامة

ZipFile.extract(member, path=None, pwd=None)

اسم عضو الأرشيف الكامل أو كائن ZipInfo. يحاول التابع استخراج المعلومات بأكبر دقة ممكنة.

المجلد الذي ترغب في استخراج الملف إليه بدلًا من المجلد الحالي.

كلمة المرور المستخدمة في تعمية الملف المضغوط.

يعيد التابع المسار المسوّى (normalized path) الناشئ (مجلّد أو ملف جديد).

ملاحظات:

إن امتلك اسم الملف لعضو معيّن في الأرشيف مسارًا مطلقًا، فسيُحذف منه اسم محرّك الأقراص أو نقطة مشاركة UNC إضافة إلى الخطوط المائلة، فيتحول المسار ‎///foo/bar إلى foo/bar في نظام يونكس، ويتحول المسار C:\foo\bar إلى foo\bar في نظام ويندوز. كذلك تُحذف جميع النقاط ".." من اسم الملف، فيتحول المسار ‎../../foo../../ba..r إلى foo../b..r. كذلك تُستبدل المحارف التي لا يمكن استخدامها في تسمية الملفات (:، <، >، |، "، ?، *) بالشرطة السفلية (_).
يؤدي استدعاء التابع extract()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
أصبح المعامل path يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.

يبين المثال التالي آلية عمل التابع:

>>> import zipfile
>>> zip = zipfile.ZipFile('files.zip')
>>> zip.extract('file2.html')
'/home/myfiles/file2.html'

التابع ZipFile.extractall()‎: يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي.