Class: Toys::Completion::Candidate

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/toys/completion.rb

Overview

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.



150
151
152
153
 
# File 'lib/toys/completion.rb', line 150

def initialize(string, partial: false)
  @string = string.to_s
  @partial = partial ? true : false
end

Instance Attribute Details

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

Get the candidate string.

Returns:

  • (String) 


159
160
161
 
# File 'lib/toys/completion.rb', line 159

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:



199
200
201
 
# File 'lib/toys/completion.rb', line 199

def self.new_multi(array, partial: false)
  array.map { |s| new(s, partial: partial) }
end

Instance Method Details

#final? ⇒ Boolean

Determine whether the candidate is a final completion.

Returns:

  • (Boolean) 


174
175
176
 
# File 'lib/toys/completion.rb', line 174

def final?
  !@partial
end

#partial? ⇒ Boolean

Determine whether the candidate is partial completion.

Returns:

  • (Boolean) 


166
167
168
 
# File 'lib/toys/completion.rb', line 166

def partial?
  @partial
end