[Python-checkins] python/dist/src/Doc/lib libglob.tex,1.13,1.14

jlgijsbers at users.sourceforge.net jlgijsbers at users.sourceforge.net
Sat Jan 8 14:13:47 CET 2005

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8739/Doc/lib

Modified Files:
Log Message:
Patch #943206:

`glob.glob()` currently calls itself recursively to build a list of matches of
the dirname part of the pattern and then filters by the basename part. This is
effectively BFS. ``glob.glob('*/*/*/*/*/foo')`` will build a huge list of all
directories 5 levels deep even if only a handful of them contain a ``foo``
entry. A generator-based recusion would never have to store these list at once
by implementing DFS. This patch converts the `glob` function to an `iglob`
recursive generator . `glob()` now just returns ``list(iglob(pattern))``.

I also cleaned up the code a bit (reduced duplicate `has_magic()` checks and
created a second `glob0` helper func so that the main loop need not be

Thanks to Cherniavsky Beni for the patch!

Index: libglob.tex
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libglob.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- libglob.tex	30 Aug 2004 10:19:53 -0000	1.13
+++ libglob.tex	8 Jan 2005 13:13:14 -0000	1.14
@@ -16,7 +16,7 @@
 \index{filenames!pathname expansion}
-Returns a possibly-empty list of path names that match \var{pathname},
+Return a possibly-empty list of path names that match \var{pathname},
 which must be a string containing a path specification.
 \var{pathname} can be either absolute (like
 \file{/usr/src/Python-1.5/Makefile}) or relative (like
@@ -24,6 +24,12 @@
 Broken symlinks are included in the results (as in the shell).
+Return an iterator which yields the same values as \function{glob()}
+without actually storing them all simultaneously.
 For example, consider a directory containing only the following files:
 \file{1.gif}, \file{2.txt}, and \file{card.gif}.  \function{glob()}
 will produce the following results.  Notice how any leading components

More information about the Python-checkins mailing list