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,
    pub webhooks: Webhooks,
}

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).

webhooks: Webhooks

Where events are sent (KASL_WEBHOOK_<NAME>, one variable each), and the address messages link back to (KASL_PUBLIC_URL). Read from the environment and never from the database: a hook is a credential (ADR 0019).

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) -> Self

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.