Skip to main content

Cli

Struct Cli 

Source
pub struct Cli {
Show 21 fields pub base: PathBuf, pub name: Option<String>, pub type: Vec<EntryType>, pub grep: Option<String>, pub mode: Option<Mode>, pub size: Option<String>, pub hidden: bool, pub follow: bool, pub limit: Option<usize>, pub timeout: Option<f64>, pub heartbeat: HeartbeatOpts, pub question: Option<String>, pub expect: Option<String>, pub emit: Option<String>, pub emit_stderr: Option<String>, pub list: bool, pub summary: bool, pub detail: bool, pub quiet: bool, pub json: bool, pub explain: Option<Format>,
}

Fields§

§base: PathBuf

Search root (relative or absolute), independent of the current directory.

§name: Option<String>

File-name pattern; ‘|’-separated alternatives, each substring->glob->regex promoted and anchored to the whole name.

§type: Vec<EntryType>

Restrict to entry kinds: f=file, d=dir, l=symlink (repeatable or comma-joined).

§grep: Option<String>

Content pattern (substring->glob->regex promoted); searches file contents. Accepts file:PATH / text:VALUE; a multi-line pattern matches as a line-anchored literal block.

§mode: Option<Mode>

Pin how patterns are interpreted (promotion off): literal, glob, or regex.

§size: Option<String>

Size predicate [+|-]N[k|m|g]: +N larger than, -N smaller than, N at least N.

§hidden: bool

Include dot-entries (names starting with ‘.’); default skips them.

§follow: bool

Follow symlinks while traversing.

§limit: Option<usize>

Stop after N matches.

§timeout: Option<f64>

Abort with exit 2 if the search exceeds SECS seconds (fractional allowed).

§heartbeat: HeartbeatOpts§question: Option<String>

Question this search answers, framing it as a test; printed as a “== … ==” banner unless –quiet.

§expect: Option<String>

Verdict expectation over the match count: any|none|N|=N|+N|-N (default: any). Turns the search into a pass/fail test whose exit status follows the verdict.

§emit: Option<String>

Template written to stdout after the search. Tokens: {RESULT} {QUESTION} {COUNT} {LINES} {BASE} {MATCHES}.

§emit_stderr: Option<String>

Template written to stderr after the search (same tokens as –emit).

§list: bool

Output mode: print one matching path per line (default).

§summary: bool

Output mode: print counts only.

§detail: bool

Output mode: print matches plus, for –grep, each hit as path:line:text.

§quiet: bool

Output mode: print nothing; report via exit status only.

§json: bool

Emit a structured JSON result instead of text (overrides the output mode and –emit).

§explain: Option<Format>

Print agent usage docs (md or json) and exit.

Trait Implementations§

Source§

impl Args for Cli

Source§

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments
Source§

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

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut Read more
Source§

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 Read more
Source§

impl CommandFactory for Cli

Source§

fn command<'b>() -> Command

Build a Command that can instantiate Self. Read more
Source§

fn command_for_update<'b>() -> Command

Build a Command that can update self. Read more
Source§

impl Debug for Cli

Source§

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

Formats the value using the given formatter. Read more
Source§

impl FromArgMatches for Cli

Source§

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

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

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

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

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

Assign values from ArgMatches to self.
Source§

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

Assign values from ArgMatches to self.
Source§

impl Parser for Cli

Source§

fn parse() -> Self

Parse from std::env::args_os(), exit on error.
Source§

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

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

fn parse_from<I, T>(itr: I) -> Self
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.
Source§

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.
Source§

fn update_from<I, T>(&mut self, itr: I)
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error. Read more
Source§

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.

Auto Trait Implementations§

§

impl Freeze for Cli

§

impl RefUnwindSafe for Cli

§

impl Send for Cli

§

impl Sync for Cli

§

impl Unpin for Cli

§

impl UnsafeUnpin for Cli

§

impl UnwindSafe for Cli

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.