Struct EnvelopePaths 

pub struct EnvelopePaths { /* private fields */ }

Manages all paths used by EnvelopeCLI

Implementations

impl EnvelopePaths

pub fn new() -> Result<Self, EnvelopeError>

Create a new EnvelopePaths instance

Path resolution:

1. ENVELOPE_CLI_DATA_DIR env var (explicit override)
2. Unix: $XDG_CONFIG_HOME/envelope-cli or ~/.config/envelope-cli
3. Windows: %APPDATA%\envelope-cli

Errors

Returns an error if the home directory cannot be determined.

pub fn with_base_dir(base_dir: PathBuf) -> Self

Create EnvelopePaths with a custom base directory (useful for testing)

pub fn base_dir(&self) -> &PathBuf

Get the base directory (~/.config/envelope-cli/ or equivalent)

pub fn config_dir(&self) -> PathBuf

Get the config directory (same as base for simplicity)

pub fn data_dir(&self) -> PathBuf

Get the data directory (~/.config/envelope-cli/data/)

pub fn backup_dir(&self) -> PathBuf

Get the backup directory (~/.config/envelope-cli/backups/)

pub fn settings_file(&self) -> PathBuf

Get the path to the settings file

pub fn audit_log(&self) -> PathBuf

Get the path to the audit log

pub fn accounts_file(&self) -> PathBuf

Get the path to accounts.json

pub fn transactions_file(&self) -> PathBuf

Get the path to transactions.json

pub fn budget_file(&self) -> PathBuf

Get the path to budget.json (categories and groups)

pub fn allocations_file(&self) -> PathBuf

Get the path to allocations.json (budget allocations per period)

pub fn payees_file(&self) -> PathBuf

Get the path to payees.json

pub fn targets_file(&self) -> PathBuf

Get the path to targets.json (budget targets)

pub fn income_file(&self) -> PathBuf

Get the path to income.json (income expectations)

pub fn ensure_directories(&self) -> Result<(), EnvelopeError>

Ensure all required directories exist

Creates:

• Base directory (~/.config/envelope-cli/)
• Data directory (~/.config/envelope-cli/data/)
• Backup directory (~/.config/envelope-cli/backups/)

pub fn is_initialized(&self) -> bool

Check if EnvelopeCLI has been initialized (config file exists)

Trait Implementations

impl Clone for EnvelopePaths

fn clone(&self) -> EnvelopePaths

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvelopePaths

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

Formats the value using the given formatter.