Struct Settings 

pub struct Settings {

    pub roots: Vec<String>,
    pub agenda_files: Vec<String>,
    pub todo_keywords: Vec<Vec<String>>,
    pub ids: IdPolicy,
    pub tag_alist: Vec<String>,
    pub persistent_tags: Vec<String>,
    pub tags_column: i64,
    pub tag_inheritance_exclusions: Vec<String>,
    pub highest_priority: String,
    pub lowest_priority: String,
    pub default_priority: String,
    pub agenda_span: String,
    pub agenda_start_day: Option<String>,
    pub week_start: String,
    pub deadline_warning_days: i64,
    pub skip_scheduled_if_done: bool,
    pub skip_deadline_if_done: bool,
    pub skip_timestamp_if_done: bool,
    pub sorting_strategy: Vec<String>,
    pub log_done: String,
    pub log_repeat: String,
    pub log_reschedule: String,
    pub log_redeadline: String,
    pub log_into_drawer: bool,
    pub editor: Vec<String>,
    pub theme: String,
    pub agent_capture_to: String,
    pub agent_inbox_template: String,
    pub someday_tag: String,
    pub someday_clears_scheduled: bool,
    pub reschedule_nudge: usize,
    pub captures: Vec<CaptureTemplate>,
    pub views: Vec<ViewSettings>,
    pub agent_profiles: Vec<AgentProfile>,
}

Everything agd reads from config.toml, one flat table: every setting is a top-level key, and only capture templates, views and agent profiles are lists of records ([[capture]], [[view]], [[agent_profile]]). Missing keys take the defaults below; unknown keys are errors.

Fields

roots: Vec<String>

The only directories agd reads or writes.

agenda_files: Vec<String>

org-agenda-files: files, directories (their *.org files) or globs. Empty means every .org file under the roots.

todo_keywords: Vec<Vec<String>>

org-todo-keywords: one list per sequence, with exactly one “|”.

ids: IdPolicy

“preserve” leaves headings alone; “add-on-write” adds an org-id :ID: on a heading’s first edit.

tag_alist: Vec<String>

persistent_tags: Vec<String>

tags_column: i64

org-tags-column: negative right-aligns tags to end at that column, positive starts them there, as Emacs does when it rewrites a headline.

tag_inheritance_exclusions: Vec<String>

highest_priority: String

lowest_priority: String

default_priority: String

agenda_span: String

day, week, month or a number of days.

agenda_start_day: Option<String>

week_start: String

monday or sunday.

deadline_warning_days: i64

skip_scheduled_if_done: bool

skip_deadline_if_done: bool

skip_timestamp_if_done: bool

sorting_strategy: Vec<String>

org-agenda-sorting-strategy for agenda days, from SORTING_KEYS.

log_done: String

org-log-done, org-log-repeat, org-log-reschedule, org-log-redeadline: nil, time or note. #+STARTUP options win per file.

log_repeat: String

log_reschedule: String

log_redeadline: String

log_into_drawer: bool

editor: Vec<String>

Program and arguments to open a file; {file}, {line} and {col} are substituted. Run directly, never through a shell.

theme: String

auto (follow the terminal background), dark or light.

agent_capture_to: String

“template” captures through the agent’s chosen template; “inbox” sends every agent capture through agent_inbox_template without dates.

agent_inbox_template: String

someday_tag: String

someday_clears_scheduled: bool

Someday also removes SCHEDULED, so the task leaves the agenda.

reschedule_nudge: usize

Triage suggests Someday after this many reschedules.

captures: Vec<CaptureTemplate>

views: Vec<ViewSettings>

agent_profiles: Vec<AgentProfile>

Implementations

impl Settings

pub fn capture_template(&self, key: &str) -> Option<&CaptureTemplate>

pub fn view(&self, key: &str) -> Option<&ViewSettings>

pub fn agent_profile(&self, name: &str) -> Option<&AgentProfile>

pub fn editor_command( &self, file: &str, line: usize, col: usize, ) -> (String, Vec<String>)

The editor program and its arguments with {file}, {line} and {col} (both 1-based) substituted inside each argument. The result goes straight to the process API, never to a shell, so file names with spaces or quotes stay one argument.

Trait Implementations

impl Clone for Settings

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 Settings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

where Settings: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Settings

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Settings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Settings