eac_tools 0.99.1 → 0.100.0

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner/prepend.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+require 'eac_cli/speaker'
+require 'eac_cli/speaker/input_blocked'
+require 'eac_config/node'
+require 'eac_fs/contexts'
+require 'eac_ruby_utils/speaker'
+
+module EacRubyBase0
+  module Runner
+    module Prepend
+      SYSTEM_STACK_ERROR_FILE = 'system_stack_error'
+
+      def run
+        on_rescue_stack_overflow do
+          if parsed.version?
+            show_version
+          else
+            run_with_subcommand
+          end
+        end
+      end
+
+      def run_run
+        on_context { super }
+      end
+
+      private
+
+      def on_rescue_stack_overflow
+        yield
+      rescue ::SystemStackError => e
+        SYSTEM_STACK_ERROR_FILE.to_pathname.write(e.backtrace.map { |v| "#{v}\n" }.join)
+        raise e
+      end
+    end
+  end
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0/runner.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+require 'eac_cli/speaker'
+require 'eac_cli/speaker/input_blocked'
+require 'eac_config/node'
+require 'eac_fs/contexts'
+require 'eac_ruby_utils/speaker'
+
+module EacRubyBase0
+  module Runner
+    require_sub __FILE__
+    enable_speaker
+    common_concern do
+      include ::EacCli::RunnerWith::Help
+      include ::EacCli::RunnerWith::Subcommands
+      include ::EacRubyBase0::Runner::Contexts
+      prepend ::EacRubyBase0::Runner::Prepend
+      runner_definition do
+        bool_opt '-q', '--quiet', 'Quiet mode.'
+        bool_opt '-I', '--no-input', 'Fail if a input is requested.'
+        subcommands
+        alt do
+          bool_opt '-V', '--version', 'Show version.', usage: true, required: true
+        end
+      end
+    end
+
+    def application_version
+      runner_context.call(:application).version.to_s
+    end
+
+    def show_version
+      out("#{application_version}\n")
+    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.19.1'
+end

data/sub/eac_ruby_base0/lib/eac_ruby_base0.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils'
+EacRubyUtils::RootModuleSetup.perform __FILE__ do
+  ignore 'core_ext'
+  ignore 'patches'
+end
+
+module EacRubyBase0
+end
+
+require 'eac_ruby_base0/core_ext'

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_base0'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__))

data/sub/eac_ruby_gem_support/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+local_gemfile = File.join(File.dirname(__FILE__), 'Gemfile.local')
+eval_gemfile local_gemfile if File.exist?(local_gemfile)

