avm-tools 0.53.0 → 0.56.0

data/vendor/eac_ruby_gems_utils/README.rdoc

@@ -0,0 +1,3 @@
+= E.A.C.'s Ruby Gems Utils.
+
+Utilities for Ruby\'s gems development.

data/vendor/eac_ruby_gems_utils/eac_ruby_gems_utils.gemspec

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+# Maintain your gem's version:
+require 'eac_ruby_gems_utils/version'
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = 'eac_ruby_gems_utils'
+  s.version     = ::EacRubyGemsUtils::VERSION
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Utilities for Ruby gems development.'
+  s.license     = 'GPL3'
+
+  s.files = Dir['{lib}/**/*', 'LICENSE', 'README.rdoc']
+
+  s.add_dependency 'eac_ruby_utils', '~> 0.29'
+
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.1'
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemsUtils
+  require_sub(__FILE__)
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/gem.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/envs'
+
+module EacRubyGemsUtils
+  class Gem
+    require_sub __FILE__
+    enable_simple_cache
+
+    GEMSPEC_EXTNAME = '.gemspec'
+
+    common_constructor :root do
+      @root = ::Pathname.new(root).expand_path
+    end
+
+    def to_s
+      name
+    end
+
+    def bundle(*args)
+      ::EacRubyGemsUtils::Gem::Command.new(self, %w[bundle] + args).envvar_gemfile
+    end
+
+    def gemfile_lock_gem_version(gem_name)
+      gemfile_lock_content.specs.find { |gem| gem.name == gem_name }.if_present(&:version)
+    end
+
+    def gemfile_lock_content
+      ::Bundler::LockfileParser.new(::Bundler.read_file(gemfile_lock_path))
+    end
+
+    def name
+      name_by_gemspec || name_by_path
+    end
+
+    def name_by_gemspec
+      gemspec_path.if_present { |v| v.basename(GEMSPEC_EXTNAME).to_path }
+    end
+
+    def name_by_path
+      root.basename.to_s
+    end
+
+    def namespace_parts
+      name.split('-')
+    end
+
+    def rake(*args)
+      raise "File \"#{rakefile_path}\" does not exist" unless rakefile_path.exist?
+
+      bundle('exec', 'rake', '--rakefile', rakefile_path, *args)
+    end
+
+    def version
+      /VERSION\s*=\s*[\'\"]([^\'\"]+)[\'\"]/.if_match(version_file.read) { |m| m[1] }
+    end
+
+    private
+
+    def gemfile_path_uncached
+      root.join('Gemfile')
+    end
+
+    def gemfile_lock_path_uncached
+      root.join('Gemfile.lock')
+    end
+
+    def gemspec_path_uncached
+      ::Pathname.glob("#{root.to_path}/*#{GEMSPEC_EXTNAME}").first
+    end
+
+    def rakefile_path_uncached
+      root.join('Rakefile')
+    end
+
+    def version_file_uncached
+      root.join('lib', *namespace_parts, 'version.rb')
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/gem/command.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/ruby/command'
+require 'delegate'
+
+module EacRubyGemsUtils
+  class Gem
+    class Command < ::EacRubyUtils::Ruby::Command
+      attr_reader :gem
+
+      def initialize(gem, command_args, extra_options = {})
+        @gem = gem
+        super(command_args, extra_options)
+      end
+
+      # Changes current directory to the gem's directory.
+      def chdir_root
+        chdir(gem.root.to_path)
+      end
+
+      def envvar_gemfile
+        envvar('BUNDLE_GEMFILE', gem.gemfile_path.to_path)
+      end
+
+      protected
+
+      def duplicate(command, extra_options)
+        self.class.new(gem, command, extra_options)
+      end
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemsUtils
+  module Tests
+    require_sub(__FILE__)
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/base.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/fs_cache'
+require 'eac_ruby_utils/listable'
+require 'eac_ruby_utils/on_clean_ruby_environment'
+
+module EacRubyGemsUtils
+  module Tests
+    class Base
+      include ::EacRubyUtils::Listable
+
+      enable_simple_cache
+      lists.add_string :result, :failed, :nonexistent, :successful
+
+      common_constructor :gem
+
+      def elegible?
+        dependency_present? && gem.root.join(test_directory).exist?
+      end
+
+      def dependency_present?
+        gem.gemfile_path.exist? && gem.gemfile_lock_gem_version(dependency_gem).present?
+      end
+
+      def name
+        self.class.name.demodulize.gsub(/Test\z/, '')
+      end
+
+      def stdout_cache
+        root_cache.child('stdout')
+      end
+
+      def stderr_cache
+        root_cache.child('stderr')
+      end
+
+      def to_s
+        "#{gem}[#{name}]"
+      end
+
+      private
+
+      def result_uncached
+        return RESULT_NONEXISTENT unless elegible?
+
+        exec_run_with_log ? RESULT_SUCCESSFUL : RESULT_FAILED
+      end
+
+      def exec_run
+        gem.bundle('exec', *bundle_exec_args).chdir_root.execute
+      end
+
+      def exec_run_with_log
+        r = exec_run
+        stdout_cache.write(r[:stdout])
+        stderr_cache.write(r[:stderr])
+        r[:exit_code].zero?
+      end
+
+      def root_cache
+        ::EacRubyUtils.fs_cache.child(gem.root.to_s.parameterize, self.class.name.parameterize)
+      end
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/minitest.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gems_utils/tests/base'
+
+module EacRubyGemsUtils
+  module Tests
+    class Minitest < ::EacRubyGemsUtils::Tests::Base
+      def bundle_exec_args
+        %w[rake test]
+      end
+
+      def dependency_gem
+        'minitest'
+      end
+
+      def elegible?
+        super && gem.rakefile_path.exist?
+      end
+
+      def test_directory
+        'test'
+      end
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/multiple.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gems_utils/tests/minitest'
+require 'eac_ruby_gems_utils/tests/rspec'
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemsUtils
+  module Tests
+    class Multiple
+      enable_console_speaker
+      enable_simple_cache
+      common_constructor :gems, :options, default: [{}]
+      set_callback :initialize, :after, :run
+
+      def ok?
+        failed_tests.none?
+      end
+
+      def only
+        options[:only]
+      end
+
+      private
+
+      def all_tests_uncached
+        decorated_gems.flat_map(&:tests)
+      end
+
+      def bundle_all_gems
+        infom 'Bundling all gems...'
+        decorated_gems.each do |gem|
+          next unless gem.gemfile_path.exist?
+
+          infov 'Bundle install', gem
+          gem.bundle.execute!
+        end
+      end
+
+      def decorated_gems_uncached
+        r = gems
+        r = r.select { |gem| only.include?(gem.name) } if only.present?
+        r.map { |gem| DecoratedGem.new(gem) }
+      end
+
+      def failed_tests_uncached
+        all_tests.select { |r| r.result == ::EacRubyGemsUtils::Tests::Base::RESULT_FAILED }
+      end
+
+      def final_results_banner
+        if failed_tests.any?
+          warn 'Some test did not pass:'
+          failed_tests.each do |test|
+            infov '  * Test', test
+            infov '    * STDOUT', test.stdout_cache.content_path
+            infov '    * STDERR', test.stderr_cache.content_path
+          end
+        else
+          success 'All tests passed'
+        end
+      end
+
+      def run
+        start_banner
+        bundle_all_gems
+        test_all_gems
+        final_results_banner
+      end
+
+      def start_banner
+        infov 'Gems to test', decorated_gems.count
+      end
+
+      def test_all_gems
+        infom 'Running tests...'
+        all_tests.each do |test|
+          infov test, Result.new(test.result).tag
+        end
+      end
+
+      class DecoratedGem < ::SimpleDelegator
+        def tests
+          [::EacRubyGemsUtils::Tests::Minitest.new(__getobj__),
+           ::EacRubyGemsUtils::Tests::Rspec.new(__getobj__)]
+        end
+      end
+
+      class Result
+        common_constructor :result
+
+        COLORS = {
+          ::EacRubyGemsUtils::Tests::Base::RESULT_FAILED => :red,
+          ::EacRubyGemsUtils::Tests::Base::RESULT_NONEXISTENT => :white,
+          ::EacRubyGemsUtils::Tests::Base::RESULT_SUCCESSFUL => :green
+        }.freeze
+
+        def tag
+          result.to_s.send(color)
+        end
+
+        def color
+          COLORS.fetch(result)
+        end
+      end
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/rspec.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gems_utils/tests/base'
+
+module EacRubyGemsUtils
+  module Tests
+    class Rspec < ::EacRubyGemsUtils::Tests::Base
+      def bundle_exec_args
+        %w[rspec]
+      end
+
+      def dependency_gem
+        'rspec-core'
+      end
+
+      def test_directory
+        'spec'
+      end
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EacRubyGemsUtils
+  VERSION = '0.6.0'
+end

data/vendor/eac_ruby_gems_utils/spec/lib/eac_ruby_gems_utils/gem_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gems_utils/gem'
+
+::RSpec.describe ::EacRubyGemsUtils::Gem do
+  let(:mygem_path) { ::Pathname.new(__dir__).expand_path.parent.parent.join('support', 'mygem') }
+  let(:mygem) { described_class.new(mygem_path) }
+
+  describe '#bundle' do
+    specify do
+      expect(mygem.bundle('exec', 'myrunner').execute!).to include('My Runner')
+    end
+  end
+
+  describe '#rake' do
+    specify do
+      expect(mygem.rake('mygem:stub').execute!).to include('Stub!')
+    end
+  end
+end

data/vendor/eac_ruby_gems_utils/spec/rubocop_check_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gem_support/spec/examples/rubocop_check'
+
+RSpec.describe ::RuboCop do
+  include_examples 'rubocop_check', ::File.expand_path('../..', __dir__)
+end

data/vendor/eac_ruby_gems_utils/spec/spec_helper.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # The settings below are suggested to provide a good initial experience
+  # with RSpec, but feel free to customize to your heart's content.
+  #   # This allows you to limit a spec run to individual examples or groups
+  #   # you care about by tagging them with `:focus` metadata. When nothing
+  #   # is tagged with `:focus`, all examples get run. RSpec also provides
+  #   # aliases for `it`, `describe`, and `context` that include `:focus`
+  #   # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  #   config.filter_run_when_matching :focus
+  #
+  #   # Allows RSpec to persist some state between runs in order to support
+  #   # the `--only-failures` and `--next-failure` CLI options. We recommend
+  #   # you configure your source control system to ignore this file.
+  #   config.example_status_persistence_file_path = "spec/examples.txt"
+  #
+  #   # Limits the available syntax to the non-monkey patched syntax that is
+  #   # recommended. For more details, see:
+  #   #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  #   config.disable_monkey_patching!
+  #
+  #   # This setting enables warnings. It's recommended, but in some cases may
+  #   # be too noisy due to issues in dependencies.
+  #   config.warnings = true
+  #
+  #   # Many RSpec users commonly either run the entire suite or an individual
+  #   # file, and it's useful to allow more verbose output when running an
+  #   # individual spec file.
+  #   if config.files_to_run.one?
+  #     # Use the documentation formatter for detailed output,
+  #     # unless a formatter has already been configured
+  #     # (e.g. via a command-line flag).
+  #     config.default_formatter = "doc"
+  #   end
+  #
+  #   # Print the 10 slowest examples and example groups at the
+  #   # end of the spec run, to help surface which specs are running
+  #   # particularly slow.
+  #   config.profile_examples = 10
+  #
+  #   # Run specs in random order to surface order dependencies. If you find an
+  #   # order dependency and want to debug it, you can fix the order by providing
+  #   # the seed, which is printed after each run.
+  #   #     --seed 1234
+  #   config.order = :random
+  #
+  #   # Seed global randomization in this process using the `--seed` CLI option.
+  #   # Setting this allows you to use `--seed` to deterministically reproduce
+  #   # test failures related to randomization by passing the same `--seed` value
+  #   # as the one that triggered the failure.
+  #   Kernel.srand config.seed
+end