avm-tools 0.112.0 → 0.113.3

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner_with/filesystem_traverser.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner'
+require 'eac_ruby_utils/core_ext'
+require 'eac_fs/traversable'
+require 'eac_ruby_utils/settings_provider'
+
+module EacRubyBase0
+  module RunnerWith
+    module FilesystemTraverser
+      DEFAULT_DEFAULT_TRAVERSER_RECURSIVE = false
+
+      common_concern do
+        include ::EacCli::Runner
+        include ::EacFs::Traversable
+        enable_settings_provider
+        include TopMethods
+        runner_definition do
+          bool_opt '-R', '--recursive', 'Recursive.'
+          bool_opt '--no-recursive', 'No recursive.'
+          pos_arg :paths, optional: true, repeat: true
+        end
+      end
+
+      module TopMethods
+        def on_none_path_informed
+          infom 'Warning: none path informed'
+        end
+
+        def paths
+          parsed.paths.map(&:to_pathname)
+        end
+
+        def run_filesystem_traverser
+          if parsed.paths.any?
+            parsed.paths.each { |path| traverser_check_path(path) }
+          else
+            on_none_path_informed
+          end
+        end
+
+        def traverser_recursive
+          return false if parsed.no_recursive?
+          return true if parsed.recursive?
+
+          setting_value(:default_traverser_recursive, required: false)
+            .if_not_nil(DEFAULT_DEFAULT_TRAVERSER_RECURSIVE)
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner_with/input.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/abstract_methods'
+
+module EacRubyBase0
+  module RunnerWith
+    module Input
+      STDIN_OPTION = '-'
+      BLANK_OPTION = '+'
+      DEFAULT_DEFAULT_INPUT_OPTION = BLANK_OPTION
+
+      common_concern do
+        enable_settings_provider
+        include ::EacCli::Runner
+
+        runner_definition do
+          arg_opt '-i', '--input', 'Input from file.'
+        end
+      end
+
+      def input_content
+        case input_option
+        when STDIN_OPTION then $stdin.read
+        when BLANK_OPTION then ''
+        else input_option.to_pathname.read
+        end
+      end
+
+      def input_option
+        parsed.input || setting_value(:default_input_option, default: DEFAULT_DEFAULT_INPUT_OPTION)
+      end
+    end
+  end
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner_with/output.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/abstract_methods'
+
+module EacRubyBase0
+  module RunnerWith
+    module Output
+      STDOUT_OPTION = '-'
+      DEFAULT_FILE_OPTION = '+'
+      DEFAULT_DEFAULT_OUTPUT_OPTION = STDOUT_OPTION
+      DEFAULT_DEFAULT_FILE_TO_OUTPUT = 'output'
+
+      common_concern do
+        enable_abstract_methods
+        enable_settings_provider
+        include ::EacCli::Runner
+
+        abstract_methods :output_content
+
+        runner_definition do
+          arg_opt '-o', '--output', 'Output to file.'
+        end
+      end
+
+      def run_output
+        file = file_to_output
+        if file
+          file.to_pathname.write(output_content)
+        else
+          $stdout.write(output_content)
+        end
+      end
+
+      def output_option
+        parsed.output || default_output_option_value
+      end
+
+      def file_to_output
+        case output_option
+        when STDOUT_OPTION then nil
+        when DEFAULT_FILE_OPTION then default_file_to_output_value
+        else output_option
+        end
+      end
+
+      def default_output_option_value
+        setting_value(:default_output_option,
+                      default: DEFAULT_DEFAULT_OUTPUT_OPTION)
+      end
+
+      def default_file_to_output_value
+        setting_value(:default_file_to_output, default: DEFAULT_DEFAULT_FILE_TO_OUTPUT)
+      end
+    end
+  end
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner_with.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyBase0
+  module RunnerWith
+    require_sub __FILE__
+  end
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0/version.rb

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

data/sub/eac_ruby_base0/lib/eac_ruby_base0.rb

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

