findfiles_up
Prototype: findfiles_up(path, glob, level)
Return type: data
Description: Return a data array of files that match a given glob pattern by searching up the directory tree.
This function searches for files matching a given glob pattern glob
in the
local filesystem by searching up the directory tree from a given absolute
path path
. The function searches at moast level
levels of directories or
until the root directory is reached. Argument level
defaults to inf
if
not specified. The function returnes a list of files as a data array where
the first element (element 0) and the last element (element N) is first
and last file or directory found respectivly.
Note that glob patterns are not regular expressions. They match like Unix shells:
*
matches any filename or directory?
matches a single letter[a-z]
matches any letter froma
toz
Notes:
- Brace expansion is not currently supported,
{x,y,anything}
will not matchx
ory
oranything
.
Arguments:
path
:string
, in the range:"?(/.*)
glob
:string
, in the range:.+
level
:int
, in the range:0,99999999999
Example:
bundle agent __main__
{
vars:
"path" # path to search up from
string => "/tmp/repo/submodule/some/place/deep/within/my/repo/";
"glob" # glob pattern matching filename
string => ".git/config";
"level" # how far to search
int => "inf";
"configs"
data => findfiles_up("$(path)", "$(glob)", "$(level)");
reports:
"Submodules '$(glob)' is located in '$(configs[0])'";
"Parents '$(glob)' is located in '$(configs[1])'";
}
Output:
R: Submodules '.git/config' is located in '/tmp/repo/submodule/.git/config'
R: Parents '.git/config' is located in '/tmp/repo/.git/config'
History: Introduced in 3.18.
See also: findfiles()
.