12.5.2 TarInfo Objects

A TarInfo object represents one member in a
TarFile. Aside from storing all required attributes of a file
(like file type, size, time, permissions, owner etc.), it provides
some useful methods to determine its type. It does not contain
the file's data itself.

TarInfo objects are returned by TarFile's methods
getmember(), getmembers() and gettarinfo().

classTarInfo(

[name])

Create a TarInfo object.

frombuf(

)

Create and return a TarInfo object from a string buffer.

tobuf(

posix)

Create a string buffer from a TarInfo object.
See TarFile's posix attribute for information
on the posix argument. It defaults to False.

New in version 2.5:
The posix parameter.

A TarInfo object has the following public data attributes:

name

Name of the archive member.

size

Size in bytes.

mtime

Time of last modification.

mode

Permission bits.

type

File type. type is usually one of these constants:
REGTYPE, AREGTYPE, LNKTYPE,
SYMTYPE, DIRTYPE, FIFOTYPE,
CONTTYPE, CHRTYPE, BLKTYPE,
GNUTYPE_SPARSE. To determine the type of a
TarInfo object more conveniently, use the is_*()
methods below.

linkname

Name of the target file name, which is only present in
TarInfo objects of type LNKTYPE and
SYMTYPE.