الفرق بين المراجعتين لصفحة: «Python/TarFile»

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الوحدة <code>tarfile‎</code> في بايثون}}</noinclude> وظيفة هذا الصنف هي قراءة ملفات الأرشيف م...'
 
لا ملخص تعديل
 
(8 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الوحدة <code>tarfile‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:الصنف <code>TarFile</code> في بايثون}}</noinclude>


وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة tarfile.open()‎ عوضًا عنه. راجع قسم كائنات TarFile.
وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة <code>[[Python/tarfile/open|tarfile.open()]]</code>‎ عوضًا عنه.


يقدّم كائن TarFile واجهة لملفات الأرشيف من نوع tar. يتكوّن أرشيف tar من تسلسل من الكتل،  ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن TarInfo (راجع قسم كائنات TarInfo للمزيد من التفاصيل).
يقدّم كائن <code>TarFile</code> واجهة لملفات الأرشيف من نوع <code>tar.</code> يتكوّن أرشيف tar من تسلسل من الكتل،  ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن <code>[[Python/TarInfo|TarInfo]]</code> (راجع قسم كائنات <code>[[Python/TarInfo|TarInfo]]</code> للمزيد من التفاصيل).


يمكن استخدام كائن TarFile كمدير للسياق context manager في عبارة with، وسيُغلق الكائن تلقائيًا عند الوصول إلى نهاية الكتلة البرمجية. ويجدر التنبيه هنا إلى أنّه في حال حدوث أي استثناء فإنّ الأرشيف المفتوح للكتابة لن يجري إنهاؤه، ولكن ما سيحدث هو إغلاق كائن الملف الداخلي فقط. راجع قسم الأمثلة للمزيد من التوضيح.
يمكن استخدام كائن <code>TarFile</code> كمدير للسياق context manager في عبارة <code>with</code>، وسيُغلق الكائن تلقائيًا عند الوصول إلى نهاية الكتلة البرمجية. ويجدر التنبيه هنا إلى أنّه في حال حدوث أي استثناء فإنّ الأرشيف المفتوح للكتابة لن يجري إنهاؤه، ولكن ما سيحدث هو إغلاق كائن الملف الداخلي فقط.  
ملاحظة: أضيف دعم بروتوكول إدارة السياق في الإصدار 3.2 من بايثون.
 
'''ملاحظة:''' أضيف دعم بروتوكول إدارة السياق في الإصدار 3.2 من بايثون.


== البنية العامة ==
== البنية العامة ==
سطر 13: سطر 14:
tarfile.TarFile(name=None, mode='r', fileobj=None, format=DEFAULT_FORMAT, tarinfo=TarInfo, dereference=False, ignore_zeros=False, encoding=ENCODING, errors='surrogateescape', pax_headers=None, debug=0, errorlevel=0)
tarfile.TarFile(name=None, mode='r', fileobj=None, format=DEFAULT_FORMAT, tarinfo=TarInfo, dereference=False, ignore_zeros=False, encoding=ENCODING, errors='surrogateescape', pax_headers=None, debug=0, errorlevel=0)
</syntaxhighlight>
</syntaxhighlight>
‎


== المعاملات ==
== ‎المعاملات ==
‎جميع المعاملات في الدالة البانية اختيارية ويمكن الوصول إليها كخصائص لنسخ الصنف أيضًا.
‎جميع المعاملات في الدالة البانية اختيارية ويمكن الوصول إليها كخصائص لنسخ الصنف أيضًا.


=== name ===
=== <code>name</code> ===
مسار ملف الأرشيف، ويمكن أن يكون المعامل كائنًا شبيهًا بالمسار path-like object. يمكن حذف هذا المعامل إن كان المعامل fileobj يحمل قيمة، وفي مثل هذه الحالة تستخدم خاصية name في كائن الملف إن كانت موجودة.
مسار ملف الأرشيف، ويمكن أن يكون المعامل كائنًا شبيهًا بالمسار path-like object. يمكن حذف هذا المعامل إن كان المعامل <code>fileobj</code> يحمل قيمة، وفي مثل هذه الحالة تستخدم خاصية <code>name</code> في كائن الملف إن كانت موجودة.


