Parameter |
Choices/Defaults |
Comments |
age
|
|
Select files whose age is equal to or greater than the specified time. Use a negative age to find files equal to or less than the specified time. You can choose seconds, minutes, hours, days, or weeks by specifying the first letter of any of those words (e.g., "1w").
|
age_stamp
|
Choices:
- atime
- ctime
mtime ←
|
Choose the file property against which we compare age.
|
contains
|
|
One or more regex patterns which should be matched against the file content.
|
depth
(added in 2.6) |
|
Set the maximum number of levels to decend into. Setting recurse to false will override this value, which is effectively depth 1. Default is unlimited depth.
|
excludes
(added in 2.5) |
|
One or more (shell or regex) patterns, which type is controlled by use_regex option.
Items matching an excludes pattern are culled from patterns matches. Multiple patterns can be specified using a list.
aliases: exclude
|
file_type
|
Choices:
- any
- directory
file ←
- link
|
Type of file to select.
The 'link' and 'any' choices were added in version 2.3.
|
follow
bool |
|
Set this to true to follow symlinks in path for systems with python 2.6+.
|
get_checksum
bool |
|
Set this to true to retrieve a file's sha1 checksum.
|
hidden
bool |
|
Set this to true to include hidden files, otherwise they'll be ignored.
|
paths
required |
|
List of paths of directories to search. All paths must be fully qualified.
aliases: name, path
|
patterns
|
Default:
*
|
One or more (shell or regex) patterns, which type is controlled by use_regex option.
The patterns restrict the list of files to be returned to those whose basenames match at least one of the patterns specified. Multiple patterns can be specified using a list.
aliases: pattern
|
recurse
bool |
|
If target is a directory, recursively descend into the directory looking for files.
|
size
|
|
Select files whose size is equal to or greater than the specified size. Use a negative size to find files equal to or less than the specified size. Unqualified values are in bytes but b, k, m, g, and t can be appended to specify bytes, kilobytes, megabytes, gigabytes, and terabytes, respectively. Size is not evaluated for directories.
|
use_regex
bool |
|
If false, the patterns are file globs (shell). If true, they are python regexes.
|