Struct Cli 

pub struct Cli {
    pub context: Option<usize>,
    pub char_context: Option<usize>,
    pub no_line_numbers: bool,
    pub regex: Option<String>,
    pub invert: bool,
    pub with_filename: bool,
    pub color: Option<String>,
    pub output: Option<String>,
    pub force: bool,
    pub args: Vec<String>,
}

sel — Select slices from text files by line numbers, ranges, positions, or regex.

Fields

context: Option<usize>

Show N lines of context before and after matches

char_context: Option<usize>

Show N characters of context around position

Only works with positional selectors (L:C) or with -e.

no_line_numbers: bool

Don’t output line numbers

Filenames are still shown when processing multiple files.

regex: Option<String>

Regular expression pattern (PCRE-like syntax)

When using -e, the selector argument is ignored. Multiple files can be specified with -e.

invert: bool

Invert the regex match: emit lines that do NOT match -e.

with_filename: bool

Always print filename prefix

By default, filename is only shown when processing multiple files.

color: Option<String>

Color output [auto, always, never]

Default is ‘auto’ (enabled when stdout is a terminal).

output: Option<String>

Write output to FILE instead of stdout. Use - for stdout explicitly.

force: bool

With -o, overwrite an existing file.

args: Vec<String>

Selector and/or file(s)

The first positional argument can be:

• A selector (line number, range, position) if it matches selector syntax
• A filename otherwise

When using -e, all positional arguments are treated as files.

Implementations

impl Cli

pub fn get_selector(&self) -> Option<String>

Get the selector from arguments (only valid when not using -e).

pub fn get_files(&self) -> Vec<PathBuf>

Get the list of input files.

Returns at least one entry — falls back to - (stdin) when no explicit files are provided.

pub fn validate(&self) -> Result<()>

Validate CLI arguments and check for conflicts.

pub fn color_mode(&self) -> ColorMode

Get the color mode based on the –color flag and terminal detection.

impl Cli

pub fn make_sink(&self) -> Result<Box<dyn Sink>>

Construct the output sink based on --output/--force flags.

pub fn into_app_for_file( &self, path: &Path, show_filename: bool, ) -> Result<App<Seek>>

Build a ready-to-run App for a single file.

Callers iterate over get_files() and build one App per file.

pub fn into_app_for_file_with_sink( &self, path: &Path, show_filename: bool, sink: Box<dyn Sink>, ) -> Result<App<Seek>>

pub fn into_app_for_stdin(&self, show_filename: bool) -> Result<App<NonSeek>>

Build a ready-to-run App for stdin input.

Returns PositionalWithStdin when paired with a positional selector (line:column), which requires a seekable source.

pub fn into_app_for_stdin_with_sink( &self, show_filename: bool, sink: Box<dyn Sink>, ) -> Result<App<NonSeek>>

Trait Implementations

impl Args for Cli

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 Cli

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 Cli

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

Formats the value using the given formatter.

impl FromArgMatches for Cli

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 Cli

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.