Struct Config 

pub struct Config {
    pub server: ServerSection,
    pub tls: Option<TlsSection>,
}

The fully-resolved application configuration.

Deserializes from a churust.toml file (with a [server] table and an optional [tls] table) and can be overlaid with CHURUST_* environment variables via apply_env. Apply it to a builder with AppBuilder::with_config, or use Churust::from_config to load and apply the defaults in one step. Unspecified fields fall back to sane defaults.

use churust_core::Config;

let cfg: Config = toml::from_str(r#"
    [server]
    host = "0.0.0.0"
    port = 9090
"#).unwrap();
assert_eq!(cfg.server.host, "0.0.0.0");
assert_eq!(cfg.server.port, 9090);
// unspecified fields keep their defaults
assert_eq!(cfg.server.max_body_bytes, 1 << 20);
assert!(cfg.tls.is_none());

Fields

server: ServerSection

Server-level settings ([server] table).

tls: Option<TlsSection>

Optional TLS settings ([tls] table); None serves plaintext HTTP.

Implementations

impl Config

pub fn load(path: &str) -> Self

Load configuration by layering, in increasing precedence: built-in defaults, then the TOML file at path (if it exists and parses), then CHURUST_* environment variables.

A missing or unparseable file is treated as “use defaults” rather than an error, so calling this without a config file present is safe.

use churust_core::Config;
// Reads ./my-app.toml if present, then applies CHURUST_* env overrides.
let cfg = Config::load("my-app.toml");
let _ = cfg.server.port;

pub fn load_default() -> Self

Load configuration from the conventional churust.toml path (plus CHURUST_* env overrides). A shorthand for Config::load("churust.toml"); this is what Churust::from_config uses.

use churust_core::Config;
let cfg = Config::load_default();
let _ = cfg.server.host;

pub fn apply_env(&mut self, get: impl Fn(&str) -> Option<String>)

Overlay CHURUST_* environment variables onto this config, using the provided get lookup so the source can be injected in tests.

Recognized keys: CHURUST_SERVER_HOST, CHURUST_SERVER_PORT, CHURUST_SERVER_MAX_BODY_BYTES, CHURUST_SERVER_REQUEST_TIMEOUT_MS. Values that fail to parse (e.g. a non-numeric port) are ignored, leaving the existing value in place.

use churust_core::Config;
use std::collections::HashMap;

let env: HashMap<&str, &str> = [("CHURUST_SERVER_PORT", "7000")].into_iter().collect();
let mut cfg = Config::default();
cfg.apply_env(|k| env.get(k).map(|s| s.to_string()));
assert_eq!(cfg.server.port, 7000);

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 Default for Config

fn default() -> Config

Returns the “default value” for a type.

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

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.