`nexuml.core.log_paths`¶

nexuml.core.log_paths ¶

Utilities for resolving log and artifact output paths.

resolve_logs_root(
    path: str | Path, *, env_var: str = LOGS_ROOT_ENV
) -> Path

Prefix relative log paths with NEXUML_LOGS_ROOT when configured.

Returns:

Type	Description
`Path`	Resolved absolute or relative path.

resolve_logs_root_str(
    path: str | Path, *, env_var: str = LOGS_ROOT_ENV
) -> str

Return the logs root path resolved to a string.

resolve_logs_file_uri(
    uri: str, *, env_var: str = LOGS_ROOT_ENV
) -> str

Resolve relative file URIs under logs root; preserve absolute/remote URIs.

Returns:

Type	Description
`str`	Resolved `file://` URI with absolute path, or the original uri
`str`	unchanged if it is absolute or remote.