Struct UsageCommand 

pub struct UsageCommand {
    pub commit_range: Option<String>,
    pub max_count: Option<usize>,
    pub context_dir: Option<PathBuf>,
    pub project_only: bool,
    pub output: OutputFormat,
}

Usage command options — tallies declared commit scopes against history.

Fields

commit_range: Option<String>

Commit range to analyze (e.g., HEAD~300..HEAD, abc123..def456). Defaults to the entire history reachable from HEAD.

max_count: Option<usize>

Limits analysis to the newest N commits reachable from HEAD (ignored when COMMIT_RANGE is given). Useful for comparing the answer at different window sizes, e.g. -n 150 vs -n 400.

context_dir: Option<PathBuf>

Path to custom context directory (defaults to .omni-dev/).

project_only: bool

Excludes ecosystem default scopes (cargo/core/lib/test, …) from the known set, so they are reported as unknown rather than accepted.

output: OutputFormat

Output format.

Implementations

impl UsageCommand

pub fn execute(self, repo: Option<&Path>) -> Result<()>

Executes the usage command: tallies declared scopes across the resolved commit range and prints a report. Always exits 0 on a successful tally (including an empty range) — this is a reporting command, never a gate.

Trait Implementations

impl Args for UsageCommand

fn group_id() -> Option<Id>

Report the 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 CommandFactory for UsageCommand

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 FromArgMatches for UsageCommand

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 UsageCommand

fn parse() -> Self

Parse from std::env::args_os(), 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 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 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.