eac_tools 0.117.5 → 0.118.0

data/sub/eac_cli/spec/lib/eac_cli/runner_with/help_spec.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::RunnerWith::Help do
-  let(:runner) do
-    the_module = described_class
-    Class.new do
-      include the_module
-
-      runner_definition do
-        desc 'A stub runner.'
-        pos_arg :a_argument
-      end
-
-      def run; end
-    end
-  end
-
-  [
-    ['--help'],
-    ['trash-pos-arg-before', '--help', 'trash-pos-arg-after', '--any-option', '-XYZ',
-     'other-trash-arg']
-  ].each do |runner_argv|
-    context "when runner ARGV is #{runner_argv}" do
-      let(:instance) { runner.create(argv: runner_argv) }
-      let(:expected_output_source) do
-        <<~OUTPUT
-          A stub runner.
-
-          Usage:
-            __PROGRAM__ [options] <a_argument>
-            __PROGRAM__ --help
-
-          Options:
-            -h --help    Show help.
-        OUTPUT
-      end
-      let(:expected_output) do
-        expected_output_source.gsub('__PROGRAM__', instance.program_name)
-      end
-
-      it 'show help text' do
-        expect { instance.run_run }.to output(expected_output).to_stdout_from_any_process
-      end
-    end
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/runner_with/output_item/asciidoc_formatter_spec.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::RunnerWith::OutputItem::AsciidocFormatter do
-  include_examples 'source_target_fixtures', __FILE__
-
-  # @return [String]
-  def source_data(source_file)
-    described_class.new(Psych.load_file(source_file)).to_output
-  end
-
-  # @param data [String]
-  # @return [String]
-  def target_content(data)
-    data
-  end
-
-  # @return [String]
-  def target_data(target_file)
-    target_file.to_pathname.read
-  end
-
-  # @return [String]
-  def target_file_extname
-    '.adoc'
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/runner_with/output_item/asciidoc_formatter_spec_files/gb_1.source.yaml

@@ -1,16 +0,0 @@
----
-Finalizado:
-- Battle Arena Toshinden
-- Kaeru no Tame ni Kane wa Naru
-- The Legend of Zelda - Link's Awakening
-Gostado:
-  '':
-  - Metroid II - Return of Samus
-  Mario:
-    '':
-    - Mario's Picross
-    Super Mario Land:
-    - Super Mario Land
-    - Super Mario Land 2 - 6 Golden Coins
-  TMNT:
-  - Teenage Mutant Ninja Turtles III - Radical Rescue

data/sub/eac_cli/spec/lib/eac_cli/runner_with/output_item/asciidoc_formatter_spec_files/gb_1.target.adoc

@@ -1,22 +0,0 @@
-== Finalizado
-
-* Battle Arena Toshinden
-* Kaeru no Tame ni Kane wa Naru
-* The Legend of Zelda - Link's Awakening
-
-== Gostado
-
-* Metroid II - Return of Samus
-
-=== Mario
-
-* Mario's Picross
-
-==== Super Mario Land
-
-* Super Mario Land
-* Super Mario Land 2 - 6 Golden Coins
-
-=== TMNT
-
-* Teenage Mutant Ninja Turtles III - Radical Rescue

data/sub/eac_cli/spec/lib/eac_cli/runner_with/output_list_spec.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::RunnerWith::OutputList do
-  let(:runner) do
-    the_module = described_class
-    Class.new do
-      include the_module
-
-      def run
-        run_output
-      end
-
-      def list_columns
-        %w[id name]
-      end
-
-      def list_rows
-        [[1, 'João'], [2, 'Maria']].map { |v| Struct.new(:id, :name).new(*v) }
-      end
-    end
-  end
-
-  let(:instance) { runner.create(argv: runner_argv) }
-
-  {
-    'csv' => <<~OUTPUT,
-      id,name
-      1,João
-      2,Maria
-    OUTPUT
-    'tty' => <<~OUTPUT,
-      ┌──┬─────┐
-      │id│name │
-      │1 │João │
-      ├──┼─────┤
-      │2 │Maria│
-      └──┴─────┘
-    OUTPUT
-    'yaml' => <<~OUTPUT
-      ---
-      - id: '1'
-        name: João
-      - id: '2'
-        name: Maria
-    OUTPUT
-  }.each do |format, expected_output|
-    context "with --format=#{format}" do
-      let(:runner_argv) { ['--format', format] }
-
-      it do
-        expect { instance.run }.to output(expected_output).to_stdout_from_any_process
-      end
-    end
-  end
-end

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

