Struct Config 

pub struct Config {
    pub default_action: Option<Decision>,
    pub log_file: Option<PathBuf>,
    pub log_full: bool,
    pub tracking_db: Option<PathBuf>,
    pub self_protect: bool,
    pub trust_project_configs: bool,
    pub cd_allowed_dirs: Vec<PathBuf>,
    pub active_package: Option<Package>,
    /* private fields */
}

Loaded and merged configuration with rules partitioned by type.

Fields

default_action: Option<Decision>

log_file: Option<PathBuf>

log_full: bool

tracking_db: Option<PathBuf>

self_protect: bool

trust_project_configs: bool

Whether to auto-trust all project configs without checking the trust DB.

cd_allowed_dirs: Vec<PathBuf>

Extra directories that cd is allowed to navigate to (beyond the project root).

active_package: Option<Package>

The active safety package (if any).

Implementations

impl Config

pub fn load_from_str( content: &str, format: ConfigFormat, ) -> Result<Self, RippyError>

Parse a config string directly into a Config, without touching the filesystem.

Errors

Returns RippyError::Config if content contains invalid syntax. The error’s path field is set to the sentinel <memory> so callers can distinguish in-memory parses from file-based ones.

impl Config

pub fn load(cwd: &Path, env_config: Option<&Path>) -> Result<Self, RippyError>

Load config from the three-tier system: global, project, env override.

Errors

Returns RippyError::Config if a config file exists but contains invalid syntax.

pub fn load_with_home( cwd: &Path, env_config: Option<&Path>, home: Option<PathBuf>, ) -> Result<Self, RippyError>

Load config with an explicit home directory instead of reading $HOME.

Pass None to skip global config loading (useful for tests).

Errors

Returns RippyError::Config if a config file exists but contains invalid syntax.

pub fn empty() -> Self

pub fn weakening_suffix(&self) -> &str

Return the pre-formatted weakening suffix for verdict annotation.

pub fn match_command( &self, command: &str, ctx: Option<&MatchContext<'_>>, ) -> Option<Verdict>

Match a command string against command rules (last-match-wins).

pub fn match_redirect( &self, path: &str, ctx: Option<&MatchContext<'_>>, ) -> Option<Verdict>

Match a redirect target path against redirect rules.

pub fn match_mcp(&self, tool_name: &str) -> Option<Verdict>

Match an MCP tool name against MCP rules.

pub fn match_file_read( &self, path: &str, ctx: Option<&MatchContext<'_>>, ) -> Option<Verdict>

Match a file path against file-read rules.

pub fn match_file_write( &self, path: &str, ctx: Option<&MatchContext<'_>>, ) -> Option<Verdict>

Match a file path against file-write rules.

pub fn match_file_edit( &self, path: &str, ctx: Option<&MatchContext<'_>>, ) -> Option<Verdict>

Match a file path against file-edit rules.

pub fn match_after(&self, command: &str) -> Option<String>

Match a command for after rules (post-execution feedback).

pub fn resolve_alias<'a>(&'a self, command: &'a str) -> &'a str

Resolve aliases for a command name. Returns the target if aliased.

pub fn from_directives(directives: Vec<ConfigDirective>) -> Self

Build a Config from a list of directives.

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.