data/sub/eac_ruby_gem_support/eac_ruby_gem_support.gemspec

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'eac_ruby_gem_support/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'eac_ruby_gem_support'
+  s.version     = EacRubyGemSupport::VERSION
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Development support for Ruby\' Gem.'
+  s.homepage    = 'https://github.com/esquilo-azul/eac_ruby_gem_support'
+  s.metadata    = { 'source_code_uri' => 'https://github.com/esquilo-azul/eac_ruby_gem_support' }
+
+  s.files = Dir['{lib}/**/*', '.rubocop.yml']
+
+  s.required_ruby_version = '>= 2.7.0'
+
+  s.add_dependency 'eac_ruby_utils', '~> 0.127'
+  s.add_dependency 'rspec', '~> 3.13', '>= 3.13.1'
+  s.add_dependency 'rubocop', '~> 1.76'
+  s.add_dependency 'rubocop-rails', '~> 2.32'
+  s.add_dependency 'rubocop-rspec', '~> 3.6'
+  s.add_dependency 'super_diff', '~> 0.9'
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/helpers/filesystem.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'tmpdir'
+require 'tempfile'
+
+module EacRubyGemSupport
+  module Rspec
+    module Helpers
+      module Filesystem
+        def purge_temp_files
+          ::FileUtils.rm_rf(temp_set.pop) while temp_set.any?
+        end
+
+        # @return [Pathname]
+        def temp_copy(source_path)
+          source_path = to_pathname(source_path)
+          if source_path.file?
+            temp_file_copy(source_path)
+          elsif source_path.directory?
+            temp_dir_copy(source_path)
+          else
+            raise "Source path \"#{source_path}\" is not a file or directory"
+          end
+        end
+
+        # @return [Pathname]
+        def temp_dir(*mktmpdir_args)
+          add_to_temp_set(::Dir.mktmpdir(*mktmpdir_args))
+        end
+
+        # @return [Pathname]
+        def temp_dir_copy(source_path)
+          r = temp_dir
+          ::FileUtils.cp_r("#{source_path}/.", r.to_path)
+          r
+        end
+
+        # @return [Pathname]
+        def temp_file(*tempfile_args)
+          file = ::Tempfile.new(*tempfile_args)
+          path = file.path
+          file.close
+          add_to_temp_set(path)
+        end
+
+        # @return [Pathname]
+        def temp_file_copy(source_path)
+          r = temp_file
+          ::FileUtils.cp(to_pathname(source_path).to_path, r.to_path)
+          r
+        end
+
+        # @return [Pathname]
+        def to_pathname(path)
+          path.is_a?(::Pathname) ? path : ::Pathname.new(path.to_s)
+        end
+
+        private
+
+        def add_to_temp_set(path)
+          r = to_pathname(path)
+          temp_set << r
+          r
+        end
+
+        def temp_set
+          @temp_set ||= []
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/helpers/utils.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'tmpdir'
+require 'tempfile'
+
+module EacRubyGemSupport
+  module Rspec
+    module Helpers
+      module Utils
+        # @return [StandardError, nil] If block raises an error, return this error. If not, return
+        #   +nil+.
+        def capture_error
+          yield
+          nil
+        rescue ::StandardError => e
+          e
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/setup.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_gem_support/rspec/helpers/filesystem'
+require 'eac_ruby_gem_support/rspec/helpers/utils'
+require 'eac_ruby_gem_support/rspec/specs/rubocop'
+require 'tmpdir'
+
+module EacRubyGemSupport
+  module Rspec
+    module Setup
+      extend ::ActiveSupport::Concern
+      include ::EacRubyGemSupport::Rspec::Specs::Rubocop
+
+      SETUPS = %w[load_path example_persistence filesystem_helper shared_examples].freeze
+
+      def self.extended(setup_obj)
+        SETUPS.each { |s| setup_obj.send("setup_#{s}") }
+      end
+
+      def setup_filesystem_helper
+        rspec_config.include ::EacRubyGemSupport::Rspec::Helpers::Filesystem
+        rspec_config.include ::EacRubyGemSupport::Rspec::Helpers::Utils
+        rspec_config.after(:each) { purge_temp_files }
+      end
+
+      def setup_load_path
+        $LOAD_PATH.push app_root_path.join('lib').to_path
+      end
+
+      def setup_example_persistence
+        rspec_config.example_status_persistence_file_path = example_persistence_path.to_path
+      end
+
+      def setup_shared_examples
+        require 'eac_ruby_gem_support/rspec/shared_examples/spec_paths'
+        require 'eac_ruby_gem_support/rspec/shared_examples/source_target_fixtures'
+      end
+
+      # @return [Pathname]
+      def example_persistence_path
+        root_tmp.join('example_status_persistence')
+      end
+
+      # The root directory for temporary files.
+      # @return [Pathname]
+      def root_tmp
+        r = ::Pathname.new(::Dir.tmpdir)
+              .join("#{app_root_path.expand_path.to_path.variableize}_specs_tmp")
+        r.mkpath unless r.exist?
+        r
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/shared_examples/source_target_fixtures.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gem_support/rspec/shared_examples/spec_paths'
+require 'eac_ruby_gem_support/rspec/source_target_fixtures_controller'
+require 'eac_ruby_gem_support/source_target_fixtures'
+require 'yaml'
+
+RSpec.shared_examples 'source_target_fixtures' do |spec_file| # rubocop:disable Metrics/BlockLength
+  include_examples 'spec_paths', spec_file
+  fixtures_controller = EacRubyGemSupport::Rspec::SourceTargetFixturesController
+                          .new(spec_paths_controller)
+
+  let(:fixtures_controller) { fixtures_controller }
+  let(:spec_file) { spec_file }
+
+  it 'fixtures directory should exist' do
+    expect(File.directory?(fixtures_controller.fixtures_dir)).to be true
+  end
+
+  context 'with fixtures directory' do
+    it 'has at least one file' do
+      expect(source_target_fixtures.source_target_files.count).to be > 0 # rubocop:disable Style/NumericPredicate
+    end
+
+    fixtures_controller.source_target_fixtures.source_target_files.each do |st|
+      context "when source file is \"#{File.basename(st.source)}\"" do
+        if fixtures_controller.write_target_fixtures?
+          it 'writes target data' do
+            sd = sort_results(source_data(st.source))
+            basename = EacRubyGemSupport::SourceTargetFixtures.source_target_basename(st.source)
+            target_file = File.expand_path("../#{basename}.target#{target_file_extname}", st.source)
+            File.write(target_file, target_content(sd))
+          end
+        else
+          it 'parses data' do
+            assert_source_target_complete(st)
+            sd = source_data(st.source)
+            td = target_data(st.target)
+            expect(sort_results(sd)).to eq(sort_results(td))
+          end
+        end
+      end
+    end
+  end
+
+  delegate :source_target_fixtures, to: :fixtures_controller
+
+  def assert_source_target_complete(source_target)
+    expect(source_target.source).to(be_truthy, "Source not found (Target: #{source_target.target})")
+    expect(source_target.target).to(be_truthy, "Target not found (Source: #{source_target.source})")
+  end
+
+  def source_data(source_file)
+    instance = described_class.new(source_file)
+    return instance.data if instance.respond_to?(:data)
+
+    raise "#{instance} has no \"data\" method. You need to implement \"#{instance}.data\" or " \
+          "\"#{self}.source_data(source_file)\""
+  end
+
+  def sort_results(results)
+    results
+  end
+
+  def target_data(target_file)
+    YAML.load_file(target_file)
+  end
+
+  def target_content(data)
+    data.to_yaml
+  end
+
+  def target_file_extname
+    '.yaml'
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/shared_examples/spec_paths.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gem_support/rspec/spec_paths_controller'
+require 'eac_ruby_utils/core_ext'
+
+RSpec.shared_context 'spec_paths' do |the_spec_file|
+  cattr_accessor :spec_paths_controller
+  self.spec_paths_controller = EacRubyGemSupport::Rspec::SpecPathsController.new(self,
+                                                                                 the_spec_file)
+
+  %i[fixtures_directory spec_directory spec_file].each do |m|
+    let(m) { self.class.spec_paths_controller.send(m) }
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/source_target_fixtures_controller.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_gem_support/source_target_fixtures'
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemSupport
+  module Rspec
+    class SourceTargetFixturesController
+      enable_simple_cache
+      common_constructor :spec_paths_controller
+      delegate :example, to: :spec_paths_controller
+
+      def fixtures_dir
+        if example.respond_to?(:fixtures_dir)
+          example.fixtures_dir
+        else
+          spec_paths_controller.fixtures_directory
+        end
+      end
+
+      def write_target_fixtures?
+        ENV['WRITE_TARGET_FIXTURES'].to_bool
+      end
+
+      private
+
+      def source_target_fixtures_uncached
+        ::EacRubyGemSupport::SourceTargetFixtures.new(fixtures_dir)
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/spec_paths_controller.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemSupport
+  module Rspec
+    class SpecPathsController
+      # @!attribute [r] spec_file
+      #   @return [Pathname]
+
+      # @!method initialize(example, spec_file)
+      #   @param example [RSpec::Core::ExampleGroup]
+      #   @param spec_file [Pathname]
+      common_constructor :example, :spec_file do
+        self.spec_file = spec_file.to_pathname
+      end
+
+      # @return [Pathname]
+      def fixtures_directory
+        spec_directory.join(spec_file.basename('.*')).basename_sub { |b| "#{b}_files" }
+      end
+
+      # @return [Pathname]
+      def spec_directory
+        spec_file.parent
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/rspec/specs/rubocop.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'rspec'
+require 'rubocop'
+
+module EacRubyGemSupport
+  module Rspec
+    module Specs
+      module Rubocop
+        def describe_rubocop # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          this = self
+          ::RSpec.describe ::RuboCop do
+            before do
+              ::RuboCop::ConfigLoader.ignore_parent_exclusion = true
+            end
+
+            let(:root_path) { this.app_root_path }
+            let(:config_store) do
+              r = ::RuboCop::ConfigStore.new
+              r.for(root_path)
+              r
+            end
+            let(:runner) { ::RuboCop::Runner.new({}, config_store) }
+
+            it 'rubocop return ok' do
+              expect(::Dir.chdir(root_path) { runner.run([]) }).to eq(true)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/source_target_fixtures/source_target_file.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemSupport
+  class SourceTargetFixtures
+    class SourceTargetFile
+      common_constructor :owner, :basename
+
+      def source
+        owner.source_file(basename)
+      end
+
+      def target
+        owner.target_file(basename)
+      end
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/source_target_fixtures.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyGemSupport
+  # Lists pairs of source/target files in a directory.
+  class SourceTargetFixtures
+    class << self
+      def source_target_basename(file)
+        m = /^(.+)\.(?:source|target)(?:\..+)?$/.match(File.basename(file))
+        m ? m[1] : nil
+      end
+    end
+
+    # @!attribute [r] fixtures_directory
+    #   @return [String]
+
+    # @!method initialize(fixtures_directory)
+    #   @param fixtures_directory [Pathname]
+    common_constructor :fixtures_directory
+
+    def source_target_files
+      sources_targets_basenames.map do |basename|
+        ::EacRubyGemSupport::SourceTargetFixtures::SourceTargetFile.new(self, basename)
+      end
+    end
+
+    def source_files
+      r = []
+      source_target_files.each do |st|
+        r << st.source if st.source
+      end
+      r
+    end
+
+    def target_files
+      r = []
+      source_target_files.each do |st|
+        r << st.target if st.target
+      end
+      r
+    end
+
+    def target_file(basename)
+      fixture_file(basename, 'target')
+    end
+
+    def source_file(basename)
+      fixture_file(basename, 'source')
+    end
+
+    private
+
+    def fixture_file(basename, suffix)
+      prefix = "#{basename}.#{suffix}"
+      Dir.foreach(fixtures_directory) do |item|
+        next if %w[. ..].include?(item)
+        return File.expand_path(item, fixtures_directory) if item.starts_with?(prefix)
+      end
+      nil
+    end
+
+    def sources_targets_basenames
+      basenames = Set.new
+      Dir.foreach(fixtures_directory) do |item|
+        next if %w[. ..].include?(item)
+
+        b = self.class.source_target_basename(item)
+        basenames << b if b.present?
+      end
+      basenames
+    end
+  end
+end

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support/version.rb

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

