matrixeval-ruby 0.1.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4af8c6ab00f9e0a26f787dc9e3161f92c824f8aa2f06bd6809ff6b7875535d22
-  data.tar.gz: 6dc2c0275ba1b28a733f8bc72f627ac53cce9aae606087b9becb5b0a2c23fe7b
+  metadata.gz: 3c1fa003fd849f1a5baf6c9393c5210e030e52a14c044308f6732b602c196027
+  data.tar.gz: 652ab5ecd63138e426a002aae768c7bd61214785ef8a8eaa698cffa2eddda1ae
 SHA512:
-  metadata.gz: c37a896625ce715a31fdc3506139aaa1025412c3f354cd5d8874ec6c3412c460757c08868e120ac412908c15bd3b686236b7bd4dfb891793590fa85df9b99078
-  data.tar.gz: 4610fa81ab3b5a00ab202ecf1a082ababc89f48a9af23d826e41dd1252528e61e837761c4d422c59a2e1ebc5942b4e785303d20e22567b5f46e078d43aedc8e8
+  metadata.gz: fc85db98392512e7683fbfa96c54e4f34ff2f5c248ab07ceac57bd18a6781cdfac45325b874c1580c068b5a1f56a8653bc0d943baea6fcd391e3baf521038dd4
+  data.tar.gz: af503dd911a0522975061dfb37696470adedafc4a6868019480e89cfd51c686bb5aa4f5d848683dfe9b52ba94be0d34cb7fbb7478a262c6fe62f8964f0c5c6a1

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
-## [0.1.0] - 2022-02-06
+## [0.2.2] - 2022-02-11
+
+- Auto remove containers
+
+## [0.2.1] - 2022-02-11
+
+- Fix a assignment method issue
+
+## [0.2.0] - 2022-02-10
+
+- Change config format from 0.1 to 0.2
+- CLI description
+- Other errors fix
+
+## [0.1.1] - 2022-02-09
+
+- Fix a execution report issue
+
+## [0.1.0] - 2022-02-09
 
 - Initial release

data/README.md