data/sub/eac_ruby_base0/spec/lib/eac_ruby_base0/runner_with/confirmation_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base0/runner_with/confirmation'
+
+::RSpec.describe ::EacRubyBase0::RunnerWith::Confirmation do
+  let(:runner) do
+    the_module = described_class
+    Class.new do
+      include the_module
+
+      runner_definition do
+        desc 'A stub runner.'
+      end
+
+      def run
+        if confirm?
+          ::Kernel.puts 'Accepted'
+        else
+          ::Kernel.puts 'Denied'
+        end
+      end
+    end
+  end
+
+  let(:instance) { runner.create(argv: runner_argv) }
+
+  context 'without --no option' do
+    let(:runner_argv) { %w[--no] }
+
+    it do
+      expect { instance.run }.to output("Denied\n").to_stdout_from_any_process
+    end
+  end
+
+  context 'without --yes option' do
+    let(:runner_argv) { %w[--yes] }
+
+    it do
+      expect { instance.run }.to output("Accepted\n").to_stdout_from_any_process
+    end
+  end
+end

data/sub/eac_ruby_base0/spec/lib/eac_ruby_base0/runner_with/output_spec.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base0/runner_with/output'
+require 'eac_ruby_utils/fs/temp'
+
+RSpec.describe ::EacRubyBase0::RunnerWith::Output do
+  let(:runner) do
+    the_module = described_class
+    Class.new do
+      include the_module
+
+      attr_accessor :temp_dir
+
+      runner_definition do
+        desc 'A stub root runner.'
+        pos_arg :input_text
+      end
+
+      def run
+        run_output
+      end
+
+      def output_content
+        parsed.input_text
+      end
+
+      def default_file_to_output
+        temp_dir.join('default_file')
+      end
+    end
+  end
+
+  let(:stub_text) { 'STUB_TEXT' }
+  let(:instance) do
+    r = runner.create(argv: runner_argv)
+    r.temp_dir = temp_dir
+    r
+  end
+  let(:temp_dir) { ::EacRubyUtils::Fs::Temp.directory }
+
+  after { temp_dir.remove }
+
+  context 'without --output option' do
+    let(:runner_argv) { [stub_text] }
+
+    it do
+      expect { instance.run }.to output(stub_text).to_stdout_from_any_process
+    end
+  end
+
+  context 'without --output option as to stdout' do
+    let(:runner_argv) { ['--output', ::EacRubyBase0::RunnerWith::Output::STDOUT_OPTION, stub_text] }
+
+    it do
+      expect { instance.run }.to output(stub_text).to_stdout_from_any_process
+    end
+  end
+
+  context 'without --output option as to default file' do
+    let(:output_file) { temp_dir.join('default_file') }
+    let(:runner_argv) do
+      ['--output', ::EacRubyBase0::RunnerWith::Output::DEFAULT_FILE_OPTION,
+       stub_text]
+    end
+
+    before { instance.run }
+
+    it { expect(output_file).to exist }
+    it { expect(output_file.read).to eq(stub_text) }
+  end
+
+  context 'with --output option' do
+    let(:output_file) { temp_dir.join('a output file') }
+    let(:runner_argv) { ['--output', output_file.to_path, stub_text] }
+
+    before { instance.run }
+
+    it { expect(output_file).to exist }
+    it { expect(output_file.read).to eq(stub_text) }
+  end
+end

data/sub/eac_ruby_base0/spec/rubocop_spec.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+::EacRubyUtils::Rspec.default_setup.describe_rubocop

data/sub/eac_ruby_base0/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/rspec/default_setup'
+::EacRubyUtils::Rspec.default_setup_create(::File.expand_path('..', __dir__))

data/sub/eac_ruby_gems_utils/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/sub/eac_ruby_gems_utils/LICENCE

@@ -0,0 +1,16 @@
+Copyright (c) 2020 Eduardo Henrique Bogoni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next paragraph) shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/sub/eac_ruby_gems_utils/README.rdoc

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

data/sub/eac_ruby_gems_utils/eac_ruby_gems_utils.gemspec

@@ -0,0 +1,31 @@
+# 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     = 'MIT'
+  s.homepage    = 'https://github.com/esquilo-azul/eac_ruby_gems_utils'
+  s.metadata    = { 'source_code_uri' => s.homepage }
+
+  s.extra_rdoc_files = ['README.rdoc']
+  s.rdoc_options = ['--charset=UTF-8']
+
+  s.require_paths = ['lib']
+  s.files = Dir['{lib}/**/*', 'Gemfile']
+  s.test_files = Dir['{spec}/**/*', '.rspec']
+
+  s.add_dependency 'bundler'
+  s.add_dependency 'eac_fs', '~> 0.8'
+  s.add_dependency 'eac_ruby_utils', '~> 0.81'
+
+  # Tests
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.3'
+end

