Struct Config 

pub struct Config {
    pub listen: String,
    pub data_dir: PathBuf,
    pub api_token_env: String,
    pub output_dir: Option<PathBuf>,
    pub smtp: Option<SmtpConfig>,
    pub data_hosts: Vec<DataHost>,
    pub max_concurrent_renders: usize,
    pub retry_delay_seconds: u64,
    pub misfire_grace_minutes: u64,
    pub history_limit: usize,
    pub max_body_megabytes: usize,
}

The server’s configuration, read from a JSON file.

Fields

listen: String

Address and port to listen on; the loopback interface by default.

data_dir: PathBuf

Where layouts, jobs, history and documents are kept.

api_token_env: String

The environment variable holding the API token.

output_dir: Option<PathBuf>

The folder under which folder deliveries write; such deliveries are refused without it.

smtp: Option<SmtpConfig>

The mail server; email deliveries are refused without it.

data_hosts: Vec<DataHost>

The hosts url data sources may read from. Any other host is refused.

max_concurrent_renders: usize

How many reports render at the same time.

retry_delay_seconds: u64

The wait before the first retry of a failed run; it doubles on each retry.

misfire_grace_minutes: u64

A run this late (the server was down) still happens; a later one is recorded as missed.

history_limit: usize

How many runs of each job the history keeps.

max_body_megabytes: usize

The largest request body accepted, in megabytes.

Implementations

impl Config

pub fn new(data_dir: impl Into<PathBuf>) -> Self

A configuration with every default, keeping its data in data_dir.

pub fn load(path: &Path) -> Result<Self, String>

Reads the configuration from a JSON file.

pub fn api_token(&self) -> Result<String, String>

The API token, from the environment. There is no way to run without one.

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.