@@ -1,9 +1,6 @@
-# Matrixeval::Ruby
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/matrixeval/ruby`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+# matrixeval-ruby
 
+Test your ruby code against multiple versions of dependencies like Ruby, Rails, Env ...
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -22,7 +19,22 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+Initialize
+
+```bash
+matrixeval init
+```
+
+Customize `matrixeval.yml` file and run commands like:
+
+```bash
+matrixeval --all bundle install
+matrixeval --all rspec
+matrixeval --ruby 3.0 rspec a_spec.rb
+matrixeval --ruby 3.1 --rails 7.0 rake test
+matrixeval bash
+```
+Run `matrixeval --help` for more details
 
 ## Development
 
@@ -32,7 +44,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/matrixeval-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/matrixeval-ruby/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/matrixeval/matrixeval-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/matrixeval-ruby/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -40,4 +52,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Matrixeval::Ruby project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/matrixeval-ruby/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Matrixeval::Ruby project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/matrixeval/matrixeval-ruby/blob/main/CODE_OF_CONDUCT.md).

data/exe/matrixeval

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

data/exe/meval

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

data/lib/matrixeval/ruby/command_line/parse_context_arguments.rb

@@ -24,11 +24,58 @@ module Matrixeval
 
         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: #{Config.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
 

data/lib/matrixeval/ruby/command_line.rb

@@ -2,6 +2,8 @@ require_relative "./command_line/parse_context_arguments"
 
 module Matrixeval
   module Ruby
+    COMMANDS = ['rake', 'rspec', 'bundle', 'bash']
+
     class CommandLine
 
       attr_reader :argv
@@ -10,38 +12,42 @@ module Matrixeval
         @argv = argv
       end
 
+      def valid?
+        init? ||
+          !context_options.empty? ||
+          !seperator_index.nil?
+      end
+
       def init?
-        argv[0] == 'init'
+        @argv[0] == '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
-        argv[seperator_index..-1]
+        @argv[seperator_index..-1]
       end
 
       private
 
       def seperator_index
-        argv.index do |argument|
-          seperator_commands.include?(argument)
+        @argv.index do |argument|
+          Config.commands.include?(argument)
         end
       end
 
-      def seperator_commands
-        ['rake', 'rspec', 'bundle', 'bash']
-      end
-
     end
   end
 end

data/lib/matrixeval/ruby/config/yaml.rb

@@ -2,6 +2,9 @@ module Matrixeval
   module Ruby
     class Config
       class YAML
+
+        class MissingError < StandardError; end
+
         class << self
 
           def create
@@ -25,6 +28,8 @@ module Matrixeval
           end
 
           def yaml
+            raise MissingError unless File.exist?(path)
+
             ::YAML.load File.read(path)
           end
 

data/lib/matrixeval/ruby/config.rb

@@ -49,6 +49,11 @@ module Matrixeval
           YAML["parallel_workers"] || "number_of_processors"
         end
 
+        def commands
+          cmds = YAML["commands"] || []
+          COMMANDS + cmds
+        end
+
       end
     end
   end

data/lib/matrixeval/ruby/container.rb

@@ -0,0 +1,15 @@
+module Matrixeval
+  module Ruby
+    class Container
+
+      attr_reader :image, :env
+
+      def initialize(options)
+        options ||= {}
+        @image = options["image"]
+        @env = options["env"] || {}
+      end
+
+    end
+  end
+end

data/lib/matrixeval/ruby/docker_compose/yaml.rb

@@ -29,7 +29,7 @@ module Matrixeval
 
             Config.main_vector_variants.map do |variant|
               services[variant.docker_compose_service_name] = {
-                "image" => variant.image,
+                "image" => variant.container.image,
                 "volumes" => mounts(variant),
                 "environment" => {
                   "BUNDLE_PATH" => "/bundle",
@@ -37,7 +37,7 @@ module Matrixeval
                   "BUNDLE_APP_CONFIG" => "/bundle",
                   "BUNDLE_BIN" => "/bundle/bin",
                   "PATH" => "/app/bin:/bundle/bin:$PATH"
-                },
+                }.merge(variant.container.env),
                 "working_dir" => "/app"
               }
             end

data/lib/matrixeval/ruby/docker_compose.rb

@@ -5,6 +5,12 @@ module Matrixeval
   module Ruby
     class DockerCompose
 
+      class << self
+        def clean_containers
+          system("docker compose -f .matrixeval/docker-compose.yml rm --all -f >> /dev/null 2>&1")
+        end
+      end
+
       attr_reader :context
 
       def initialize(context)

data/lib/matrixeval/ruby/runner.rb

@@ -20,9 +20,13 @@ module Matrixeval
       def initialize(argv)
         @argv = argv
         @command = CommandLine.new(argv)
+        @threads ||= []
+        @matrixeval_results ||= []
       end
 
       def start
+        validates
+
         if command.init?
           init
         elsif command.all?
@@ -30,12 +34,32 @@ module Matrixeval
         else
           run_a_specific_context
         end
+      rescue OptionParser::InvalidOption => e
+        puts <<~ERROR
+          #{e.message}
+          See 'matrixeval --help'
+          ERROR
+        exit
+      rescue Config::YAML::MissingError
+        puts "Please run 'matrixeval init' first to generate matrixeval.yml"
+        exit
       ensure
         turn_on_stty_opost
+        DockerCompose.clean_containers
       end
 
       private
 
+      def validates
+        return if command.valid?
+
+        puts <<~ERROR
+          matrixeval: '#{argv.join(' ')}' is not a MatrixEval command.
+          See 'matrixeval --help'
+          ERROR
+        exit
+      end
+
       def init
         Config::YAML.create
         Gitignore.update
@@ -47,6 +71,8 @@ module Matrixeval
         GemfileLocks.create
         Gitignore.update
 
+        pull_all_images
+
         if workers_count == 1
           run_all_contexts_sequentially
         else
@@ -62,17 +88,17 @@ module Matrixeval
           docker_compose = DockerCompose.new(context)
           success = docker_compose.run(command.rest_arguments)
 
-          matrixeval_results << [context, !!success]
+          @matrixeval_results << [context, !!success]
         end
 
         report
       end
 
       def run_all_contexts_in_parallel
-        parallel do |contexts|
+        parallel(contexts) do |sub_contexts|
           Thread.current[:matrixeval_results] = []
 
-          contexts.each do |context|
+          sub_contexts.each do |context|
             docker_compose = DockerCompose.new(context)
             success = docker_compose.run(command.rest_arguments)
 
@@ -98,15 +124,28 @@ module Matrixeval
         docker_compose.run(command.rest_arguments)
       end
 
+      def pull_all_images
+        parallel(Config.main_vector_variants) do |sub_variants|
+          sub_variants.each do |variant|
+            puts "Docker image check/pull #{variant.container.image}"
+            image_exists = system %Q{[ -n "$(docker images -q #{variant.container.image})" ]}
+            next if image_exists
+
+            system "docker pull #{variant.container.image}"
+          end
+        end
+      end
+
       def report
         turn_on_stty_opost
 
         table = Terminal::Table.new(title: Rainbow("MatrixEval").blue.bright + " Summary", alignment: :center) do |table|
 
-          table.add_row(Config.vectors.map(&:key) + ['result'])
+          headers = Config.vectors.map(&:key) + ['result']
+          table.add_row headers.map { |value| { value: value, alignment: :center } }
           table.add_separator 
 
-          matrixeval_results.each do |context, success|
+          @matrixeval_results.each do |context, success|
             success_cell = [success ? Rainbow('Success').green : Rainbow('Failed').red]
             row = (context.variants.map(&:key) + success_cell).map do |value|
               { value: value, alignment: :center }
@@ -120,28 +159,30 @@ module Matrixeval
         puts table
       end
 
-      def parallel
-        contexts = Context.all
+      def parallel(collection)
+        @threads = [] unless @threads.empty?
+        @matrixeval_results = [] unless @matrixeval_results.empty?
 
-        contexts.each_slice(contexts.count / workers_count) do |sub_contexts|
-          threads << Thread.new do
-            yield sub_contexts
+        collection.each_slice(per_worker_contexts_count) do |sub_collection|
+          @threads << Thread.new do
+            yield sub_collection
           end
         end
 
-        threads.each(&:join)
+        @threads.each(&:join)
 
-        threads.each do |thread|
-          matrixeval_results += thread[:matrixeval_results]
+        @threads.each do |thread|
+          @matrixeval_results += (thread[:matrixeval_results] || [])
         end
       end
 
-      def threads
-        @threads ||= []
+
+      def per_worker_contexts_count
+        [(contexts.count / workers_count), 1].max
       end
 
-      def matrixeval_results
-        @matrixeval_results ||= []
+      def contexts
+        @contexts ||= Context.all
       end
 
       def workers_count

data/lib/matrixeval/ruby/templates/matrixeval.yml

@@ -1,13 +1,52 @@
-version: 0.1
+version: 0.2
 target: ruby
 parallel_workers: number_of_processors
+# commands:
+#   - ps
+#   - top
+#   - an_additional_command
 matrix:
   ruby:
+    # mounts:
+    #   - /a/path/need/to/mount:/a/path/mount/to
     variants:
       - key: 2.7
-        image: ruby:2.7.1
+        container:
+          image: ruby:2.7.1
       - key: 3.0
-        image: ruby:3.0.0
         default: true
+        container:
+          image: ruby:3.0.0
       - key: 3.1
-        image: ruby:3.1.0
+        container:
+          image: ruby:3.1.0
+      # - key: jruby-9.3
+      #   container:
+      #     image: jruby:9.3
+      #     env:
+      #       PATH: "/opt/jruby/bin:/app/bin:/bundle/bin:$PATH"
+
+  # rails:
+  #   variants:
+  #     - key: 6.1
+  #       default: true
+  #       env:
+  #         RAILS_VERSION: "~> 6.1.0"
+  #     - key: 7.0
+  #       env:
+  #         RAILS_VERSION: "~> 7.0.0"
+  # another:
+  #   variants:
+  #     - key: key1
+  #       default: true
+  #       env:
+  #         ENV_KEY: 1
+  #     - key: key2
+  #       env:
+  #         ENV_KEY: 2
+
+exclude:
+  # - ruby: 3.0
+  #   rails: 4.2
+  # - ruby: jruby-9.3
+  #   rails: 7.0

data/lib/matrixeval/ruby/variant.rb

@@ -1,3 +1,5 @@
+require_relative "./container"
+
 module Matrixeval
   module Ruby
     class Variant
@@ -7,14 +9,14 @@ module Matrixeval
         end
       end
 
-      attr_reader :key, :image, :env, :vector, :default
+      attr_reader :key, :env, :vector, :default, :container
 
       def initialize(config = {}, vector)
         raise Error.new("Variant#key is missing") if config["key"].nil?
 
         @vector = vector
         @key = config["key"].to_s
-        @image = config["image"]
+        @container = Container.new(config["container"])
         @env = config["env"] || {}
         @default = config["default"] || false
       end
@@ -24,7 +26,7 @@ module Matrixeval
       end
 
       def bundle_volume_name
-        "bundle_#{image.gsub(/[^A-Za-z0-9]/,'_')}"
+        "bundle_#{container.image.gsub(/[^A-Za-z0-9]/,'_')}"
       end
 
       def id

data/lib/matrixeval/ruby/vector.rb

@@ -30,7 +30,7 @@ module Matrixeval
       def default_variant
         variant = variants.find(&:default?)
         if variant.nil?
-          raise Error.new("Please set a default variant for matrix #{vector.key}")
+          raise Error.new("Please set a default variant for matrix #{key}")
         end
 
         variant

data/lib/matrixeval/ruby/version.rb

@@ -2,6 +2,6 @@
 
 module Matrixeval
   module Ruby
-    VERSION = "0.1.0"
+    VERSION = "0.2.2"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: matrixeval-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Hopper Gee
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-02-09 00:00:00.000000000 Z
+date: 2022-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -64,7 +64,6 @@ files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -78,6 +77,7 @@ files:
 - lib/matrixeval/ruby/command_line/parse_context_arguments.rb
 - lib/matrixeval/ruby/config.rb
 - lib/matrixeval/ruby/config/yaml.rb
+- lib/matrixeval/ruby/container.rb
 - lib/matrixeval/ruby/context.rb
 - lib/matrixeval/ruby/context/find_by_command_options.rb
 - lib/matrixeval/ruby/docker_compose.rb

data/Gemfile.lock

@@ -1,37 +0,0 @@
-PATH
-  remote: .
-  specs:
-    matrixeval-ruby (0.1.0)
-      concurrent-ruby
-      rainbow (~> 3.1)
-      terminal-table
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    byebug (11.1.3)
-    concurrent-ruby (1.1.9)
-    minitest (5.15.0)
-    minitest-focus (1.3.1)
-      minitest (>= 4, < 6)
-    mocha (1.13.0)
-    rainbow (3.1.1)
-    rake (13.0.6)
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
-    unicode-display_width (2.1.0)
-
-PLATFORMS
-  x86_64-darwin-19
-  x86_64-linux
-
-DEPENDENCIES
-  byebug
-  matrixeval-ruby!
-  minitest (~> 5.0)
-  minitest-focus
-  mocha
-  rake (~> 13.0)
-
-BUNDLED WITH
-   2.2.32