Class: Toys::Tool::DefaultCompletion
- Inherits:
-
Completion::Base
- Object
- Completion::Base
- Toys::Tool::DefaultCompletion
- Defined in:
- lib/toys/tool.rb
Overview
A Completion that implements the default algorithm for a tool.
Instance Attribute Summary collapse
-
#delegation_target ⇒ Array<String>?
Delegation target, or nil for none.
Instance Method Summary collapse
-
#call(context) ⇒ Array<Toys::Completion::Candidate>
Returns candidates for the current completion.
-
#complete_args? ⇒ Boolean
Whether to complete positional args.
-
#complete_flag_values? ⇒ Boolean
Whether to complete flag values.
-
#complete_flags? ⇒ Boolean
Whether to complete flags.
-
#complete_subtools? ⇒ Boolean
Whether to complete subtool names.
-
#include_hidden_subtools? ⇒ Boolean
Whether to include hidden subtools.
-
#initialize(complete_subtools: true, include_hidden_subtools: false, complete_args: true, complete_flags: true, complete_flag_values: true, delegation_target: nil) ⇒ DefaultCompletion
constructor
Create a completion given configuration options.
Constructor Details
#initialize(complete_subtools: true, include_hidden_subtools: false, complete_args: true, complete_flags: true, complete_flag_values: true, delegation_target: nil) ⇒ DefaultCompletion
Create a completion given configuration options.
1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 |
# File 'lib/toys/tool.rb', line 1120 def initialize(complete_subtools: true, include_hidden_subtools: false, complete_args: true, complete_flags: true, complete_flag_values: true, delegation_target: nil) @complete_subtools = complete_subtools @include_hidden_subtools = include_hidden_subtools @complete_flags = complete_flags @complete_args = complete_args @complete_flag_values = complete_flag_values @delegation_target = delegation_target end |
Instance Attribute Details
#delegation_target ⇒ Array<String>?
Delegation target, or nil for none.
1176 1177 1178 |
# File 'lib/toys/tool.rb', line 1176 def delegation_target @delegation_target end |
Instance Method Details
#call(context) ⇒ Array<Toys::Completion::Candidate>
Returns candidates for the current completion.
1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 |
# File 'lib/toys/tool.rb', line 1185 def call(context) candidates = valued_flag_candidates(context) return candidates if candidates candidates = subtool_or_arg_candidates(context) candidates += plain_flag_candidates(context) candidates += flag_value_candidates(context) if delegation_target delegate_tool = context.cli.loader.lookup_specific(delegation_target) if delegate_tool context = context.with(previous_words: delegation_target) candidates += delegate_tool.completion.call(context) end end candidates end |
#complete_args? ⇒ Boolean
Whether to complete positional args
1159 1160 1161 |
# File 'lib/toys/tool.rb', line 1159 def complete_args? @complete_args end |
#complete_flag_values? ⇒ Boolean
Whether to complete flag values
1167 1168 1169 |
# File 'lib/toys/tool.rb', line 1167 def complete_flag_values? @complete_flag_values end |
#complete_flags? ⇒ Boolean
Whether to complete flags
1151 1152 1153 |
# File 'lib/toys/tool.rb', line 1151 def complete_flags? @complete_flags end |
#complete_subtools? ⇒ Boolean
Whether to complete subtool names
1135 1136 1137 |
# File 'lib/toys/tool.rb', line 1135 def complete_subtools? @complete_subtools end |
#include_hidden_subtools? ⇒ Boolean
Whether to include hidden subtools
1143 1144 1145 |
# File 'lib/toys/tool.rb', line 1143 def include_hidden_subtools? @include_hidden_subtools end |