7.19.2 Oggetti TarInfo

Un oggetto TarInfo rappresenta un membro in un TarFile. Oltre ad immagazzinare tutti gli attributi richiesti di un file (come tipo, dimensione, orario, permessi, proprietario ecc. ecc.), fornisce alcuni metodi utili per determinarne il tipo. Non contiene i dati del file.

Gli oggetti TarInfo vengono restituiti dai metodi getmember(), getmembers() e gettarinfo() di TarFile.

class TarInfo( [name])
Crea un oggetto TarInfo.

frombuf( )
Crea e restituisce un oggetto TarInfo da un buffer di stringa.

tobuf( )
Crea un buffer stringa da un oggetto TarInfo.

Un oggetto TarInfo possiede i seguenti attributi pubblici:

name
Nome del membro dell'archivio.

size
Dimensione in byte.

mtime
Orario dell'ultima modifica.

mode
Bit di permesso.

type
Tipo del file. type solitamente è una di queste costanti: REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE. Per determinare il tipo di un oggetto TarInfo in modo più conveniente, usare i metodi is_*() qui sotto.

linkname
Nome del file obiettivo, che è presente solo negli oggetti TarInfo del tipo LNKTYPE e SYMTYPE.

uid
ID dell'utente che in origine immagazzinò questo membro.

gid
ID del gruppo dell'utente che in origine immagazzinò questo membro.

uname
Nome dell'utente.

gname
Nome del gruppo.

Un oggetto TarInfo fornisce inoltre alcuni utili metodi informativi:

isfile( )
Restituisce True se l'oggetto Tarinfo è un file regolare.

isreg( )
Uguale a isfile().

isdir( )
Restituisce True se è una directory.

issym( )
Restituisce True se è un collegamento simbolico.

islnk( )
Restituisce True se è un collegamento hard.

ischr( )
Restituisce True se è un dispositivo a caratteri.

isblk( )
Restituisce True se è un dispositivo a blocchi.

isfifo( )
Restituisce True se è una FIFO.

isdev( )
Restituisce True se è un dispositivo a caratteri, a blocchi o una FIFO.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.