Module config 

Layered configuration.

Precedence (highest wins): CLI flags → env (OSDK_*) → project config (osdk.toml, discovered by walking up) → user global config ($OSDK_CONFIG_DIR/config.toml) → built-in defaults.

This module owns the persisted settings shape. CLI-flag overlay is applied by the caller (osdk-cli) on top of Config::load.

Structs

Config

Fully-resolved settings after merging all layers.

ContainerRegistryConfig

Mirror policy for one upstream OCI registry namespace.

ContainersConfig

Native-only container integration settings. Higher-precedence configuration files replace this section as a unit instead of merging registry policies.

JavaSettings

NodeSettings

NpmRegistryConfig

Candidate registries for npm-compatible package managers. An empty list means to use osdk’s built-in public candidates.

PythonSettings

RegistriesConfig

Registry preflight settings. Package registry URLs are deliberately kept separate from SDK download sources because they affect delegated package manager commands rather than osdk’s own downloads.

Settings

SourcesConfig

StructuredToolConfig

Structured [tools.<tool>] object with a required version plus arbitrary backend-specific options.

ToolSources

Per-tool source config: an optional pin and any user-added custom sources.

Enums

AttestationPolicy

ContainerPlatform

Target platform chosen from the native runtime or an explicit OCI tuple.

ContainerResolve

Whether tags are resolved by the origin registry or by a configured mirror.

ContainerRuntime

Native runtime selected for container inspection and operations.

PrereleasePolicy

ToolConfigEntry

Persisted [tools] entry. Legacy strings remain supported, while structured objects can carry extra backend-specific options.

ToolConfigOrigin

Source layer that contributed an effective tool entry.

ToolConfigValue

Arbitrary structured tool option value.

Constants

PROJECT_CONFIG_NAMES

Functions

expand_alias

normalize_container_mirror_url

Validate and canonicalize a persisted OCI mirror URL. Persisted mirror policy is HTTPS-only and never carries credentials, query, or fragment.

normalize_registry_url

Validate and canonicalize an npm-compatible registry base URL. Credentials, query strings, and fragments are rejected.

parse_duration_secs

Parse a duration like “6h”, “30m”, “90s”, “1d” into seconds.

parse_tool_versions

validate_alias_name