Struct UserInput

pub struct UserInput {
    pub config_ini: Option<String>,
    pub reconcile: Vec<PathBuf>,
    pub since: Option<String>,
}

Command-line argument parser for configuration file path.

This struct uses clap to parse CLI arguments and provide configuration options for the application. Currently supports specifying a custom INI configuration file path.

CLI Arguments

• --config-ini <PATH> - Optional path to a custom configuration file

Examples

# Use default config (~/.config/rusty-commit-saver/rusty-commit-saver.ini)
rusty-commit-saver

# Use custom config file
rusty-commit-saver --config-ini /path/to/custom.ini

See Also

• retrieve_config_file_path() - Gets the config path from CLI or default
• get_ini_file() - Loads the INI file from the resolved path

Fields

config_ini: Option<String>

Path to a custom INI configuration file.

If not provided, the default configuration file is used: ~/.config/rusty-commit-saver/rusty-commit-saver.ini

CLI Usage

rusty-commit-saver --config-ini /custom/path/config.ini

Examples

Valid paths:

• ~/my-configs/commit-saver.ini
• /etc/rusty-commit-saver/config.ini
• ./local-config.ini

reconcile: Vec<PathBuf>

Reconcile these repositories against their day notes, instead of journalling the commit that just happened.

Repeatable. Each value is a path inside a git repository; the repository is discovered from it the same way the hook discovers its own, and the history walked is what that checkout’s HEAD can reach. Given at least once, the binary does not journal the repository it was started in and does not behave as a hook at all.

CLI Usage

rusty-commit-saver --reconcile ~/src/one --reconcile ~/src/two

since: Option<String>

Ignore commits older than this date when reconciling, as YYYY-MM-DD.

Without it every commit reachable from HEAD is considered, which is what a first backfill wants and what a nightly pass does not.

CLI Usage

rusty-commit-saver --reconcile ~/src/one --since 2026-08-01

Trait Implementations

impl Args for UserInput

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl Clone for UserInput

fn clone(&self) -> UserInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for UserInput

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for UserInput

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

Formats the value using the given formatter.

impl FromArgMatches for UserInput

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for UserInput

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.