@@ -1,78 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::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', EacCli::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', EacCli::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_cli/spec/lib/eac_cli/runner_with/subcommands_spec.rb

@@ -1,95 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::RunnerWith::Subcommands do
-  let(:parent_runner) do
-    the_module = described_class
-    the_child = child_runner
-    Class.new do
-      include the_module
-
-      const_set('ChildCmd', the_child)
-
-      runner_definition do
-        desc 'A stub root runner.'
-        arg_opt '-r', '--root-var', 'A root variable.'
-        subcommands
-      end
-
-      delegate :root_var, to: :parsed
-      for_context :method_in_parent_runner
-
-      def method_in_parent_runner; end
-    end
-  end
-
-  let(:child_runner) do
-    Class.new do
-      include EacCli::Runner
-
-      runner_definition do
-        bool_opt '-c', '--child-opt', 'A boolean option.'
-        pos_arg :child_var
-      end
-
-      def run
-        runner_context.call(:method_in_parent_runner)
-        method_in_parent_runner
-      end
-    end
-  end
-
-  let(:instance) { parent_runner.create(argv: parent_argv) }
-
-  context 'when subcommand is supplied' do
-    let(:parent_argv) { %w[--root-var 123 child-cmd --child-opt 456] }
-
-    it { expect(instance.parsed.root_var).to eq('123') }
-    it { expect(instance.parsed.subcommand).to eq('child-cmd') }
-    it { expect(instance.parsed.subcommand_args).to eq(%w[--child-opt 456]) }
-    it { expect(instance.subcommand_runner.parsed.child_opt).to be(true) }
-    it { expect(instance.subcommand_runner.parsed.child_var).to eq('456') }
-
-    it do
-      expect { instance.run_run }.not_to raise_error
-    end
-  end
-
-  context 'when subcommand is not supplied' do
-    let(:instance) { parent_runner.create(%w[456]) }
-
-    it do
-      expect { instance.run }.to raise_error(EacCli::Parser::Error)
-    end
-  end
-
-  context 'with help' do
-    let(:instance) { parent_runner.create(%w[--help]) }
-    let(:expected_output_source) do
-      <<~OUTPUT
-        A stub root runner.
-
-        Usage:
-          __PROGRAM__ [options] __SUBCOMMANDS__ [<subcommand_args>...]
-          __PROGRAM__ --help
-
-        Options:
-          -r --root-var=<value>    A root variable.
-          -h --help    Show help.
-
-        Subcommands:
-          child-cmd
-      OUTPUT
-    end
-    let(:expected_output) do
-      expected_output_source.gsub('__PROGRAM__', instance.program_name)
-    end
-
-    before do
-      parent_runner.include(EacCli::RunnerWith::Help)
-    end
-
-    it 'show help text' do
-      expect { instance.run_run }.to output(expected_output).to_stdout_from_any_process
-    end
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/speaker_spec.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::Speaker do
-  let(:instance) { described_class.new }
-
-  before do
-    allow(instance).to receive(:warn) { |message| raise(message.to_s) }
-  end
-
-  describe '#input' do
-    it 'recover value from hash list' do
-      allow(instance).to receive(:request_string).and_return('opt1')
-      list = { opt1: 'value1', opt2: 'value2' }
-      expect(instance.input('Question', list: list)).to eq('value1')
-    end
-
-    it 'recover value from array list' do
-      allow(instance).to receive(:request_string).and_return('OPT1')
-      list = %w[opt1 opt2]
-      expect(instance.input('Question', list: list)).to eq('opt1')
-    end
-
-    {
-      'yes' => true, 'y' => true, 'Y' => true, 'NO' => false, 'no' => false, 'n' => false
-    }.each do |input, expected|
-      context "when bool: true and input is \"#{input}\"" do
-        it "return #{expected}" do
-          allow(instance).to receive(:request_string).and_return(input)
-          expect(instance.input('Question', bool: true)).to eq(expected)
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/.avm.yaml

