Struct Config 

pub struct Config {
    pub calendar_path: Option<PathBuf>,
    pub state_dir: Option<PathBuf>,
    pub default_due: Option<DateTimeAnchor>,
    pub default_priority: Priority,
    pub default_priority_none_fist: bool,
    pub config_dir: Option<PathBuf>,
    pub dev_mode: bool,
    pub stores: HashMap<String, StoreDef>,
    pub calendars: Vec<CalendarEntry>,
    pub default_calendar: String,
}

Configuration for the AIM application.

Fields

calendar_path: Option<PathBuf>

Path to the calendar directory (optional ICS export/import).

Deprecated: Use calendars array instead.

If set, AIM will sync events/todos with ICS files in this directory. If not set, AIM will only use the Db for storage.

state_dir: Option<PathBuf>

Directory for storing application state.

default_due: Option<DateTimeAnchor>

Default due time for new tasks.

default_priority: Priority

Default priority for new tasks.

default_priority_none_fist: bool

If true, items with no priority will be listed first.

config_dir: Option<PathBuf>

Parent directory of the config file.

Set by the CLI layer after parsing. Used by normalize() to resolve relative paths against the config file location rather than the CWD.

dev_mode: bool

Whether development mode is active.

When true, normalize() enforces explicit state_dir configuration to prevent accidental use of the system default state directory.

stores: HashMap<String, StoreDef>

Store definitions — shared connection configurations keyed by name.

calendars: Vec<CalendarEntry>

Multi-calendar configuration.

If present, each entry references a store from stores.

default_calendar: String

Default calendar ID for new items.

Implementations

impl Config

pub fn normalize(&mut self) -> Result<(), Box<dyn Error>>

Normalize the configuration.

Errors

If path normalization fails.

pub fn is_legacy_format(&self) -> bool

Check if the configuration uses legacy single-calendar format.

Returns true if calendars array is empty (legacy or default mode).

pub fn legacy_warning(&self) -> String

Generate a warning message for legacy configuration.

This provides helpful guidance to users about migrating to multi-calendar format.

pub fn enabled_calendars(&self) -> Vec<&CalendarEntry>

Get all enabled calendars ordered by priority.

pub fn resolve_store( &self, calendar_id: &str, ) -> Option<(&CalendarEntry, &StoreDef)>

Resolve the store definition for a calendar entry.

Returns None if the calendar is not found or the store reference is invalid.

pub fn get_calendar(&self, id: &str) -> Option<&CalendarEntry>

Get a specific calendar entry by ID.

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.