=== mode ===
=== <code>mode</code> ===
يأخذ هذا المعامل القيمة 'r' للقراءة من ملف أرشيف موجودًا فعلًا، أو 'a' لإلحاق البيانات بملف موجود فعلًا، أو 'w' لإنشاء ملف جديد والكتابة فوق ملف موجود أصلًا، أو 'x' لإنشاء ملف جديد في حال إذا لم يكن الملف موجودًا.
يأخذ هذا المعامل القيمة <code>'r'</code> للقراءة من ملف أرشيف موجودًا فعلًا، أو <code>'a'</code> لإلحاق البيانات بملف موجود فعلًا، أو <code>'w'</code> لإنشاء ملف جديد والكتابة فوق ملف موجود أصلًا، أو <code>'x'</code> لإنشاء ملف جديد في حال إذا لم يكن الملف موجودًا.


=== fileobj ===
=== <code>fileobj</code> ===
يستخدم هذا المعامل -في حال تعريفه- لقراءة البيانات وكتابتها. إن كان بالإمكان تحديد هذا قيمة هذا المعامل فإنّ قيمة المعامل mode ستتغير إلى الوضع المستخدم مع fileobj. سيستخدم الملف fileobj من الموقع 0.
يستخدم هذا المعامل -في حال تعريفه- لقراءة البيانات وكتابتها. إن كان بالإمكان تحديد هذا قيمة هذا المعامل فإنّ قيمة المعامل mode ستتغير إلى الوضع المستخدم مع <code>fileobj</code>. سيستخدم الملف <code>fileobj</code> من الموقع <code>0</code>.


ملاحظة: لا يُغلق كائن الملف fileobj عند إغلاق الكائن TarFile.
'''ملاحظة:''' لا يُغلَق كائن الملف <code>fileobj</code> عند إغلاق الكائن <code>TarFile</code>.


=== format ===
=== <code>format</code> ===
يتحكّم هذا المعامل بصيغة ملف الأرشيف. يجب أن يأخذ هذا المعامل إحد القيم الثابتة USTAR_FORMAT أو GNU_FORMAT أو PAX_FORMAT والمعرّفة على مستوى الوحدة.
يتحكّم هذا المعامل بصيغة ملف الأرشيف. يجب أن يأخذ هذا المعامل إحد القيم الثابتة <code>USTAR_FORMAT</code> أو <code>GNU_FORMAT</code> أو <code>PAX_FORMAT</code> والمعرّفة على مستوى الوحدة.


=== tarinfo ===
=== <code>tarinfo</code> ===
يمكن استخدام المعامل tarinfo لاستبدال كائن TarInfo الافتراضي بكائن آخر.
يمكن استخدام المعامل <code>tarinfo</code> لاستبدال كائن <code>[[Python/TarInfo|TarInfo]]</code> الافتراضي بكائن آخر.


=== dereference ===
=== <code>dereference</code> ===
إن أخذ هذا المعامل القيمة False فستضاف وصلات رمزية symbolic وصلبة hard إلى ملف الأرشيف. أما إن أخذ القيمة True فستضاف محتويات الملف المستهدف إلى ملف الأرشيف. لا تأثير لهذا المعامل في الأنظمة التي لا تدعم الوصلات الرمزية.
إن أخذ هذا المعامل القيمة <code>False</code> فستضاف وصلات رمزية symbolic وصلبة hard إلى ملف الأرشيف. أما إن أخذ القيمة <code>True</code> فستضاف محتويات الملف المستهدف إلى ملف الأرشيف. لا تأثير لهذا المعامل في الأنظمة التي لا تدعم الوصلات الرمزية.


