pathext 1.0

A collection of functions working with `pathlib.Path`

pathext

pathext is a collection of functions working with pathlib.Path. They're often wrappers for standard library functionality with some extensions.

Executable lookup

pathext.which()

Wrapper for shutil.which() which returns the result as an absolute Path (or None if it fails to find the executable). It also has a couple extra features, see below.

Arguments (all of them except name are optional):

• name: str - Executable name to look up.
• path: None | str | Sequence[Path] - Directory list to look up name in. If set to None, or set to a string, then it is passed to shutil.which() as-is. If set to a list, concatenates the list items using os.pathsep, and passes the result to shutil.which(). Defaults to None. See shutil.which()'s documentation on exact behaviour of this argument.
• cwd: Optional[Path] - If specified, then changes the current working directory to cwd for the duration of the shutil.which() call. Note that since it is changing global state (the current working directory), it is inherently not thread-safe.

pathext.checked_which()

Same as pathext.which(), except it raises ValueError instead of returning None if it cannot find the executable.

Generic utilities

pathext.to_path()

Simple function that converts a str to a Path (just like Path's constructor), but also handles None by returning None. It can be used to convert the return value of functions that return str | None to Path | None.