eac_tools 0.118.0 → 0.120.0

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacRubyBase1::Sources::Base, '#bundler' do
+  let(:mygem_path) { Pathname.new(__dir__).join('bundler_spec_files', 'mygem') }
+  let(:mygem) { described_class.new(mygem_path) }
+
+  before do
+    mygem.bundle.execute!
+  end
+
+  describe '#bundle' do
+    specify do
+      expect(mygem.bundle('exec', 'myrunner').execute!).to include('My Runner')
+    end
+  end
+
+  describe '#gemfile_source' do
+    it do
+      expect(mygem.gemfile_source).to eq(Addressable::URI.parse('https://rubygems.org'))
+    end
+  end
+
+  describe '#rake' do
+    specify do
+      expect(mygem.rake('mygem:stub').execute!).to include('Stub!')
+    end
+  end
+end

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/Gemfile

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

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/Gemfile.lock

@@ -0,0 +1,19 @@
+PATH
+  remote: .
+  specs:
+    mygem (1.0.0)
+      rake
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (13.0.6)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  mygem!
+
+BUNDLED WITH
+   2.3.17

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks' # rubocop:disable RSpec/Output
+end
+
+namespace :mygem do
+  desc 'A stub task.'
+  task :stub do # rubocop:disable Rails/RakeEnvironment
+    puts 'Stub!' # rubocop:disable RSpec/Output
+  end
+end

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/exe/myrunner

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift("#{__dir__}/../lib")
+puts 'My Runner' # rubocop:disable RSpec/Output

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/lib/mygem/version.rb

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

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/lib/mygem.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base1'
+EacRubyBase1::RootModuleSetup.perform __FILE__
+
+module Mygem
+end

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base/bundler_spec_files/mygem/mygem.gemspec

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+Gem::Specification.new do |s|
+  s.name        = 'mygem'
+  s.version     = '1.0.0'
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Stub gem.'
+
+  s.files = Dir['{exe,lib}/**/*', 'Gemfile', 'Rakefile']
+  s.bindir = 'exe'
+  s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  s.required_ruby_version = '>= 3.4'
+
+  s.add_dependency 'rake'
+end

data/sub/avm-eac_ruby_base1/spec/lib/avm/eac_ruby_base1/sources/base_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacRubyBase1::Sources::Base do
+  let(:instance) { avm_eac_ruby_base1_source }
+
+  include_examples 'in_avm_registry', 'sources'
+
+  it { expect(instance).to be_a(described_class) }
+
+  it do
+    expect(instance.version).to eq(Avm::VersionNumber.new('0.0.0'))
+  end
+end

data/sub/avm-eac_ruby_base1/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'avm/eac_ruby_base1'
+require 'eac_ruby_gem_support'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__)).stub_avm_contexts

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/gemspec.template

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require '%%LIB_PATH%%/version'
+
+Gem::Specification.new do |s|
+  s.name        = '%%NAME%%'
+  s.version     = %%ROOT_MODULE%%::VERSION
+  s.authors     = ['Put here the authors']
+  s.summary     = 'Put here de description.'
+
+  s.files = %%gemspec_files_value%%
+  s.required_ruby_version = '%%require_ruby_version%%'%%gemspec_extra%%
+
+%%COMMON_DEPENDENCIES%%
+
+%%DEVELOPMENT_DEPENDENCIES%%
+end

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/root_lib.template

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base1'
+EacRubyBase1::RootModuleSetup.perform __FILE__%%ROOT_MODULE_SETUP_BLOCK%%

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/static/.gitignore

@@ -0,0 +1,2 @@
+/Gemfile.local
+/Gemfile.lock

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/static/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/static/.rubocop.yml

@@ -0,0 +1,3 @@
+---
+inherit_gem:
+  eac_ruby_gem_support: ".rubocop.yml"

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/static/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/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/static/spec/spec_helper.rb.template

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require '%%LIB_PATH%%'
+require 'eac_ruby_gem_support'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__))

data/sub/avm-eac_ruby_base1/template/avm/eac_ruby_base1/source_generators/base/version.template

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+%%ROOT_MODULE_OPEN%%
+%%ROOT_MODULE_INNER_IDENTATION%%VERSION = '0.0.0'
+%%ROOT_MODULE_CLOSE%%

data/sub/eac_ruby_gem_support/.gitrepo