=== ignore_zeros ===
=== <code>ignore_zeros</code> ===
إن أخذ هذا المعامل القيمة False فستعامل الكتل الفارغة على أنّها نهاية ملف الأرشيف. أما إن أخذ القيمة True فسيجري تجاوز الكتل الفارغة (وغير الصالحة) وستحاول الدالة الحصول على أكبر عدد ممكن من أعضاء ملف الأرشيف. هذا المعامل مفيد فقط في عند القراءة من ملفات الأرشيف المترابطة أو المتضرّرة.
إن أخذ هذا المعامل القيمة False فستعامل الكتل الفارغة على أنّها نهاية ملف الأرشيف. أما إن أخذ القيمة True فسيجري تجاوز الكتل الفارغة (وغير الصالحة) وستحاول الدالة الحصول على أكبر عدد ممكن من أعضاء ملف الأرشيف. هذا المعامل مفيد فقط في عند القراءة من ملفات الأرشيف المترابطة أو المتضرّرة.


=== debug ===
=== <code>debug</code> ===
يمكن أن يأخذ المعامل قيمًا تتدرج من 0 (لا رسائل تنقيح) إلى 3 (عرض جميع رسائل التنقيح). تكتب الرسائل إلى sys.stderr.
يمكن أن يأخذ المعامل قيمًا تتدرج من <code>0</code> (لا رسائل تنقيح) إلى <code>3</code> (عرض جميع رسائل التنقيح). تكتب الرسائل إلى <code>sys.stderr</code>.


=== errorlevel ===
=== <code>errorlevel</code> ===
إن أخذ هذا المعامل القيمة 0 فسيجري تجاهل جميع الأخطاء عند استخدام التابع TarFile.extract. ومع ذلك فإنّها ستظهر كرسائل أخطاء في مخرجات التنقيح، عندما يكون التنقيح مفعّلًا. أما لو أخذ المعامل القيمة 1 فإن جميع الأخطاء المميتة ستطلق كاستثناءات من نوع OSError. ولو أخذ القيمة 2 فإنّ جميع الأخطاء غير المميتة ستُطلق كاستثناءات من نوع TarError.
إن أخذ هذا المعامل القيمة <code>0</code> فسيجري تجاهل جميع الأخطاء عند استخدام التابع <code>[[Python/TarFile/extract|TarFile.extract()‎]]</code>. ومع ذلك فإنّها ستظهر كرسائل أخطاء في مخرجات التنقيح، عندما يكون التنقيح مفعّلًا. أما لو أخذ المعامل القيمة <code>1</code> فإن جميع الأخطاء المميتة ستطلق كاستثناءات من نوع <code>OSError</code>. ولو أخذ القيمة <code>2</code> فإنّ جميع الأخطاء غير المميتة ستُطلق كاستثناءات من نوع <code>TarError</code>.


