Module config 

Provides the config module.

Examples

use pharos_runtime_core::config;

Related

• crate for sibling modules in the same crate.

Structs

AppLocalConfig

Resolved app-local config values loaded from app.conf.

AppRuntime

Fully resolved runtime configuration for one mounted app.

ResourceBudgets

Runtime resource ceilings applied to responses, queries, jobs, and integrations.

ServeConfig

Parsed top-level runtime launch configuration.

Constants

MODULE_STATUS

Implementation status marker for the shared config module.

Functions

app_artifact_dir_from_build_dir

Performs app artifact dir from build dir.

app_base_path_local

Performs app base path local.

app_build_dir_local

Performs app build dir local.

app_error_report_path_local

Performs app error report path local.

app_local_conf_path

Returns the app.conf path for an app when the file exists.

app_local_conf_value

Performs app local conf value.

app_log_format_local

Performs app log format local.

app_log_level_explicit

Performs app log level explicit.

app_log_level_local

Performs app log level local.

app_log_path_local

Performs app log path local.

app_media_root

Resolves configured app media storage, retaining bundled storage for legacy apps. Configured paths must be absolute after config-relative resolution and cannot traverse parents.

app_state_path_local

Performs app state path local.

application_effects_within_budget 🔒

Rejects compiled actions whose declared effect set exceeds the configured work budget.

apply_serve_config_defaults_from_conf

Performs apply serve config defaults from conf.

canonicalize_or_original 🔒

Performs canonicalize or original.

clone_app

Clones one resolved runtime configuration.

conf_lookup_value_in_text 🔒

Performs conf lookup value in text.

current_working_directory 🔒

Performs current working directory.

duplicate_config_field

Performs duplicate config field.

dynamic_config_effective_value

Performs dynamic config effective value.

dynamic_config_key_is_path

Performs dynamic config key is path.

dynamic_config_lookup_raw

Performs dynamic config lookup raw.

dynamic_config_resolve_value

Performs dynamic config resolve value.

dynamic_config_value_is_set

Performs dynamic config value is set.

effective_app_artifact_dir

Performs effective app artifact dir.

effective_app_base_path

Performs effective app base path.

effective_app_build_dir

Performs effective app build dir.

effective_app_error_report_path

Performs effective app error report path.

effective_app_log_format

Performs effective app log format.

effective_app_log_level

Performs effective app log level.

effective_app_log_path

Performs effective app log path.

effective_app_state_path

Performs effective app state path.

finalize_base_path 🔒

Performs finalize base path.

finalize_error_report_path 🔒

Performs finalize error report path.

finalize_loaded_app

Performs finalize loaded app.

finalize_log_format 🔒

Performs finalize log format.

finalize_log_level 🔒

Performs finalize log level.

finalize_log_path 🔒

Performs finalize log path.

finalize_queue_enabled 🔒

Performs finalize queue enabled.

finalize_queue_long_field 🔒

Performs finalize queue long field.

finalize_resource_budgets 🔒

Resolves the complete first-class resource budget contract.

finalize_runtime_conf_path 🔒

Performs finalize runtime conf path.

finalize_state_path 🔒

Performs finalize state path.

finalize_trusted_proxy_cidrs 🔒

Performs finalize trusted proxy cidrs.

find_app_root_for_target

Finds an app root by checking the explicit app directory, repository root, and binary-relative app directories.

free_app_local_config

Clears an app-local configuration value without retaining owned strings.

free_serve_config

Clears an owned serve configuration in the same way as dropping a parsed value.

has_cli_override_value 🔒

Returns whether cli override value.

has_override_value 🔒

Returns whether override value.

has_runtime_default_value 🔒

Returns whether runtime default value.

load_app_local_config

Loads app local config.

load_manifest_value 🔒

Loads manifest value.

manifest_app_id 🔒

Performs manifest app ID.

manifest_has_required_fields 🔒

Performs manifest has required fields.

match_app_root_in_directory

Finds an app root in one directory tree by matching app_id from the manifest.

normalize_base_path

Normalizes base path.

normalize_build_dir_value 🔒

Normalizes build dir value.

normalized_build_dir_path 🔒

Performs normalized build dir path.

parse_config_bool 🔒

Parses config boolean flag.

parse_json_text 🔒

Parses JSON text.

parse_positive_i64 🔒

Parses positive i64.

parse_queue_enabled 🔒

Parses queue enabled.

parse_serve_config

Parses serve config.

parse_yaml_text 🔒

Parses YAML text.

path_dirname 🔒

Performs path dirname.

path_exists 🔒

Performs path exists.

path_last_segment_is_apps 🔒

Performs path last segment is apps.

path_last_segment_is_apps_runtime_local

Tests whether the final path component is the protected runtime directory.

read_file_text 🔒

Reads file text.

resolve_conf_relative_path

Resolves a config value relative to the config file that declared it.

resolve_conf_value_key 🔒

Resolves conf value key.

resolve_relative_artifact_dir 🔒

Resolves relative artifact dir.

resolve_relative_artifact_dir_runtime_local

Resolves an artifact directory relative to a build directory while preserving dist/apps.

resolve_relative_to 🔒

Resolves relative to.

resolved_runtime_conf_path_from_config

Performs resolved runtime conf path from config.

resource_limit 🔒

Loads one bounded positive resource limit from app or runtime configuration.

skip_leading_apps_segment 🔒

Performs skip leading apps segment.

skip_leading_apps_segment_runtime_local

Skips a leading apps path component without allowing traversal.

skip_leading_build_dir_segment 🔒

Performs skip leading build dir segment.

state_sections_within_budget 🔒

Rejects an existing state document containing an unbounded top-level collection.

string_from_json_value 🔒

Performs string from JSON value.