| | |
- FileList
class FileList |
| |
A list of files built by on exploring the filesystem and filtered by
applying various patterns to what we find there.
Instance attributes:
dir
directory from which files will be taken -- only used if
'allfiles' not supplied to constructor
files
list of filenames currently being built/filtered/manipulated
allfiles
complete list of files under consideration (ie. without any
filtering applied)
|
| |
Methods defined here:
- _FileList__debug_print = __debug_print(self, msg)
- Print 'msg' to stdout if the global DEBUG (taken from the
DISTUTILS_DEBUG environment variable) flag is true.
- _FileList__warn = __warn(self, msg)
- __init__(self, warn=None, debug_print=None)
- _parse_template_line(self, line)
- append(self, item)
- exclude_pattern(self, pattern, anchor=1, prefix=None, is_regex=0)
- Remove strings (presumably filenames) from 'files' that match
'pattern'. Other parameters are the same as for
'include_pattern()', above.
The list 'self.files' is modified in place.
Return 1 if files are found.
- extend(self, items)
- findall(self, dir='.')
- include_pattern(self, pattern, anchor=1, prefix=None, is_regex=0)
- Select strings (presumably filenames) from 'self.files' that
match 'pattern', a Unix-style wildcard (glob) pattern. Patterns
are not quite the same as implemented by the 'fnmatch' module: '*'
and '?' match non-special characters, where "special" is platform-
dependent: slash on Unix; colon, slash, and backslash on
DOS/Windows; and colon on Mac OS.
If 'anchor' is true (the default), then the pattern match is more
stringent: "*.py" will match "foo.py" but not "foo/bar.py". If
'anchor' is false, both of these will match.
If 'prefix' is supplied, then only filenames starting with 'prefix'
(itself a pattern) and ending with 'pattern', with anything in between
them, will match. 'anchor' is ignored in this case.
If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and
'pattern' is assumed to be either a string containing a regex or a
regex object -- no translation is done, the regex is just compiled
and used as-is.
Selected strings will be added to self.files.
Return 1 if files are found.
- process_template_line(self, line)
- remove_duplicates(self)
- set_allfiles(self, allfiles)
- sort(self)
Data and non-method functions defined here:
- __doc__ = 'A list of files built by on exploring the files...e. without any\n filtering applied)\n '
- __module__ = 'distutils.filelist'
| |