implement default command completions

Author: DannyBen

lib/bashly/views/command/completion_function.gtx

@@ -9,6 +9,9 @@ end
 >
 = render(:completion_word_filter).indent 2
 = render(:completion_command_candidates).indent 2
+if default_command
+  >   {{ default_command.function_name }}_completion "$completion_current"
+end
 = render(:completion_flag_candidates).indent 2
 = render(:completion_argument_candidates).indent 2
 > }

lib/bashly/views/command/completion_word_filter.gtx

@@ -25,6 +25,9 @@ end
 >     *)
 if args.any?
   = render(:completion_argument_filter).indent 6
+elsif default_command
+  >       {{ default_command.function_name }}_completion "$completion_current" "$@"
+  >       return
 else
   >       return
 end

lib/bashly/views/command/completions.gtx

@@ -3,6 +3,7 @@
 > completion_run() {
 >   local -a completion_words=("$@")
 >   local -A completion_blocked_flags=()
+>   local -A completion_emitted=()
 >   local completion_count=${#completion_words[@]}
 >   local completion_current=""
 >
@@ -20,8 +21,10 @@
 >
 >   local completion_candidate
 >   for completion_candidate in "$@"; do
->     if [[ $completion_candidate == "$completion_current"* ]]; then
+>     if [[ $completion_candidate == "$completion_current"* ]] &&
+>       [[ -z "${completion_emitted[$completion_candidate]:-}" ]]; then
 >       printf '%s\n' "$completion_candidate"
+>       completion_emitted["$completion_candidate"]=1
 >     fi
 >   done
 > }

spec/fixtures/completions/default-command/examples.yml

@@ -0,0 +1,19 @@
+parent and default command candidates:
+  words: ['']
+  expected: [run, inspect, container, image]
+
+parent and default command prefix:
+  words: [i]
+  expected: [inspect, image]
+
+explicit default command:
+  words: [inspect, '']
+  expected: [container, image]
+
+implicit default command flag:
+  words: [--format, '']
+  expected: [json, yaml]
+
+implicit default command argument:
+  words: [container, '']
+  expected: []

spec/fixtures/completions/default-command/src/bashly.yml

@@ -0,0 +1,20 @@
+name: cli
+help: Default command completion fixture
+
+commands:
+- name: run
+  help: Run a target
+
+- name: inspect
+  help: Inspect a resource
+  default: true
+  args:
+  - name: resource
+    allowed: [container, image]
+    help: Resource to inspect
+  flags:
+  - long: --format
+    short: -f
+    arg: format
+    allowed: [json, yaml]
+    help: Output format