Handler for currently used target paths or sources of targets with a desired name.
The methods of this class are shared among all of its instances.
Add a path to the list of currently accessible paths if it wasn’t already added.
Parameters: directory (str) – path to add
Remove a path from the list of currently accessible paths.
Parameters: directory (str) – path to add Returns: whether the removal succeeded Return type: bool
Clear all currently accessible paths.
search(filename, restriction='', silent=False)¶
Search for a filename in the currently accessible paths.
- filename (str) – filename of the target to search for
- restriction (str) – simple string to restrict the number of paths
- silent (bool) – whether to return None instead of error out
the full name of the found target file or None if silent and no file was found
str or None
FileNotFoundErrorif no such file was found and not silent
Class to be used to search for files inside certain paths.
Inside the context of an instance of this class, the paths in the shared list in
FileResolverwill be temporarily replaced by the paths passed to the constructor of this class. This means that any call to
FileResolver.search()will take only these paths into account.
Create the class with the paths that the search will be restricted to.
Parameters: paths – list of paths that the search will use
Start this context.
Returns: instance of the file resolver that can be used to search files Return type: py:class:FileResolver
The paths used by the py:class:FileResolver class will be replaced by the paths used to initialize this class during the duration of this context.
Exit this context and restore the original paths.
Parameters: args – default args passed when exiting context