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.