=== encoding و errors ===
=== <code>encoding</code> و <code>errors</code> ===
يعرّف هذا المعاملان ترميز الحروف الذي سيستخدم للقراءة من ملفات الأرشيف والكتابة فيها، وكيف سيجري التعامل مع أخطاء التحويل. عادة ما تكون الإعدادات الافتراضية مناسبة لأغلب المستخدمين. راجع قسم مشاكل Unicode للاطلاع على معلومات تفصيلية حول هذا الأمر.
يعرّف هذا المعاملان ترميز الحروف الذي سيستخدم للقراءة من ملفات الأرشيف والكتابة فيها، وكيف سيجري التعامل مع أخطاء التحويل. عادة ما تكون الإعدادات الافتراضية مناسبة لأغلب المستخدمين. راجع [[Python/tarfile#.D9.85.D8.B4.D8.A7.D9.83.D9.84 Unicode|قسم مشاكل Unicode]] للاطلاع على معلومات تفصيلية حول هذا الأمر.


=== pax_headers ===
=== <code>pax_headers</code> ===
قاموس اختياري يضمّ سلاسل نصية ستضاف كترويسة pax عامة إن كانت قيمة المعامل format هي PAX_FORMAT.
قاموس اختياري يضمّ سلاسل نصية ستضاف كترويسة pax عامة إن كانت قيمة المعامل <code>format</code> هي <code>PAX_FORMAT</code>.


ملاحظات:
ملاحظات:
* في الإصدار 3.2 من بايثون تستخدم القيمة 'surrogateescape' كقيمة افتراضية للمعامل errors.
* في الإصدار 3.2 من بايثون تستخدم القيمة <code>'surrogateescape'</code> كقيمة افتراضية للمعامل <code>errors</code>.
* في الإصدار 3.5 من بايثون أضيف الوضع 'x' (الإنشاء الخاص).
* في الإصدار 3.5 من بايثون أضيف الوضع <code>'x'</code> (الإنشاء الخاص).
* في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات path-like objects مع المعامل name.
* في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات path-like objects مع المعامل <code>name</code>.
 
== خصائص الصنف TarFile ==
 
=== الخاصية TarFile.pax_headers ===
 
قاموس يحتوي على أزواج مفتاح-قيمة لترويسات pax العامة.
 
== توابع الصنف TarFile ==
 
=== التابع TarFile.open()‎ ===
 
=== التابع TarFile.getmember()‎ ===
 
=== التابع TarFile.getmembers()‎ ===
 
=== التابع TarFile.getnames()‎ ===
 
=== التابع TarFile.list()‎ ===


=== التابع TarFile.next()‎ ===
== خصائص الصنف <code>TarFile</code> ==


=== التابع TarFile.extractall()‎ ===
=== الخاصية <code>TarFile.pax_headers</code> ===


=== التابع TarFile.extract()‎ ===
[[Python/dict|قاموس]] يحتوي على أزواج مفتاح-قيمة لترويسات <code>pax</code> العامة.


=== التابع TarFile.extractfile()‎ ===
== توابع الصنف <code>TarFile</code> ==
 
=== التابع TarFile.add()‎ ===
 
=== التابع TarFile.addfile()‎ ===
 
=== التابع TarFile.gettarinfo()‎ ===
 
=== التابع TarFile.close()‎ ===
 
 
 
== أمثلة ==
 
يبين المثال التالي طريقة استخراج جميع الملفات الموجودة في أرشيف tar إلى المجلّد الحالي:
 
<syntaxhighlight lang="python3">
 
import tarfile
tar = tarfile.open("sample.tar.gz")
tar.extractall()
tar.close()
 
</syntaxhighlight>


=== التابع <code>[[Python/TarFile/open|TarFile.open()‎]]</code> ===
يعدّ تابع الصنف هذا بمثابة دالة بانية لكائنات <code>TarFile</code>.
=== التابع <code>[[Python/TarFile/getmember|TarFile.getmember()‎]]</code> ===
يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> لعضو ملف الأرشيف المعطى.
=== التابع <code>[[Python/TarFile/getmembers|TarFile.getmembers()‎]]</code> ===
يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات <code>[[Python/TarInfo|TarInfo]]</code>
=== التابع <code>[[Python/TarFile/getnames|TarFile.getnames()‎]]</code> ===
يعيد التابع قائمة بأسماء الأعضاء في الأرشيف
=== التابع <code>[[Python/TarFile/list|TarFile.list()‎]]</code> ===
يطبع التابع جدولًا بمحتويات كائن <code>TarFile</code> إلى <code>sys.stdout</code>.
=== التابع <code>[[Python/TarFile/next|TarFile.next()‎]]</code> ===
يعيد التابع العضو التالي في الأرشيف على هيئة كائن <code>[[Python/TarInfo|TarInfo]]</code> وذلك عند فتح كائن <code>TarFile</code> للقراءة.
=== التابع <code>[[Python/TarFile/extractall|TarFile.extractall()‎]]</code> ===
يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى.
=== التابع <code>[[Python/TarFile/extract|TarFile.extract()‎]]</code> ===
يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل.
=== التابع <code>[[Python/TarFile/extractfile|TarFile.extractfile()‎]]</code> ===
يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.
=== التابع <code>[[Python/TarFile/add|TarFile.add()‎]]</code> ===
يضيف التابع الملف المعطى إلى ملف الأرشيف.
=== التابع <code>[[Python/TarFile/addfile|TarFile.addfile()‎]]</code> ===
يضيف التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> المعطى إلى ملف الأرشيف.
=== التابع <code>[[Python/TarFile/gettarinfo|TarFile.gettarinfo()‎]]</code> ===
ينشئ التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> من نتيجة استدعاء الدالة <code>[[Python/os/stat|os.stat()‎]]</code> أو ما يكافئها على ملف موجود فعلًا.
=== التابع <code>[[Python/TarFile/close|TarFile.close()‎]]</code> ===
يغلق التابع كائن <code>TarFile</code>.
== انظر أيضًا ==
== انظر أيضًا ==
* كائنات TarInfo: يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف.
* كائنات <code>[[Python/TarInfo|TarInfo]]</code>: يمثّل كائن [[Python/TarInfo|<code>TarInfo</code>]] عضوًا واحدًا في كائن <code>TarFile</code>. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف.


== مصادر ==
== مصادر ==

المراجعة الحالية بتاريخ 20:22، 14 نوفمبر 2018


وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة tarfile.open()‎ عوضًا عنه.

يقدّم كائن TarFile واجهة لملفات الأرشيف من نوع tar. يتكوّن أرشيف tar من تسلسل من الكتل، ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن TarInfo (راجع قسم كائنات TarInfo للمزيد من التفاصيل).

يمكن استخدام كائن TarFile كمدير للسياق context manager في عبارة with، وسيُغلق الكائن تلقائيًا عند الوصول إلى نهاية الكتلة البرمجية. ويجدر التنبيه هنا إلى أنّه في حال حدوث أي استثناء فإنّ الأرشيف المفتوح للكتابة لن يجري إنهاؤه، ولكن ما سيحدث هو إغلاق كائن الملف الداخلي فقط.

ملاحظة: أضيف دعم بروتوكول إدارة السياق في الإصدار 3.2 من بايثون.

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

tarfile.TarFile(name=None, mode='r', fileobj=None, format=DEFAULT_FORMAT, tarinfo=TarInfo, dereference=False, ignore_zeros=False, encoding=ENCODING, errors='surrogateescape', pax_headers=None, debug=0, errorlevel=0)

‎المعاملات

‎جميع المعاملات في الدالة البانية اختيارية ويمكن الوصول إليها كخصائص لنسخ الصنف أيضًا.

name

مسار ملف الأرشيف، ويمكن أن يكون المعامل كائنًا شبيهًا بالمسار path-like object. يمكن حذف هذا المعامل إن كان المعامل fileobj يحمل قيمة، وفي مثل هذه الحالة تستخدم خاصية name في كائن الملف إن كانت موجودة.

mode

يأخذ هذا المعامل القيمة 'r' للقراءة من ملف أرشيف موجودًا فعلًا، أو 'a' لإلحاق البيانات بملف موجود فعلًا، أو 'w' لإنشاء ملف جديد والكتابة فوق ملف موجود أصلًا، أو 'x' لإنشاء ملف جديد في حال إذا لم يكن الملف موجودًا.

fileobj

يستخدم هذا المعامل -في حال تعريفه- لقراءة البيانات وكتابتها. إن كان بالإمكان تحديد هذا قيمة هذا المعامل فإنّ قيمة المعامل mode ستتغير إلى الوضع المستخدم مع fileobj. سيستخدم الملف fileobj من الموقع 0.

ملاحظة: لا يُغلَق كائن الملف fileobj عند إغلاق الكائن TarFile.

format

يتحكّم هذا المعامل بصيغة ملف الأرشيف. يجب أن يأخذ هذا المعامل إحد القيم الثابتة USTAR_FORMAT أو GNU_FORMAT أو PAX_FORMAT والمعرّفة على مستوى الوحدة.

tarinfo

يمكن استخدام المعامل tarinfo لاستبدال كائن TarInfo الافتراضي بكائن آخر.

dereference

إن أخذ هذا المعامل القيمة False فستضاف وصلات رمزية symbolic وصلبة hard إلى ملف الأرشيف. أما إن أخذ القيمة True فستضاف محتويات الملف المستهدف إلى ملف الأرشيف. لا تأثير لهذا المعامل في الأنظمة التي لا تدعم الوصلات الرمزية.

ignore_zeros

إن أخذ هذا المعامل القيمة False فستعامل الكتل الفارغة على أنّها نهاية ملف الأرشيف. أما إن أخذ القيمة True فسيجري تجاوز الكتل الفارغة (وغير الصالحة) وستحاول الدالة الحصول على أكبر عدد ممكن من أعضاء ملف الأرشيف. هذا المعامل مفيد فقط في عند القراءة من ملفات الأرشيف المترابطة أو المتضرّرة.

debug

يمكن أن يأخذ المعامل قيمًا تتدرج من 0 (لا رسائل تنقيح) إلى 3 (عرض جميع رسائل التنقيح). تكتب الرسائل إلى sys.stderr.

errorlevel

إن أخذ هذا المعامل القيمة 0 فسيجري تجاهل جميع الأخطاء عند استخدام التابع TarFile.extract()‎. ومع ذلك فإنّها ستظهر كرسائل أخطاء في مخرجات التنقيح، عندما يكون التنقيح مفعّلًا. أما لو أخذ المعامل القيمة 1 فإن جميع الأخطاء المميتة ستطلق كاستثناءات من نوع OSError. ولو أخذ القيمة 2 فإنّ جميع الأخطاء غير المميتة ستُطلق كاستثناءات من نوع TarError.

encoding و errors

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

pax_headers

قاموس اختياري يضمّ سلاسل نصية ستضاف كترويسة pax عامة إن كانت قيمة المعامل format هي PAX_FORMAT.

ملاحظات:

  • في الإصدار 3.2 من بايثون تستخدم القيمة 'surrogateescape' كقيمة افتراضية للمعامل errors.
  • في الإصدار 3.5 من بايثون أضيف الوضع 'x' (الإنشاء الخاص).
  • في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات path-like objects مع المعامل name.

خصائص الصنف TarFile

الخاصية TarFile.pax_headers

قاموس يحتوي على أزواج مفتاح-قيمة لترويسات pax العامة.

توابع الصنف TarFile

التابع TarFile.open()‎

يعدّ تابع الصنف هذا بمثابة دالة بانية لكائنات TarFile.

التابع TarFile.getmember()‎

يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى.

التابع TarFile.getmembers()‎

يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo

التابع TarFile.getnames()‎

يعيد التابع قائمة بأسماء الأعضاء في الأرشيف

التابع TarFile.list()‎

يطبع التابع جدولًا بمحتويات كائن TarFile إلى sys.stdout.

التابع TarFile.next()‎

يعيد التابع العضو التالي في الأرشيف على هيئة كائن TarInfo وذلك عند فتح كائن TarFile للقراءة.

التابع TarFile.extractall()‎

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

التابع TarFile.extract()‎

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

التابع TarFile.extractfile()‎

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

التابع TarFile.add()‎

يضيف التابع الملف المعطى إلى ملف الأرشيف.

التابع TarFile.addfile()‎

يضيف التابع كائن TarInfo المعطى إلى ملف الأرشيف.

التابع TarFile.gettarinfo()‎

ينشئ التابع كائن TarInfo من نتيجة استدعاء الدالة os.stat()‎ أو ما يكافئها على ملف موجود فعلًا.

التابع TarFile.close()‎

يغلق التابع كائن TarFile.

انظر أيضًا

  • كائنات TarInfo: يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف.

مصادر

صفحة Read and write tar archive files في توثيق بايثون الرسمي.

مجلوبة من «https://wiki.hsoub.com/index.php?title=Python/TarFile&oldid=23615»