assets_guardian.core.domain.models.location

Classes

Location(raw_path)	Representation and validation of a file location (local or remote).
PathType(*values)

class assets_guardian.core.domain.models.location.Location(raw_path: str)

Bases: object

Representation and validation of a file location (local or remote).

This class parses a prefixed path (e.g., ‘local:./outputs/file.xlsx’), identifies its type, and validates its existence.

Variables:

• raw_path (str) – The original raw path with prefix (e.g., local:./outputs).

• path_type (assets_guardian.core.domain.models.location.PathType) – The path type (LOCAL, REMOTE).

• clean_path (str) – The path without the prefix.

Initializes a new Location instance.

Parameters:

raw_path – The prefixed path (e.g., ‘local:./outputs/file.xlsx’).

validate_location(is_folder: bool = False, require_exists: bool = False) → None

Validates the consistency of the path.

Parameters:

• is_folder – If True, asserts that the path points to a directory.

• require_exists – If True, physical existence of the path is required.

Raises:

• NotImplementedError – If the prefix is ‘remote’ (unsupported currently).

• ValueError – If the prefix is missing or invalid.

• NotADirectoryError – If is_folder is True but the path is not a directory.

• FileNotFoundError – If require_exists is True but the path is not found.

class assets_guardian.core.domain.models.location.PathType(*values)

Bases: StrEnum