data/sub/eac_ruby_gem_support/lib/eac_ruby_gem_support.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils'
+EacRubyUtils::RootModuleSetup.perform __FILE__
+
+require 'super_diff'
+require 'super_diff/active_support'
+require 'super_diff/rspec'
+
+module EacRubyGemSupport
+end

data/sub/eac_ruby_gem_support/spec/lib/eac_ruby_gem_support/rspec/helpers/filesystem_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyGemSupport::Rspec::Helpers::Filesystem do
+  describe '#temp_file' do
+    let(:a_temp_file) { temp_file }
+
+    it { expect(temp_file).to be_file }
+  end
+
+  describe '#temp_dir' do
+    let(:a_temp_dir) { temp_dir }
+
+    it { expect(temp_dir).to be_directory }
+  end
+
+  describe '#temp_copy' do
+    let(:source_file) { Pathname.new(__FILE__) }
+    let(:source_dir) { source_file.parent }
+    let(:file_copy) { temp_copy(source_file) }
+    let(:dir_copy) { temp_copy(source_dir) }
+
+    it { expect(file_copy).to be_file }
+    it { expect(file_copy.read).to eq(source_file.read) }
+    it { expect(file_copy).not_to eq(source_file) }
+
+    it { expect(dir_copy).to be_directory }
+    it { expect(dir_copy.join(source_file.basename).read).to eq(source_file.read) }
+    it { expect(dir_copy).not_to eq(source_dir) }
+  end
+end

