rbtools.utils.filesystem¶

Utilities for working with files.

Functions

rbtools.utils.filesystem.chdir(path: str) → Generator[None, None, None][source]¶

Change to the specified directory for the duration of the context.

Added in version 4.0.

Parameters:

path (str) – The path to change to.

Context:

Operations will run within the specified directory.

Raises:

FileNotFoundError – The provided path does not exist.

rbtools.utils.filesystem.cleanup_tempfiles() → None[source]¶

Clean up temporary files which have been created.

rbtools.utils.filesystem.get_home_path() → str[source]¶

Return the path to the home directory.

Returns:

The user’s home directory (or general place to store application data).

Return type:

str

rbtools.utils.filesystem.is_exe_in_path(name: str) → bool[source]¶

Return whether an executable is in the user’s search path.

This expects a name without any system-specific executable extension. It will append the proper extension as necessary. For example, use “myapp” and not “myapp.exe”.

The result will be cached. Future lookups for the same executable will return the same value.

Changed in version 3.0: The result is now cached.

Parameters:

name (str) – The name of the executable.

Returns:

True if the executable is in the path. False if it is not.

Return type:

bool

rbtools.utils.filesystem.iter_exes_in_path(name: str) → Iterable[str][source]¶

Iterate through all executables with a name in the user’s search path.

This expects a name without any system-specific executable extension. It will append the proper extension as necessary. For example, use “myapp” and not “myapp.exe” or “myapp.cmd”. This will look for both variations.

Changed in version 4.0.1: On Windows, if not searching for a deliberate .exe or .cmd extension, this will now look for variations with both extensions.

Added in version 4.0.

Parameters:

name (str) – The name of the executable.

Yields:

str – The location of an executable in the path.

rbtools.utils.filesystem.make_empty_files(files: Sequence[str]) → None[source]¶

Create each file in the given list and any intermediate directories.

Parameters:

files (list of str) – The list of filenames to create.

rbtools.utils.filesystem.make_tempdir(parent: str | None = None, track: bool = True) → str[source]¶

Create a temporary directory and return the path.

By default, the path will be stored in a list for cleanup when calling cleanup_tempfiles().

Changed in version 3.0: Added track.

Parameters:

• parent (str, optional) – An optional parent directory to create the path in.

• track (bool, optional) –

  Whether to track the directory for later cleanup.

  Added in version 3.0.

Returns:

The name of the new temporary directory.

Return type:

str

rbtools.utils.filesystem.make_tempfile(*, content: bytes | None = None, prefix: str = 'rbtools.', suffix: str | None = None, filename: str | None = None) → str[source]¶

Create a temporary file and return the path.

If not manually removed, then the resulting temp file will be removed when RBTools exits (or if cleanup_tempfiles() is called).

This can be given an explicit name for a temporary file, in which case the file will be created inside of a temporary directory (created with make_tempdir(). In this case, the parent directory will only be deleted when cleanup_tempfiles() is called.

Parameters:

• content (bytes, optional) – The content for the text file.

• prefix (str, optional) – The prefix for the temp filename. This defaults to rbtools..

• suffix (str, optional) – The suffix for the temp filename.

• filename (str, optional) – An explicit name of the file. If provided, this will override suffix and prefix.

Returns:

The temp file path.

Return type:

str

rbtools.utils.filesystem.walk_parents(path: str) → Iterable[str][source]¶

Walk up the tree to the root directory.

Yields:

str – Each directory name while walking up to the root.