Struct TrieCompleter 

pub struct TrieCompleter { /* private fields */ }

Trie-based completer implementing rustyline::completion::Completer for autocompletion of built-in commands and external commands on $PATH

Implementations

impl TrieCompleter

pub fn with_builtin_commands(builtin_words: &[&str]) -> Self

Create a new TrieCompleter with the given built-in command words inserted into the trie for autocompletion

pub fn get_external_candidates( prefix: &str, ) -> Result<Option<Vec<String>>, CompletionError>

Add external commands on $PATH to the trie for autocompletion, returning a vector of candidates matching the given prefix

Errors

• CompletionError::PathNotSet if the PATH environment variable is not set

Trait Implementations

impl Completer for TrieCompleter

type Candidate = String

Specific completion candidate.

fn complete( &self, line: &str, pos: usize, _ctx: &Context<'_>, ) -> Result<(usize, Vec<Self::Candidate>)>

Takes the currently edited line with the cursor position and returns the start position and the completion candidates for the partial word to be completed.

fn update( &self, line: &mut LineBuffer, start: usize, elected: &str, cl: &mut Changeset, )

Updates the edited line with the elected candidate.

impl Debug for TrieCompleter

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

Formats the value using the given formatter.

impl Highlighter for TrieCompleter

fn highlight<'l>(&self, line: &'l str, pos: usize) -> Cow<'l, str>

Takes the currently edited line with the cursor position and returns the highlighted version (with ANSI color).

fn highlight_prompt<'b, 's, 'p>( &'s self, prompt: &'p str, default: bool, ) -> Cow<'b, str>

where 's: 'b, 'p: 'b,

Takes the prompt and returns the highlighted version (with ANSI color).

fn highlight_hint<'h>(&self, hint: &'h str) -> Cow<'h, str>

Takes the hint and returns the highlighted version (with ANSI color).

fn highlight_candidate<'c>( &self, candidate: &'c str, completion: CompletionType, ) -> Cow<'c, str>

Takes the completion candidate and returns the highlighted version (with ANSI color).

fn highlight_char(&self, line: &str, pos: usize, kind: CmdKind) -> bool

Tells if line needs to be highlighted when a specific char is typed or when cursor is moved under a specific char.

impl Hinter for TrieCompleter

type Hint = String

Specific hint type

fn hint(&self, line: &str, pos: usize, ctx: &Context<'_>) -> Option<Self::Hint>

Takes the currently edited line with the cursor position and returns the string that should be displayed or None if no hint is available for the text the user currently typed.

impl Validator for TrieCompleter

fn validate( &self, ctx: &mut ValidationContext<'_>, ) -> Result<ValidationResult, ReadlineError>

Takes the currently edited input and returns a ValidationResult indicating whether it is valid or not along with an option message to display about the result. The most common validity check to implement is probably whether the input is complete or not, for instance ensuring that all delimiters are fully balanced.

fn validate_while_typing(&self) -> bool

Configure whether validation is performed while typing or only when user presses the Enter key.

impl Helper for TrieCompleter