6.7.1 La classe dircmp

6.7.1 La classe `dircmp`

Le istanze della classe dircmp vengono create usando questo costruttore:

class dircmp( a, b[, ignore[, hide]]): Crea un nuovo oggetto per il confronto di directory, utilizzabile per confrontare le directory a and b. L'argomento ignore è una lista di nomi da ignorare e ha come valore predefinito la lista ['RCS', 'CVS', 'tags']. L'argomento hide è una lista di nomi da nascondere e ha come valore predefinito la lista [os.curdir, os.pardir].

La classe dircmp fornisce i seguenti metodi:

report( ): Stampa (su sys.stdout) il risultato del confronto tra le directory a e b.

report_partial_closure( ): Stampa il risultato del confronto tra le immediate sotto directory comuni alle directory a e b.

report_full_closure( ): Stampa il risultato del confronto tra a and b e le loro sotto directory comuni (ricorsivamente).

La classe dircmp offre un insieme di interessanti attributi che possono venire usati per ottenere informazioni varie sugli alberi di directory che vengono confrontati.

Notate che attraverso le estensioni del metodo __getattr__(), tutti gli attributi vengono calcolati in modo opportuno, in modo tale che non si presenti alcuna penalizzazione di velocità nel caso in cui vengano usati solo quegli attributi calcolabili velocemente.

left_list: Lista dei file e delle sotto directory di a, filtrati attraverso le liste hide e ignore.

right_list: Lista dei file e delle sotto directory di b, filtrati attraverso le liste hide e ignore.

common: Lista dei file e delle sotto directory presenti sia in a che in b.

left_only: Lista dei file e delle sotto directory presenti solo in a.

right_only: Lista dei file e delle sotto directory presenti solo in b.

common_dirs: Lista delle sotto directory sia in a che in b.

common_files: Lista dei file presenti sia in a che in b.

common_funny: Lista di nomi degli elementi comuni ad a e b, tali però da risultare di tipo diverso tra le directory, o aventi nomi per i quali os.stat() restituisce un errore.

same_files: Lista di file identici presenti sia in a che in b.

diff_files: Lista di file presenti sia in a che in b, ma con diverso contenuto.

funny_files: Lista di file presenti sia in a and b ma che non è stato possibile confrontare.

subdirs: Un dizionario che mappa i nomi in common_dirs con altrettante istanze della classe dircmp.

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