Struct Config 

pub struct Config {
    pub si: Option<SiConfig>,
    pub gitlab: Option<GitLabConfig>,
    pub jira: Option<JiraConfig>,
    pub monitor: Option<MonitorConfig>,
    pub server: Option<ServerConfig>,
    pub productivity: Option<ProductivityConfig>,
    pub report: Option<ReportConfig>,
    pub task_discovery: Option<TaskDiscoveryConfig>,
    pub jira_inbox: Option<JiraInboxConfig>,
}

The root configuration. Every module is optional, and unset modules are omitted from the JSON, so the file only names what is configured.

Fields

si: Option<SiConfig>

SiServer integration.

gitlab: Option<GitLabConfig>

GitLab integration (commit discovery).

jira: Option<JiraConfig>

Jira integration (issue discovery, inbox).

monitor: Option<MonitorConfig>

Activity monitor settings.

server: Option<ServerConfig>

External reporting server.

productivity: Option<ProductivityConfig>

Productivity thresholds.

report: Option<ReportConfig>

Report export defaults.

task_discovery: Option<TaskDiscoveryConfig>

Task discovery ignore list; built-in defaults apply when absent.

jira_inbox: Option<JiraInboxConfig>

Jira inbox polling; requires jira, disabled when absent.

Implementations

impl Config

pub fn init() -> Result<Self>

Runs the setup wizard: pick modules, prompt each one’s settings, return the updated config (the caller saves it).

use kasl::libs::config::Config;

let config = Config::init()?;
config.save()?;

impl Config

pub fn read() -> Result<Config>

Loads the config file, or defaults when none exists yet.

use kasl::libs::config::Config;

let config = Config::read()?;

if config.jira.is_some() {
    println!("Jira integration is configured");
}

pub fn save(&self) -> Result<()>

Writes the config as pretty-printed JSON, overwriting the file.

use kasl::libs::config::{Config, MonitorConfig};

let mut config = Config::read()?;
config.monitor = Some(MonitorConfig::default());
config.save()?;

pub fn effective_ignore_names(&self) -> Vec<String>

Returns the ignore list for task discovery.

When task_discovery is not configured, returns the built-in defaults.

pub fn add_ignore_names(&mut self, names: &[String]) -> Result<usize>

Appends unique names to the discovery ignore list and saves the config.

Uniqueness is determined by normalize_task_name. Returns how many new entries were added.

pub fn set_app_global() -> Result<()>

Adds the executable’s directory to the global PATH.

Windows-shaped: checks the process PATH first, then edits the machine-level registry value via reg (which needs admin rights; the setup command downgrades a failure here to a warning).

use kasl::libs::config::Config;

Config::set_app_global()?;

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.