Python in a Nutshell

Name

dircmp

Synopsis

class dircmp(dir1,dir2,ignore=('RCS','CVS','tags'),
             hide=('.',’..'))

Creates a new directory-comparison instance object, comparing directories named dir1 and dir2, ignoring names listed in ignore, and hiding names listed in hide. A dircmp instance d exposes three methods:

d .report( )

Outputs to sys.stdout a comparison between dir1 and dir2

d .report_partial_closure( )

Outputs to sys.stdout a comparison between dir1 and dir2 and their common immediate subdirectories

d .report_full_closure( )

Outputs to sys.stdout a comparison between dir1 and dir2 and their common subdirectories, recursively

A dircmp instance d supplies several attributes, computed just in time (i.e., only if and when needed, thanks to a __getattr__ special method) so that using a dircmp instance suffers no unnecessary overhead. d’s attributes are:

d .common

Files and subdirectories that are in both dir1 and dir2

d .common_dirs

Subdirectories that are in both dir1 and dir2

d .common_files

Files that are in both dir1 and dir2

d .common_funny

Names that are in both dir1 and dir2 for which os.stat reports an error or returns different kinds for the versions in the two directories

d .diff_files

Files that are in both dir1 and dir2 but with different contents

d .funny_files

Files that are in both dir1 and dir2 but could not be compared

d .left_list

Files and subdirectories that are in dir1

d .left_only

Files and subdirectories that are in dir1 and not in dir2

d .right_list

Files and subdirectories ...