data/sub/eac_ruby_gem_support/spec/lib/eac_ruby_gem_support/rspec/shared_examples/source_target_fixtures_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+RSpec.describe "RSpec.shared_examples('source_target_fixtures')" do # rubocop:disable RSpec/DescribeClass
+  include_examples 'source_target_fixtures', __FILE__
+
+  def source_data(file)
+    YAML.load_file(file)
+  end
+end

data/sub/eac_ruby_gem_support/spec/lib/eac_ruby_gem_support/rspec/shared_examples/source_target_fixtures_spec_files/one.source.yaml

@@ -0,0 +1,2 @@
+---
+value: Test!

data/sub/eac_ruby_gem_support/spec/lib/eac_ruby_gem_support/rspec/shared_examples/source_target_fixtures_spec_files/one.target.yaml

@@ -0,0 +1,2 @@
+---
+value: Test!

data/sub/eac_ruby_gem_support/spec/lib/eac_ruby_gem_support/rspec/shared_examples/spec_paths_spec.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+RSpec.describe "RSpec.shared_examples('spec_paths')" do # rubocop:disable RSpec/DescribeClass
+  include_context 'spec_paths', __FILE__
+
+  it do
+    expect(spec_file).to eq(__FILE__.to_pathname)
+  end
+
+  it do
+    expect(spec_directory).to eq(__FILE__.to_pathname.dirname)
+  end
+
+  it do
+    expect(fixtures_directory).to eq(__FILE__.to_pathname.dirname.join('spec_paths_spec_files'))
+  end
+end