@@ -0,0 +1,7 @@
+[subrepo]
+  cmdver = 0.4.9
+  commit = bd6e5cd64b181081fea95489ec08becaf199590a
+  method = merge
+  parent = 612e86be6a06a2b51d4bbaca1311752dafbe02cd
+  branch = master
+  remote = https://github.com/esquilo-azul/eac_ruby_gem_support.git

data/sub/eac_ruby_gem_support/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/sub/eac_ruby_gem_support/.rubocop.yml

@@ -0,0 +1,45 @@
+plugins:
+  - rubocop-rails
+  - rubocop-rspec
+AllCops:
+  NewCops: enable
+  TargetRailsVersion: 7.2
+  TargetRubyVersion: 3.4
+  Exclude:
+    - 'sub/**/*'
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+Gemspec/RequireMFA:
+  Enabled: false
+Metrics/BlockLength:
+  Exclude:
+    - '**/*.gemspec'
+    - 'spec/**/*_spec.rb'
+Layout/LineLength:
+  Max: 100
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented_relative_to_receiver
+Rails/DynamicFindBy:
+  Enabled: false
+Rails/Exit:
+  Enabled: false
+Rails/FindEach:
+  Enabled: false
+Rails/Output:
+  Enabled: false
+Rails/SkipsModelValidations:
+  Enabled: false
+Rails/TimeZone:
+  Enabled: false
+RSpec/IncludeExamples:
+  Enabled: false # TODO: fix error with source_target_fixtures and it_behaves_like
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
+RSpec/NestedGroups:
+  Enabled: false
+Style/AsciiComments:
+  Enabled: false
+Style/Documentation:
+  Enabled: false
+Style/SafeNavigation: # Bug with rubocop's version 1.76.0
+  Enabled: false

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,27 @@
+# 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.glob('{lib}/**/*', File::FNM_DOTMATCH)
+              .reject { |f| ['.', '..'].include?(File.basename(f)) } +
+            ['.rubocop.yml']
+
+  s.required_ruby_version = '>= 3.2' # rubocop:disable Gemspec/RequiredRubyVersion
+
+  s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
+  s.add_dependency 'rspec', '~> 3.13', '>= 3.13.2'
+  s.add_dependency 'rubocop', '~> 1.88', '>= 1.88.2'
+  s.add_dependency 'rubocop-rails', '~> 2.36'
+  s.add_dependency 'rubocop-rspec', '~> 3.10', '>= 3.10.2'
+  s.add_dependency 'super_diff', '~> 0.19'
+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/rubocop.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'rspec'
+require 'rubocop'
+
+module EacRubyGemSupport
+  module Rspec
+    module Setup
+      module Rubocop
+        RUN_LAST_METADATA_KEY = :eac_ruby_gem_support_rubocop_check
+
+        def describe_rubocop # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          this = self
+          ::RSpec.describe ::RuboCop, RUN_LAST_METADATA_KEY => true 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
+
+        # @return [void]
+        def setup_rubocop
+          setup_rubocop_last
+          describe_rubocop unless specific_files_requested?
+        end
+
+        # @return [void]
+        def setup_rubocop_last
+          previous_strategy = ::RSpec.configuration.ordering_registry.fetch(:global)
+          ::RSpec.configure do |config|
+            config.register_ordering(:global) do |list|
+              ordered = previous_strategy.order(list)
+              last, others = ordered.partition { |item| item.metadata[RUN_LAST_METADATA_KEY] }
+              others + last
+            end
+          end
+        end
+
+        # @return [Boolean]
+        def specific_files_requested?
+          config = ::RSpec.configuration
+          files_or_directories = config.instance_variable_get(:@files_or_directories_to_run)
+          default_pattern = ::RSpec::Core::Configuration.new.pattern
+          files_or_directories != [config.default_path] || config.pattern != default_pattern
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+
+module EacRubyGemSupport
+  module Rspec
+    module Setup
+      extend ::ActiveSupport::Concern
+
+      SETUPS = %w[load_path example_persistence filesystem_helper shared_examples rubocop].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
+
+      require_sub __FILE__, include_modules: true
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+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.unsafe_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,11 @@
+# frozen_string_literal: true
+
+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,29 @@
+# frozen_string_literal: true
+
+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,27 @@
+# frozen_string_literal: true
+
+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/source_target_fixtures/source_target_file.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+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