initial completions implementation

Author: DannyBen

.github/workflows/test.yml

@@ -13,7 +13,7 @@ jobs:
       LC_ALL: en_US.UTF-8 # consistent sort order
 
     strategy:
-      matrix: { ruby: ['2.4', '2.5', '2.6', '2.7', '3.0'] }
+      matrix: { ruby: ['2.7', '3.0'] }
 
     steps:
     - name: Checkout code

bashly.gemspec

@@ -15,9 +15,10 @@ Gem::Specification.new do |s|
   s.executables = ['bashly']
   s.homepage    = 'https://github.com/dannyben/bashly'
   s.license     = 'MIT'
-  s.required_ruby_version = ">= 2.3.0"
+  s.required_ruby_version = ">= 2.7.0"
 
   s.add_runtime_dependency 'colsole', '~> 0.6'
+  s.add_runtime_dependency 'completely', '~> 0.1'
   s.add_runtime_dependency 'mister_bin', '~> 0.7'
   s.add_runtime_dependency 'requires', '~> 0.1'
 end

lib/bashly/commands/add.rb

@@ -41,6 +41,7 @@ def yaml_command
       end
 
     private
+
       def safe_copy_lib(libfile)
         safe_copy asset("templates/lib/#{libfile}"), "#{Settings.source_dir}/lib/#{libfile}"
       end

lib/bashly/concerns/completions.rb

@@ -0,0 +1,36 @@
+module Bashly
+  # This is a `Command` concern responsible for providing bash completion data
+  module Completions
+    def completion_data(with_version: true)
+      result = { full_name => completion_words(with_version: with_version) }
+      
+      commands.each do |command|
+        result.merge! command.completion_data(with_version: false)
+      end
+
+      result
+    end
+
+  private
+
+    def completion_flag_names
+      flags.map(&:name) + flags.map(&:short)
+    end
+
+    def completion_actions
+      completions ? completions.map { |c| "<#{c}>" } : []
+    end
+
+    def completion_words(with_version: false)
+      trivial_flags = %w[--help -h]
+      trivial_flags += %w[--version -v] if with_version
+      all = (
+        command_names + trivial_flags +
+        completion_flag_names + completion_actions
+      )
+
+      all.uniq.sort
+    end
+
+  end
+end

lib/bashly/models/base.rb

@@ -9,6 +9,7 @@ class Base
         allowed
         arg
         catch_all
+        completions
         default
         dependencies
         description

lib/bashly/models/command.rb

@@ -1,6 +1,8 @@
 module Bashly
   module Models
     class Command < Base
+      include Completions
+
       # Returns the name to be used as an action.
       # - If it is the root command, the action is "root"
       # - Else, it is all the parents, except the first tone (root) joined