Struct Config 

pub struct Config {
    pub addr: SocketAddr,
    pub database_url: String,
    pub agents: String,
    pub max_batch_days: usize,
    pub max_body_bytes: usize,
    pub admin: String,
    pub admin_email: String,
    pub secure_cookies: bool,
    pub demo: bool,
}

Runtime configuration, read from the environment.

Fields

addr: SocketAddr

Address the HTTP server binds to (KASL_SERVER_ADDR).

database_url: String

PostgreSQL connection string (DATABASE_URL).

agents: String

Agents to provision on startup (KASL_AGENTS), as email:token pairs. The bootstrap way in until the admin UI issues tokens.

max_batch_days: usize

Days one batch upload may carry (KASL_MAX_BATCH_DAYS).

max_body_bytes: usize

Largest request body accepted (KASL_MAX_BODY_BYTES).

admin: String

Bootstrap administrator (KASL_ADMIN), as email:password.

admin_email: String

Email for the administrator generated on a first run (KASL_ADMIN_EMAIL).

Only used when KASL_ADMIN is unset and the installation has no administrator at all: the server makes one with a random password and prints it once. The default is deliberately obvious rather than clever - an operator who never sets this should still recognize the account.

secure_cookies: bool

Whether session cookies carry Secure (KASL_SECURE_COOKIES).

On by default, because a server holding a team’s hours belongs behind TLS. Turned off only for a stand reached over plain http, where a Secure cookie is dropped by the browser and login silently does nothing at all.

demo: bool

Whether to seed a fictional team on an empty database (KASL_DEMO).

Off by default. On, the server fills an empty database with the demo team and refuses to start on one that holds anybody real (ADR 0013).

Implementations

impl Config

pub fn from_env() -> Result<Self>

pub fn defaults_for_database(database_url: String) -> Self

A configuration with every limit at its default. Used where the limits are not the subject - the router built for tests, for instance - so the defaults live in one place rather than being restated.

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.