Struct Roots 

pub struct Roots {
    pub home: PathBuf,
    pub os_config: PathBuf,
    pub xdg_config: PathBuf,
    pub cwd: PathBuf,
}

Where to look. Everything is derived from injected roots rather than read from the environment, so the whole table is testable against tempdirs.

Two config roots, not one, because the harnesses genuinely disagree. Claude Desktop and VS Code follow the OS convention (~/Library/Application Support on macOS, %APPDATA% on Windows, ~/.config on Linux) - that is Self::os_config. Zed and OpenCode use an XDG-style ~/.config on macOS as well as Linux - that is Self::xdg_config. Collapsing them would silently look in the wrong place for half the table on macOS.

Fields

home: PathBuf

The user’s home directory.

os_config: PathBuf

The OS config directory (dirs::config_dir).

xdg_config: PathBuf

The XDG-style config directory: $XDG_CONFIG_HOME, else ~/.config.

cwd: PathBuf

The current working directory, for project-scoped files.

Implementations

impl Roots

pub fn new(home: PathBuf, os_config: PathBuf, cwd: PathBuf) -> Self

Resolve both config roots from a home directory and the OS convention.

$XDG_CONFIG_HOME is honoured when set, since a user who sets it means it. On Windows there is no ~/.config convention at all, so the XDG root falls back to the OS one.

Trait Implementations

impl Clone for Roots

fn clone(&self) -> Roots

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Roots

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

Formats the value using the given formatter.