@@ -1,3 +0,0 @@
----
-locale: en
-bundle_test_command: exec rspec

data/sub/eac_ruby_utils/.gitignore

@@ -1,4 +0,0 @@
-Gemfile.local
-Gemfile.lock
-doc/
-.yardoc/

data/sub/eac_ruby_utils/.gitrepo

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

data/sub/eac_ruby_utils/.rspec

@@ -1 +0,0 @@
---require spec/spec_helper --color --format doc --default-path . --pattern 'spec/**/*_spec.rb'

data/sub/eac_ruby_utils/.rubocop.yml

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

data/sub/eac_ruby_utils/.yardopts

@@ -1 +0,0 @@
---no-private --protected lib/**/*.rb

data/sub/eac_ruby_utils/Gemfile

@@ -1,8 +0,0 @@
-# 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_utils/MIT-LICENCE

@@ -1,16 +0,0 @@
-Copyright 2018 Eduardo Henrique Bogoni <eduardobogoni@gmail.com>
-
-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 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_utils/README.rdoc

@@ -1,3 +0,0 @@
-= E.A.C. Ruby Utilities
-
-Utilities for E.A.C.'s Ruby projects.

data/sub/eac_ruby_utils/eac_ruby_utils.gemspec

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.push File.expand_path('lib', __dir__)
-
-# Maintain your gem's version:
-require 'eac_ruby_utils/version'
-
-# Describe your gem and declare its dependencies:
-Gem::Specification.new do |s|
-  s.name        = 'eac_ruby_utils'
-  s.version     = EacRubyUtils::VERSION
-  s.authors     = ['Esquilo Azul Company']
-  s.summary     = 'Utilities for E.A.C.\'s Ruby projects.'
-  s.license     = 'MIT'
-
-  s.files = Dir['{lib}/**/*', 'MIT-LICENSE', 'README.rdoc']
-  s.required_ruby_version = '>= 3.2'
-
-  s.add_dependency 'activesupport', '>= 6.1.7.10'
-  s.add_dependency 'addressable', '~> 2.9'
-  s.add_dependency 'bundler'
-  s.add_dependency 'memoized', '~> 1.1', '>= 1.1.3'
-  s.add_dependency 'net-ssh', '~> 4.2'
-  s.add_dependency 'zeitwerk', '~> 2.8', '>= 2.8.2'
-  s.add_development_dependency 'avm-eac_ubuntu_base0', '~> 0.7', '>= 0.7.1'
-  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.14'
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_abstract.rb

