cpython: e64d4518b23c (original) (raw)

Mercurial > cpython

changeset 78582:e64d4518b23c 2.7

#15269: document dircmp.left and right. Based on patch by Chris Jerdonek. [#15269]

R David Murray rdmurray@bitdance.com
date	Tue, 14 Aug 2012 21:50:38 -0400
parents	0dbdaa0ff648
children	ad8c9725c041
files	Doc/library/filecmp.rst
diffstat	1 files changed, 25 insertions(+), 0 deletions(-)[+] [-] Doc/library/filecmp.rst 25

line wrap: on

line diff

--- a/Doc/library/filecmp.rst +++ b/Doc/library/filecmp.rst @@ -106,6 +106,16 @@ The :class:dircmp class to compute are used.

.. attribute:: left +
```
 The directory *a*.[](#l1.9)
```

+ +

.. attribute:: right +
```
 The directory *b*.[](#l1.14)
```

+ + .. attribute:: left_list Files and subdirectories in a, filtered by hide and ignore. @@ -168,3 +178,18 @@ The :class:dircmp class A dictionary mapping names in :attr:common_dirs to :class:dircmp objects. + +Here is a simplified example of using the subdirs attribute to search +recursively through two directories to show common different files:: +

from filecmp import dircmp
def print_diff_files(dcmp):
... for name in dcmp.diff_files:
... print "diff_file %s found in %s and %s" % (name, dcmp.left,
... dcmp.right)
... for sub_dcmp in dcmp.subdirs.values():
... print_diff_files(sub_dcmp)
...
dcmp = dircmp('dir1', 'dir2')
print_diff_files(dcmp)