الصنف 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 في توثيق بايثون الرسمي.