1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! # Settings
//!
//! My IoT is configured with a single YAML file
//! which must contain exactly one [`Settings`](struct.Settings.html) object.
//!
//! ## Example
//!
//! ```yaml
//! http_port: 8080
//! services:
//!   heartbeat_clock:
//!     Clock:
//!       interval_ms: 2000
//!       suffix: heartbeat
//!   database:
//!     Db:
//!       interval_ms: 2000
//!   schiphol_buienradar:
//!     Buienradar:
//!       station_id: 6240
//! ```

use crate::services;
use crate::Result;
use serde::Deserialize;
use std::collections::HashMap;
use std::fs::File;
use std::path::Path;

/// Read the settings file.
pub fn read<P: AsRef<Path>>(path: P) -> Result<Settings> {
    Ok(serde_yaml::from_reader(File::open(path)?)?)
}

/// Represents a root settings object.
#[derive(Deserialize, Debug, Clone)]
pub struct Settings {
    /// Web server port. It's used for the user interface as well as for webhooks.
    #[serde(default = "default_http_port")]
    pub http_port: u16,

    /// Services configuration.
    /// Each entry is a pair of service ID (defined by user) and service settings.
    /// Service ID is normally used as a sensor prefix, for instance: `service_id:service_sensor`.
    pub services: HashMap<String, ServiceSettings>,
}

/// A service configuration.
#[derive(Deserialize, Debug, Clone)]
pub enum ServiceSettings {
    /// Regularly emits a counter value.
    Clock(services::clock::Settings),
    /// Regularly emits database information.
    Db(services::db::Settings),
    /// Dutch [Buienradar](https://www.buienradar.nl/) weather service.
    Buienradar(services::buienradar::Settings),
    /// Nest API.
    Nest(services::nest::Settings),
    /// Automation.
    Automator(services::automator::Settings),
}

fn default_http_port() -> u16 {
    8081
}