الصنف TarInfo()‎‎ في بايثون

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

تعيد التوابع getmember()‎ و getmembers()‎ و gettarinfo()‎ كائنات TarInfo.

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

الدالة البانية للصنف TarInfo:

class tarfile.TarInfo(name="")

خصائص كائنات TarInfo

يمتلك كائن TarInfo الخصائص العامة التالية:

TarInfo.name

اسم عضو الأرشيف.

TarInfo.size

الحجم بالبايتات.

TarInfo.mtime

وقت آخر تعديل.

TarInfo.mode

أذونات الملف.

TarInfo.type

نوع الملف، والذي يكون عادة واحدًا من الثوابت التالية: REGTYPE، AREGTYPE، LNKTYPE، SYMTYPE، DIRTYPE، FIFOTYPE، CONTTYPE، CHRTYPE، BLKTYPE، GNUTYPE_SPARSE. لتحديد نوع كائن TarInfo بطريقة أفضل استخدم توابع is*()‎.

TarInfo.linkname

اسم الملف المستهدف، والذي يكون موجودًا فقط في كائنات TarInfo من نوع LNKTYPE و SYMTYPE.

TarInfo.uid

المعرّف الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف.

TarInfo.gid

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

TarInfo.uname

اسم المستخدم.

TarInfo.gname

اسم المجموعة.

TarInfo.pax_headers

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

توابع كائنات TarInfo

تابع الصنف TarInfo.frombuf()‎

تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة.

تابع الصنف TarInfo.fromtarfile()‎

تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo.

التابع TarInfo.tobuf()‎

ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo.

توابع الاستعلام

يقدّم كائن TarInfo كذلك التوابع التالية التي تسهّل إجراء الاستعلامات:

التابع TarInfo.isfile()‎

يعيد التابع القيمة True إن كان كائن TarInfo ملفًّا عاديًا.

التابع TarInfo.isreg()‎

هذا التابع مشابه في عمله للتابع isfile()‎.

التابع TarInfo.isdir()‎

يعيد التابع القيمة True إن كان كائن TarInfo مجلّدًا.

التابع TarInfo.issym()‎

يعيد التابع القيمة True إن كان كائن TarInfo وصلة رمزية symbolic link.

التابع TarInfo.islnk()‎

يعيد التابع القيمة True إن كان كائن TarInfo وصلة صلبة hard link.

التابع TarInfo.ischr()‎

يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف character device.

التابع TarInfo.isblk()‎

يعيد التابع القيمة True إن كان كائن TarInfo أداة كتلة block device.

التابع TarInfo.isfifo()‎

يعيد التابع القيمة True إن كان كائن TarInfo من نوع FIFO.

التابع TarInfo.isdev()‎

يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف أو أداة كتلة أو من نوع FIFO.

انظر أيضًا

الكائن TarFile: وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها.

مصادر

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