Struct Config 

pub struct Config {
    pub admin: AdminConfig,
    pub body_limits: BodyLimitsConfig,
    pub clusters: Vec<Cluster>,
    pub filter_chains: Vec<FilterChainConfig>,
    pub insecure_options: InsecureOptions,
    pub listeners: Vec<Listener>,
    pub runtime: RuntimeConfig,
    pub shutdown_timeout_secs: u64,
}

Top-level proxy configuration.

use praxis_core::config::Config;

let config = Config::from_yaml(
    r#"
listeners:
  - name: web
    address: "127.0.0.1:8080"
    filter_chains: [main]
filter_chains:
  - name: main
    filters:
      - filter: static_response
        status: 200
"#,
)
.unwrap();
assert_eq!(config.listeners[0].address, "127.0.0.1:8080");

Fields

admin: AdminConfig

Admin endpoint settings (address and verbosity).

body_limits: BodyLimitsConfig

Global hard ceilings on request and response body size.

clusters: Vec<Cluster>

Cluster definitions referenced by filters.

filter_chains: Vec<FilterChainConfig>

Named filter chains.

insecure_options: InsecureOptions

Consolidated security overrides. All default to false.

listeners: Vec<Listener>

Proxy listeners to bind.

runtime: RuntimeConfig

Runtime configuration knobs.

shutdown_timeout_secs: u64

Drain time for graceful shutdown.

Implementations

impl Config

pub fn validate(&mut self) -> Result<(), ProxyError>

Validate config constraints.

Errors

Returns ProxyError::Config if any constraint is violated.

use praxis_core::config::Config;

let err = Config::from_yaml("listeners: []\n").unwrap_err();
assert!(err.to_string().contains("at least one listener"));

impl Config

pub fn from_yaml(s: &str) -> Result<Self, ProxyError>

Parse config from a YAML string.

Errors

Returns ProxyError::Config if the YAML is invalid, oversized, or fails validation.

Security: Error Messages

Parse errors from serde_yaml may include context snippets from the input YAML. This is acceptable for server-side operator tooling but callers should avoid exposing these errors to untrusted end users.

use praxis_core::config::Config;

let cfg = Config::from_yaml(
    r#"
listeners:
  - name: web
    address: "127.0.0.1:8080"
    filter_chains: [main]
filter_chains:
  - name: main
    filters:
      - filter: static_response
        status: 200
"#,
)
.unwrap();
assert_eq!(cfg.listeners[0].address, "127.0.0.1:8080");

pub fn from_file(path: &Path) -> Result<Self, ProxyError>

Load and validate config from a YAML file.

Errors

Returns ProxyError::Config if the file cannot be read or contains invalid config.

use std::path::Path;

use praxis_core::config::Config;

let cfg = Config::from_file(Path::new("praxis.yaml")).unwrap();
println!("listeners: {}", cfg.listeners.len());

pub fn load( explicit_path: Option<&str>, fallback_yaml: &str, ) -> Result<Self, ProxyError>

Resolve configuration file. Fall back to praxis.yaml in the working directory, then fallback_yaml.

Errors

Returns ProxyError::Config if the resolved config source cannot be loaded or is invalid.

use praxis_core::config::Config;

let yaml = "listeners: [{name: w, address: '0:80'}]";
let cfg = Config::load(None, yaml).unwrap();

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.