Class: Toys::Completion::Candidate

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
core-docs/toys/completion.rb

Overview

Defined in the toys-core gem

A candidate for completing a string fragment.

A candidate includes a string representing the potential completed word, as well as a flag indicating whether it is a partial completion (i.e. a prefix that could still be added to) versus a final word. Generally, tab completion systems should add a trailing space after a final completion but not after a partial completion.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(string, partial: false) ⇒ Candidate

Create a new candidate

Parameters:

  • string (String) —

    The candidate string

  • partial (Boolean) (defaults to: false) —

    Whether the candidate is partial. Defaults to false.



128
129
130
 
# File 'core-docs/toys/completion.rb', line 128

def initialize(string, partial: false)
  # Source available in the toys-core gem
end

Instance Attribute Details

#string ⇒ String (readonly) Also known as: to_s

Get the candidate string.

Returns:

  • (String) 


136
137
138
 
# File 'core-docs/toys/completion.rb', line 136

def string
  @string
end

Class Method Details

.new_multi(array, partial: false) ⇒ Array<Toys::Completion::Candidate]

Create an array of candidates given an array of strings.

Parameters:

  • array (Array<String>)

Returns:



161
162
163
 
# File 'core-docs/toys/completion.rb', line 161

def self.new_multi(array, partial: false)
  # Source available in the toys-core gem
end

Instance Method Details

#final? ⇒ Boolean

Determine whether the candidate is a final completion.

Returns:

  • (Boolean) 


151
152
153
 
# File 'core-docs/toys/completion.rb', line 151

def final?
  # Source available in the toys-core gem
end

#partial? ⇒ Boolean

Determine whether the candidate is partial completion.

Returns:

  • (Boolean) 


143
144
145
 
# File 'core-docs/toys/completion.rb', line 143

def partial?
  # Source available in the toys-core gem
end