@@ -1,100 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/module_ancestors_variable/hash'
-require 'eac_ruby_utils/patches/class/self_included_modules'
-require 'eac_ruby_utils/patches/module/common_concern'
-require 'eac_ruby_utils/unimplemented_method_error'
-
-module EacRubyUtils
-  # Support to abstract methods.
-  #
-  # Usage:
-  #
-  #   require 'eac_ruby_utils/acts_as_abstract'
-  #
-  #   class BaseClass
-  #     include EacRubyUtils::ActsAsAbstract
-  #
-  #     abstract_methods :mymethod
-  #   end
-  #
-  #   BaseClass.new.mymethod # raise "Abstract method: mymethod"
-  #
-  #   class SubClass
-  #     def mymethod
-  #       "Implemented"
-  #     end
-  #   end
-  #
-  #   SubClass.new.mymethod # return "Implemented"
-  module ActsAsAbstract
-    common_concern
-
-    class << self
-      def abstract?(a_class)
-        a_class.self_included_modules.include?(::EacRubyUtils::ActsAsAbstract)
-      end
-    end
-
-    module ClassMethods
-      # @param name [Symbol]
-      # @param arguments [Enumerable<Symbol>]
-      # @return [void]
-      def abstract_method(name, *arguments)
-        abstract_methods_hash[name.to_sym] = arguments
-      end
-
-      # @param methods_names [Enumerable<Object>] Each item can be a symbolizable or a hash.
-      # @return [void]
-      def abstract_methods(*methods_names)
-        methods_names.each do |method_name|
-          if method_name.is_a?(::Hash)
-            abstract_methods_from_hash(method_name)
-          else
-            abstract_method(method_name)
-          end
-        end
-      end
-
-      private
-
-      # @param hash [Hash]
-      # @return [void]
-      def abstract_methods_from_hash(hash)
-        hash.each { |name, arguments| abstract_method(name, *arguments) }
-      end
-
-      # @return [Hash<Symbol, Array]
-      def abstract_methods_hash
-        @abstract_methods_hash ||=
-          ::EacRubyUtils::ModuleAncestorsVariable::Hash.new(self, __method__)
-      end
-    end
-
-    module InstanceMethods
-      def respond_to_missing?(method_name, include_private = false)
-        super || abstract_method?(method_name)
-      end
-
-      def method_missing(method_name, *arguments, &)
-        raise_abstract_method(method_name) if abstract_method?(method_name)
-
-        super
-      end
-
-      # @param method_name [Symbol]
-      # @return [Boolean]
-      def abstract_method?(method_name)
-        return false if self.class.method_defined?(method_name)
-
-        self.class.send(:abstract_methods_hash).key?(method_name.to_sym)
-      end
-
-      def raise_abstract_method(method_name, arguments = [])
-        raise ::EacRubyUtils::UnimplementedMethodError,
-              "Abstract method #{method_name}(#{arguments.join(', ')}) hit in " \
-              "#{self}\" (Class: #{self.class})"
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/array_accessor.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/enumerable_accessor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class ArrayAccessor < ::EacRubyUtils::ActsAsImmutable::EnumerableAccessor
-      INITIAL_VALUE = [].freeze
-
-      # @param value [Object]
-      # @return [Array]
-      def immutable_value_set_assert(value)
-        return value if value.is_a?(::Array)
-        return value.to_a if value.respond_to?(:to_a)
-
-        Array(value)
-      end
-
-      # @return [Array] A empty array.
-      def initial_value
-        INITIAL_VALUE
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/base_accessor.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/object/if_respond'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class BaseAccessor
-      FILTER_GET_METHOD_NAME_FORMAT = '%s_get_filter'
-      FILTER_SET_METHOD_NAME_FORMAT = '%s_set_filter'
-
-      common_constructor :name do
-        self.name = name.to_sym
-      end
-
-      def duplicate_object(object)
-        accessor_new_value = yield(immutable_value_get(object))
-        new_values = object.send(:immutable_values_get).merge(name => accessor_new_value)
-        r = object.class.new(*object.immutable_constructor_args)
-        r.send(:immutable_values_set, new_values)
-        r
-      end
-
-      def immutable_value_get(object)
-        object.send(:immutable_values_get)[name]
-      end
-
-      # @param object [Object]
-      # @return [Object]
-      def immutable_value_get_filtered(object)
-        r = immutable_value_get(object)
-        if object.respond_to?(immutable_value_get_filtered_method_name, true)
-          r = object.send(immutable_value_get_filtered_method_name, r)
-        end
-        r
-      end
-
-      # @return [Symbol]
-      def immutable_value_get_filtered_method_name
-        format(FILTER_GET_METHOD_NAME_FORMAT, name)
-      end
-
-      # @param object [Object]
-      # @return [Object]
-      def immutable_value_set_filtered(object, value)
-        if object.respond_to?(immutable_value_set_filtered_method_name, true)
-          value = object.send(immutable_value_set_filtered_method_name, value)
-        end
-        immutable_value_set(object, value)
-      end
-
-      # @return [Symbol]
-      def immutable_value_set_filtered_method_name
-        format(FILTER_SET_METHOD_NAME_FORMAT, name)
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/boolean_accessor.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/common_accessor'
-require 'eac_ruby_utils/patches/class/common_constructor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class BooleanAccessor < ::EacRubyUtils::ActsAsImmutable::CommonAccessor
-      def apply(klass)
-        super
-        accessor = self
-        klass.send(:define_method, "#{name}?") { send(accessor.name) }
-      end
-    end
-  end
-end