data/sub/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.merge(host_env: gem.host_env))
+      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/sub/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/gem/version_file.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemsUtils
+  class Gem
+    class VersionFile
+      common_constructor :path
+
+      VERSION_LINE_PATTERN = /\A(\s*)VERSION\s*=\s*[\'\"]([^\'\"]+)[\'\"](\s*)\z/.freeze
+
+      def value
+        path.read.each_line.lazy.map { |line| line_value(line) }.find { |v| v }
+      end
+
+      def value=(new_value)
+        path.write(new_value_content(new_value))
+      end
+
+      private
+
+      # @return Version found in line, nil otherwise.
+      def line_value(line)
+        VERSION_LINE_PATTERN.if_match(line.rstrip, false) { |m| ::Gem::Version.new(m[2]) }
+      end
+
+      def new_value_content(new_value)
+        path.read.each_line
+            .map { |line| new_value_line(line, new_value) }
+            .join
+      end
+
+      def new_value_line(line, new_value)
+        m = VERSION_LINE_PATTERN.match(line)
+        return line unless m
+
+        "#{m[1]}VERSION = '#{new_value}'#{m[3]}"
+      end
+    end
+  end
+end

data/sub/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/gem.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/envs'
+require 'rubygems'
+
+module EacRubyGemsUtils
+  class Gem
+    require_sub __FILE__
+    enable_simple_cache
+
+    GEMSPEC_EXTNAME = '.gemspec'
+
+    common_constructor :root, :host_env, default: [nil] do
+      @root = ::Pathname.new(root).expand_path
+      self.host_env ||= ::EacRubyUtils::Envs.local
+    end
+
+    def to_s
+      name
+    end
+
+    def bundle(*args)
+      ::EacRubyGemsUtils::Gem::Command.new(self, %w[bundle] + args).envvar_gemfile
+    end
+
+    # @return A [Pathname] array with relative paths from root listed in gemspec's .file directive.
+    def files
+      gemspec.files.map(&:to_pathname)
+    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
+      fullname = root.basename.to_s
+      /\A(.+)(?:-\d+(?:\.\d+)*)\z/.if_match(fullname, false) { |m| m[1] }.if_present(fullname)
+    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_file.value
+    end
+
+    private
+
+    def gemfile_path_uncached
+      root.join('Gemfile')
+    end
+
+    def gemfile_lock_path_uncached
+      gemfile_path.basename_sub { |b| "#{b}.lock" }
+    end
+
+    def gemspec_uncached
+      ::Gem::Specification.load(gemspec_path.to_path)
+    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
+      ::EacRubyGemsUtils::Gem::VersionFile.new(version_file_path)
+    end
+
+    def version_file_path_uncached
+      root.join('lib', *namespace_parts, 'version.rb')
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_fs/logs'
+require 'eac_ruby_utils/listable'
+
+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 to_s
+        "#{gem}[#{name}]"
+      end
+
+      private
+
+      def logs_uncached
+        ::EacFs::Logs.new.add(:stdout).add(:stderr)
+      end
+
+      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
+        logs[:stdout].write(r[:stdout])
+        logs[:stderr].write(r[:stderr])
+        r[:exit_code].zero?
+      end
+    end
+  end
+end

data/sub/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/sub/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/multiple/decorated_gem.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemsUtils
+  module Tests
+    class Multiple
+      class DecoratedGem < ::SimpleDelegator
+        enable_speaker
+
+        def prepare
+          return unless gemfile_path.exist?
+
+          log('running "bundle install"...')
+          return if bundle('install').execute.fetch(:exit_code).zero?
+
+          unless can_remove_gemfile_lock?
+            raise '"bundle install" failed and the Gemfile.lock is part of gem' \
+                '(Should be changed by developer)'
+          end
+
+          prepare_with_removable_gemfile_lock
+        end
+
+        def tests
+          [::EacRubyGemsUtils::Tests::Minitest.new(__getobj__),
+           ::EacRubyGemsUtils::Tests::Rspec.new(__getobj__)]
+        end
+
+        private
+
+        def log(message)
+          infov self, message
+        end
+
+        def prepare_with_removable_gemfile_lock
+          log('"bundle install" failed, removing Gemfile.lock and trying again...')
+          gemfile_lock_path.unlink if gemfile_lock_path.exist?
+          bundle('install').execute!
+        end
+
+        def can_remove_gemfile_lock?
+          !files.include?(gemfile_lock_path.relative_path_from(root))
+        end
+      end
+    end
+  end
+end