eac_tools 0.122.0 → 0.123.0

data/sub/eac_cli/spec/lib/eac_cli/runner_with/confirmation/input_result_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+RSpec.describe EacCli::RunnerWith::Confirmation::InputResult do
+  let(:speaker) { EacCli::Speaker.new }
+
+  around do |example|
+    EacRubyUtils::Speaker.context.on(speaker) { example.run }
+  end
+
+  before do
+    allow(speaker).to receive(:warn) { |message| raise(message.to_s) }
+  end
+
+  [
+    ['n', false, false],
+    ['N', false, true],
+    ['y', true, false],
+    ['Y', true, true]
+  ].each do |test_values|
+    user_input, confirm, for_all = test_values # rubocop:disable RSpec/LeakyLocalVariable
+    context "when user input is \"#{user_input}\"" do
+      let(:instance) { described_class.by_message('A message') }
+
+      before do
+        allow(speaker).to receive(:request_string).and_return(user_input)
+      end
+
+      it { expect(instance.confirm?).to eq(confirm) }
+      it { expect(instance.for_all?).to eq(for_all) }
+    end
+  end
+end

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

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+RSpec.describe EacCli::RunnerWith::Help::Layout do
+  describe '#list_section' do
+    {
+      ['Options', ['Option A', 'Option B']] => <<~TEXT
+        Options:
+          Option A
+          Option B
+      TEXT
+    }.each do |source, expected|
+      context "when source is #{source}" do
+        it do
+          expect(described_class.list_section(*source)).to eq(expected)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+# 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

@@ -0,0 +1,26 @@
+# 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

@@ -0,0 +1,16 @@
+---
+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

@@ -0,0 +1,22 @@
+== 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

@@ -0,0 +1,55 @@
+# 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

@@ -0,0 +1,78 @@
+# 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

@@ -0,0 +1,95 @@
+# 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

@@ -0,0 +1,34 @@
+# 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_cli/spec/spec_helper.rb

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

data/sub/eac_config/.gitrepo

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

data/sub/eac_config/.rspec

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

data/sub/eac_config/.rubocop.yml

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

data/sub/eac_config/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_docker/eac_docker.gemspec → eac_config/eac_config.gemspec}

@@ -2,19 +2,19 @@
 
 $LOAD_PATH.push File.expand_path('lib', __dir__)
 
-require 'eac_docker/version'
+require 'eac_config/version'
 
 Gem::Specification.new do |s|
-  s.name        = 'eac_docker'
-  s.version     = EacDocker::VERSION
+  s.name        = 'eac_config'
+  s.version     = EacConfig::VERSION
   s.authors     = ['Put here the authors']
   s.summary     = 'Put here de description.'
 
   s.files = Dir['{lib}/**/*']
   s.required_ruby_version = '>= 3.2' # rubocop:disable Gemspec/RequiredRubyVersion
 
+  s.add_dependency 'addressable', '~> 2.9'
   s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
-  s.add_dependency 'eac_templates', '~> 0.9'
 
   s.add_development_dependency 'eac_ruby_gem_support', '~> 0.15'
 end

data/sub/eac_config/lib/eac_config/entries.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module EacConfig
+  class Entries
+    enable_memoized
+    common_constructor :root_node, :path do
+      self.path = ::EacConfig::EntryPath.assert(path)
+    end
+
+    def to_s
+      "#{self.class}[RootNode: #{root_node}, Path: #{path}]"
+    end
+
+    # @return [Array<EacConfig::Entries>]
+    memoize def node_entries
+      node_entries_from_root + node_entries_from_load_path
+    end
+
+    # @return [Array<EacConfig::Entries>]
+    memoize def node_entries_from_load_path
+      root_node.recursive_loaded_nodes.flat_map { |loaded_node| loaded_node.self_entries(path) }
+    end
+
+    # @return [Array<EacConfig::Entries>]
+    memoize def node_entries_from_root
+      root_node.self_entries(path)
+    end
+  end
+end

data/sub/eac_config/lib/eac_config/entry/not_found_error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module EacConfig
+  class Entry
+    class NotFoundError < ::RuntimeError
+      def initialize(entry)
+        super("Entry #{entry} not found")
+      end
+    end
+  end
+end

data/sub/eac_config/lib/eac_config/entry.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module EacConfig
+  class Entry
+    enable_memoized
+    common_constructor :root_node, :path do
+      self.path = ::EacConfig::EntryPath.assert(path)
+    end
+
+    def found?
+      node_entry.if_present(false, &:found?)
+    end
+
+    def found_node
+      node_entry.if_present(&:node)
+    end
+
+    def secret_value
+      node_entry.if_present(&:secret_value)
+    end
+
+    def to_s
+      "#{self.class}[RootNode: #{root_node}, Path: #{path}]"
+    end
+
+    def value
+      node_entry.if_present(&:value)
+    end
+
+    def value!
+      return value if found?
+
+      raise ::EacConfig::Entry::NotFoundError, self
+    end
+
+    def value=(a_value)
+      write_node.self_entry(path).value = a_value
+    end
+
+    def write_node
+      root_node.write_node || root_node
+    end
+
+    private
+
+    memoize def node_entry
+      node_entry_from_root || node_entry_from_load_path
+    end
+
+    memoize def node_entry_from_load_path
+      root_node.recursive_loaded_nodes.lazy.map { |loaded_node| loaded_node.self_entry(path) }
+        .find(&:found?)
+    end
+
+    memoize def node_entry_from_root
+      e = root_node.self_entry(path)
+      e.found? ? e : nil
+    end
+  end
+end