Implement CLI description

Author: hoppergee

exe/matrixeval

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
 require 'matrixeval/ruby'
-puts "Hello, MatrixEval!"
+
 Matrixeval.start(ARGV)

exe/meval

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
 require 'matrixeval/ruby'
-puts "Hello, MatrixEval!"
+
 Matrixeval.start(ARGV)

lib/matrixeval/ruby/command_line.rb

@@ -2,9 +2,11 @@
 
 module Matrixeval
   module Ruby
+    COMMANDS = ['rake', 'rspec', 'bundle', 'bash']
+
     class CommandLine
 
-      attr_reader :argv
+      attr_accessor :argv
 
       def initialize(argv)
         @argv = argv
@@ -15,15 +17,17 @@ def init?
       end
 
       def all?
-        argv[0] == 'all'
+        context_options[:all]
       end
 
       def context_options
-        ParseContextArguments.call(context_arguments)
+        @context_options ||= ParseContextArguments.call(context_arguments)
       end
 
       def context_arguments
-        argv[0...seperator_index]
+        arguments = argv[0...seperator_index]
+        arguments << "-h" if argv.empty?
+        arguments
       end
 
       def rest_arguments
@@ -34,14 +38,10 @@ def rest_arguments
 
       def seperator_index
         argv.index do |argument|
-          seperator_commands.include?(argument)
+          COMMANDS.include?(argument)
         end
       end
 
-      def seperator_commands
-        ['rake', 'rspec', 'bundle', 'bash']
-      end
-
     end
   end
 end

lib/matrixeval/ruby/command_line/parse_context_arguments.rb

@@ -24,11 +24,58 @@ def call
 
         def parse!
           OptionParser.new do |opts|
-            opts.banner = "Usage: meval/matrixeval --[VECTOR_KEY] [VECTOR_CHOICE] [COMMAND] [COMMAND_OPTIONS]"
+            opts.version = Matrixeval::Ruby::VERSION
+            opts.program_name = ""
+            opts.banner = <<~USAGE
+              Usage:
+                  matrixeval(meval) [OPTIONS] COMMAND
+              USAGE
+
+            opts.separator ""
+            opts.separator "Options:"
+
+            opts.on "-a", "--all", "# Run the COMMAND against all matrix combinations"
 
             Config.vectors.each do |vector|
-              opts.on("--#{vector.key} [VERSION]", "Set #{vector.key} version")
+              # short = "-#{vector.short_key}"
+              long = "--#{vector.key} [VERSION]"
+              desc = [
+                "# Run the COMMAND against a specific #{vector.key} version",
+                "# Options: #{vector.variants.map(&:key).join("/")}",
+                "# Default: #{vector.default_variant.key}",
+                "# Customizable"
+              ]
+              opts.separator ""
+              opts.on(long, *desc)
+            end
+
+            opts.separator ""
+            opts.separator "Commands: #{COMMANDS.join("/")} (Customizable)"
+
+            opts.separator ""
+            opts.separator "MatrixEval Options:"
+
+            opts.on("-h", "--help", "# Show help") do
+              puts opts.help
+              exit
             end
+
+            opts.on("-v", "--version", "# Show version") do
+              puts opts.version
+              exit
+            end
+
+            opts.separator ""
+            opts.separator "Customizations:"
+            opts.separator "    You can customize all options in matrixeval.yml"
+
+            opts.separator ""
+            opts.separator "Example:"
+            opts.separator "    matrixeval --all bundle install"
+            opts.separator "    matrixeval --ruby 3.0 rspec a_spec.rb"
+            opts.separator "    matrixeval --ruby 3.1 --active_model 7.0 rake test"
+            opts.separator "    matrixeval bash"
+
           end.parse!(context_arguments, into: options)
         end
 

test/matrixeval/ruby/command_line_test.rb

@@ -13,7 +13,12 @@ def test_init?
   end
 
   def test_all?
-    command = Matrixeval::Ruby::CommandLine.new(["all", "rake", "test"])
+    Matrixeval::Ruby::Config::YAML.stubs(:yaml).returns({"matrix" => {}})
+
+    command = Matrixeval::Ruby::CommandLine.new(["--all", "rake", "test"])
+    assert command.all?
+
+    command = Matrixeval::Ruby::CommandLine.new(["-a", "rake", "test"])
     assert command.all?
 
     command = Matrixeval::Ruby::CommandLine.new(["rake", "test"])