Struct SettingsLoader 

pub struct SettingsLoader { /* private fields */ }

Builder/loader for the settings layers.

Defaults to reading from ~/.claude/. If Self::project_root is set, also reads from <project_root>/.claude/. Missing files are not errors – the corresponding Settings field stays None.

Implementations

impl SettingsLoader

pub fn home() -> Result<Self>

Construct with the default user root ~/.claude/ and no project root. Add a project root with Self::project_root.

pub fn at(user_root: impl Into<PathBuf>, project_root: Option<PathBuf>) -> Self

Construct with explicit roots. Useful for tests (point both at tempdirs) and non-default installs. project_root may be None if no project context applies.

pub fn project_root(self, dir: impl Into<PathBuf>) -> Self

Set or override the project root. Note this is the .claude parent – i.e. the project directory itself, not <project>/.claude. The loader appends /.claude internally.

pub fn user_root_path(&self) -> &Path

The configured user root (typically ~/.claude).

pub fn project_root_path(&self) -> Option<&Path>

The configured project root, if any.

pub fn load(&self) -> Result<Settings>

Read all four layers. Missing files become None; malformed JSON files raise an error so callers don’t silently lose data.

Trait Implementations

impl Clone for SettingsLoader

fn clone(&self) -> SettingsLoader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettingsLoader

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

Formats the value using the given formatter.