eac_tools 0.117.5 → 0.119.0

data/sub/eac_cli/lib/eac_cli/runner_with/subcommands.rb

@@ -1,122 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Subcommands
-      class << self
-        delegate :runner?, to: :'::EacCli::Runner'
-
-        # @return [Hash<String, EacCli::Runner>]
-        def subcommands_from_module(a_module)
-          a_module.constants
-            .map { |name| [name.to_s.underscore.gsub('_', '-'), a_module.const_get(name)] }
-            .select { |c| runner?(c[1]) }
-            .to_h.with_indifferent_access
-        end
-      end
-
-      common_concern do
-        include ::EacCli::Runner
-        runner_definition.singleton_class
-          .include(::EacCli::RunnerWith::Subcommands::DefinitionConcern)
-      end
-
-      EXTRA_AVAILABLE_SUBCOMMANDS_METHOD_NAME = :extra_available_subcommands
-
-      def available_subcommands
-        @available_subcommands ||= available_subcommands_auto.merge(available_subcommands_extra)
-      end
-
-      # @return [Hash<String, EacCli::Runner>]
-      def available_subcommands_auto
-        ::EacCli::RunnerWith::Subcommands.subcommands_from_module(self.class)
-      end
-
-      def available_subcommands_extra
-        if respond_to?(EXTRA_AVAILABLE_SUBCOMMANDS_METHOD_NAME, true)
-          send(EXTRA_AVAILABLE_SUBCOMMANDS_METHOD_NAME)
-        else
-          {}
-        end
-      end
-
-      def available_subcommands_to_s
-        available_subcommands.keys.sort.join(', ')
-      end
-
-      # @return [Hash<String, Enumerable<String>]
-      def help_extra_text
-        help_list_section('Subcommands', available_subcommands.keys.sort)
-      end
-
-      def method_missing(method_name, *, &)
-        return run_with_subcommand(*, &) if
-        run_with_subcommand_alias_run?(method_name)
-
-        super
-      end
-
-      def respond_to_missing?(method_name, include_private = false)
-        run_with_subcommand_alias_run?(method_name) || super
-      end
-
-      def run_with_subcommand
-        if run_subcommand?
-          if subcommand_runner.respond_to?(:run_run)
-            subcommand_runner.run_run
-          else
-            subcommand_runner.run
-          end
-        else
-          run_without_subcommand
-        end
-      end
-
-      def run_with_subcommand_alias_run?(method_name)
-        subcommands? && method_name.to_sym == :run
-      end
-
-      def run_without_subcommand
-        "Method #{__method__} should be overrided in #{self.class.name}"
-      end
-
-      def run_subcommand?
-        subcommand_name.present?
-      end
-
-      def subcommands?
-        self.class.runner_definition.subcommands?
-      end
-
-      def subcommand_args
-        parsed.fetch(::EacCli::Definition::SUBCOMMAND_ARGS_ARG)
-      end
-
-      def subcommand_class
-        available_subcommands[subcommand_name].if_present { |v| return v }
-
-        raise(::EacCli::Parser::Error.new(
-                self.class.runner_definition, runner_context.argv,
-                "Subcommand \"#{subcommand_name}\" not found " \
-                "(Available: #{available_subcommands_to_s})"
-              ))
-      end
-
-      def subcommand_name
-        parsed.fetch(::EacCli::Definition::SUBCOMMAND_NAME_ARG)
-      end
-
-      def subcommand_program
-        [program_name, subcommand_name]
-      end
-
-      def subcommand_runner
-        @subcommand_runner ||= subcommand_class.create(
-          argv: subcommand_args,
-          program_name: subcommand_program,
-          parent: self
-        )
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with_set/from_gems_registry.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class RunnerWithSet
-    class FromGemsRegistry < ::EacCli::RunnerWithSet
-      enable_memoized
-
-      MODULE_SUFFIX = 'RunnerWith'
-
-      protected
-
-      # @return [EacRubyUtils::GemsRegistry]
-      memoize def gems_registry
-        ::EacRubyUtils::GemsRegistry.new(MODULE_SUFFIX)
-      end
-
-      # @return [Enumerable<Object>]
-      def namespace_set
-        super + gems_registry.registered.map(&:registered_module)
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with_set.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class RunnerWithSet
-    class << self
-      def default
-        @default ||= ::EacCli::RunnerWithSet::FromGemsRegistry.new
-      end
-    end
-
-    def add_namespace(namespace)
-      namespace = sanitize_namespace(namespace)
-      namespace_set << namespace unless namespace_set.include?(namespace)
-      self
-    end
-
-    def item_to_module(item)
-      item.is_a?(::Module) ? item : key_to_module(item)
-    end
-
-    def namespaces
-      namespace_set.dup
-    end
-
-    private
-
-    def namespace_set
-      @namespace_set ||= []
-    end
-
-    def key_to_module(key)
-      namespace_set.lazy
-        .map { |namespace| key_to_module_in_namespace(namespace, key) }
-        .find(&:present?) ||
-        raise("Not module found with key \"#{key}\" (Namespaces: #{namespace_set})")
-    end
-
-    def key_to_module_in_namespace(namespace, key)
-      leaf_name = key.to_s.camelize.to_sym
-      namespace.const_get(leaf_name)
-    rescue ::NameError => e
-      e.receiver == namespace && e.name == leaf_name ? nil : raise(e)
-    end
-
-    def sanitize_namespace(source)
-      source.is_a?(::Module) ? source : source.to_s.constantize
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/constants.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    module Constants
-      STDERR = ::EacRubyUtils::ByReference.new { $stderr }
-      STDIN = ::EacRubyUtils::ByReference.new { $stdin }
-      STDOUT = ::EacRubyUtils::ByReference.new { $stdout }
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/input_blocked.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    class InputBlocked
-      %w[gets noecho].each do |method|
-        define_method(method) do
-          raise ::EacCli::Speaker::InputRequested,
-                "Method (\"#{method}\") was requested, but input is blocked"
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/input_requested.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    class InputRequested < ::RuntimeError
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/list.rb

@@ -1,83 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/hash_with_indifferent_access'
-
-module EacCli
-  class Speaker
-    class List
-      VALUE_STRUCT = ::Struct.new(:key, :label, :value)
-
-      class << self
-        # @param list [Array, Hash]
-        # @param options [Hash]
-        def build(list, options = {})
-          return List.new(hash_to_values(list), options) if list.is_a?(::Hash)
-          return List.new(array_to_values(list), options) if list.is_a?(::Array)
-
-          raise "Invalid list: #{list} (#{list.class})"
-        end
-
-        private
-
-        def hash_to_values(list)
-          list.map { |key, value| VALUE_STRUCT.new(key, key, value) }
-        end
-
-        def array_to_values(list)
-          list.map { |value| VALUE_STRUCT.new(value, value, value) }
-        end
-      end
-
-      DEFAULT_IGNORE_CASE = true
-
-      enable_listable
-      lists.add_symbol :option, :ignore_case
-
-      # @!attribute [r] values
-      #   @return [Array<VALUE_STRUCT>]
-      #   # @!attribute [r] options
-      #   @return [Hash]
-      # @!method initialize(values)
-      #   @param values [Array<VALUE_STRUCT>]
-      #   @param options [Hash]
-      common_constructor :values, :options, default: [{}] do
-        self.options = self.class.lists.option.hash_keys_validate!(options)
-        self.values = values.map do |v|
-          VALUE_STRUCT.new(to_key(v.key), to_label(v.label), v.value)
-        end
-      end
-
-      # @return [Boolean]
-      def ignore_case?
-        options.if_key(OPTION_IGNORE_CASE, DEFAULT_IGNORE_CASE, &:to_bool)
-      end
-
-      def valid_labels
-        values.map(&:label)
-      end
-
-      def valid_value?(value)
-        values.any? { |v| v.key == to_key(value) }
-      end
-
-      # @param value [Object]
-      # @return [String]
-      def to_key(value)
-        r = to_label(value)
-        ignore_case? ? r.downcase : r
-      end
-
-      def to_label(value)
-        value.to_s.strip
-      end
-
-      def build_value(value)
-        key = to_key(value)
-        values.each do |v|
-          return v.value if v.key == key
-        end
-        raise "Value not found: \"#{value}\" (#{values})"
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/options.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    module Options
-      common_concern do
-        enable_listable
-        lists.add_symbol :option, :out_out, :err_out, :in_in, :parent, :err_line_prefix,
-                         :ignore_case
-      end
-
-      def err_out
-        option(OPTION_ERR_OUT, $stderr)
-      end
-
-      def out_out
-        option(OPTION_OUT_OUT, $stdout)
-      end
-
-      def in_in
-        option(OPTION_IN_IN, $stdin)
-      end
-
-      # @return [Boolean]
-      def ignore_case
-        option(OPTION_IGNORE_CASE, nil)
-      end
-
-      def err_line_prefix
-        option(OPTION_ERR_LINE_PREFIX, '')
-      end
-
-      def parent
-        options[OPTION_PARENT]
-      end
-
-      def option(key, default)
-        options[key] || parent.if_present(default) { |v| v.send(__METHOD__) }
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker/request_from_list.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    class RequestFromList
-      acts_as_instance_method
-      enable_simple_cache
-      common_constructor :speaker, :question, :list_values, :noecho,
-                         :ignore_case
-
-      # @return [String]
-      def result
-        loop do
-          return list.build_value(input) if list.valid_value?(input)
-
-          speaker.warn "Invalid input: \"#{input}\" (Valid: #{list.valid_labels.join(', ')})"
-        end
-      end
-
-      protected
-
-      # @return [String]
-      def input_uncached
-        speaker.send(
-          :request_string,
-          "#{question} [#{list.valid_labels.join('/')}]",
-          noecho
-        )
-      end
-
-      # @return [EacCli::Speaker::List]
-      def list_uncached
-        list_options = {}
-        list_options[::EacCli::Speaker::List::OPTION_IGNORE_CASE] = ignore_case unless
-          ignore_case.nil?
-        ::EacCli::Speaker::List.build(list_values, list_options)
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/speaker.rb

@@ -1,114 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Speaker
-    require_sub __FILE__, include_modules: true
-    include ::EacRubyUtils::Speaker::Receiver
-
-    common_constructor :options, default: [{}] do
-      self.options = self.class.lists.option.hash_keys_validate!(options)
-    end
-
-    def puts(string = '')
-      string.to_s.each_line do |line|
-        err_out.puts(err_line_prefix.to_s + line)
-      end
-    end
-
-    def out(string = '')
-      out_out.write(string.to_s)
-    end
-
-    def error(string)
-      puts "ERROR: #{string}".white.on_red
-    end
-
-    def title(string)
-      string = string.to_s
-      puts(('-' * (8 + string.length)).green)
-      puts("--- #{string} ---".green)
-      puts(('-' * (8 + string.length)).green)
-      puts
-    end
-
-    def info(string)
-      puts string.to_s.white
-    end
-
-    def infom(string)
-      puts string.to_s.light_yellow
-    end
-
-    def warn(string)
-      puts string.to_s.yellow
-    end
-
-    # Options:
-    #   +bool+ ([Boolean], default: +false+): requires a answer "yes" or "no".
-    #   +list+ ([Hash] or [Array], default: +nil+): requires a answer from a list.
-    #   +noecho+ ([Boolean], default: +false+): does not output answer.
-    def input(question, options = {})
-      bool, list, noecho, ignore_case =
-        options.to_options_consumer.consume_all(:bool, :list, :noecho, :ignore_case)
-      if list
-        request_from_list(question, list, noecho, ignore_case)
-      elsif bool
-        request_from_bool(question, noecho)
-      else
-        request_string(question, noecho)
-      end
-    end
-
-    def infov(*args)
-      r = []
-      args.each_with_index do |v, i|
-        if i.even?
-          r << "#{v}: ".cyan
-        else
-          r.last << v.to_s
-        end
-      end
-      puts r.join(', ')
-    end
-
-    def success(string)
-      puts string.to_s.green
-    end
-
-    private
-
-    def list_value(list, input)
-      values = list_values(list)
-      return input, true unless values
-
-      [input, false] unless values.include?(input)
-    end
-
-    def list_values(list)
-      if list.is_a?(::Hash)
-        list.keys.map(&:to_s)
-      elsif list.is_a?(::Array)
-        list.map(&:to_s)
-      end
-    end
-
-    def request_from_bool(question, noecho)
-      request_from_list(question, { yes: true, y: true, no: false, n: false }, noecho, true)
-    end
-
-    def request_string(question, noecho)
-      err_out.write "#{question}: ".yellow
-      noecho ? request_string_noecho : request_string_echo
-    end
-
-    def request_string_noecho
-      r = in_in.noecho(&:gets).chomp.strip
-      err_out.write("\n")
-      r
-    end
-
-    def request_string_echo
-      in_in.gets.chomp.strip
-    end
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/definition/alternative_spec.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::Definition::Alternative do
-  let(:instance) { described_class.new }
-
-  it { expect { instance.arg_opt '-a', '--opt2', 'A argument option' }.not_to raise_error }
-  it { expect { instance.bool_opt '-b', '--opt1', 'A boolean option' }.not_to raise_error }
-  it { expect { instance.bool_opt '-b', '--no-description' }.not_to raise_error }
-  it { expect { instance.bool_opt '--opt1', 'A option without short' }.not_to raise_error }
-  it { expect { instance.bool_opt '-b', 'A option without long' }.not_to raise_error }
-  it { expect { instance.bool_opt 'A option without selectors' }.to raise_error(StandardError) }
-  it { expect { instance.options_argument(true) }.not_to raise_error }
-  it { expect { instance.pos_arg :pos1 }.not_to raise_error }
-  it { expect { instance.pos_arg :pos2, optional: true, repeat: true }.not_to raise_error }
-  it { expect { instance.subcommands }.not_to raise_error }
-end

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

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::OldConfigs do
-  describe '#entry_key_to_envvar_name' do
-    {
-      'a.entry.value' => 'A_ENTRY_VALUE',
-      'appli-cation_0.var_one' => 'APPLICATION_0_VAR_ONE'
-    }.each do |input, expected_result|
-      it { expect(described_class.entry_key_to_envvar_name(input)).to eq(expected_result) }
-    end
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/parser/alternative/subcommands_spec.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::Parser::Alternative, '#subcommands' do
-  let(:instance) { described_class.new(alternative, argv) }
-  let(:actual_parsed) { instance.parsed.to_h.symbolize_keys }
-  let(:alternative) do
-    r = EacCli::Definition::Alternative.new
-    r.bool_opt '-b', '--opt1', 'A boolean option'
-    r.arg_opt '-a', '--opt2', 'A argument option'
-    r.subcommands
-    r
-  end
-
-  context 'with all values' do
-    let(:argv) { %w[--opt1 --opt2 OPT2 CMD CMD_ARG_1 --CMD_ARG_2] }
-    let(:parsed_expected) do
-      {
-        opt1: true, opt2: 'OPT2',
-        EacCli::Definition::Alternative::SUBCOMMAND_NAME_ARG => 'CMD',
-        EacCli::Definition::Alternative::SUBCOMMAND_ARGS_ARG => %w[CMD_ARG_1 --CMD_ARG_2]
-      }
-    end
-
-    it { expect(instance.error).to be_blank }
-    it { expect(actual_parsed).to eq(parsed_expected) }
-  end
-
-  context 'with only required values' do
-    let(:argv) { %w[CMD] }
-    let(:parsed_expected) do
-      {
-        opt1: false, opt2: nil,
-        EacCli::Definition::Alternative::SUBCOMMAND_NAME_ARG => 'CMD',
-        EacCli::Definition::Alternative::SUBCOMMAND_ARGS_ARG => []
-      }
-    end
-
-    it { expect(instance.error).to be_blank }
-    it { expect(actual_parsed).to eq(parsed_expected) }
-  end
-
-  context 'without required values' do
-    let(:argv) { %w[--opt1] }
-    let(:parsed_expected) do
-      {
-        opt1: true, opt2: nil,
-        EacCli::Definition::Alternative::SUBCOMMAND_NAME_ARG => nil,
-        EacCli::Definition::Alternative::SUBCOMMAND_ARGS_ARG => []
-      }
-    end
-
-    it { expect(instance.error).to be_present }
-    it { expect(actual_parsed).to eq(parsed_expected) }
-  end
-end

data/sub/eac_cli/spec/lib/eac_cli/parser/alternative_spec.rb

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe EacCli::Parser::Alternative do
-  let(:instance) { described_class.new(alternative, argv) }
-  let(:actual_parsed) { instance.parsed.to_h.symbolize_keys }
-
-  context 'without subcommands' do
-    let(:alternative) do
-      r = EacCli::Definition::Alternative.new
-      r.bool_opt '-b', '--opt1', 'A boolean option'
-      r.arg_opt '-a', '--opt2', 'A argument option'
-      r.bool_opt '-c', '--opt3', 'A required boolean option', required: true
-      r.pos_arg :pos1
-      r.pos_arg :pos2, optional: true, repeat: true
-      r
-    end
-
-    context 'with all values' do
-      let(:argv) { %w[--opt1 --opt2 OPT2 --opt3 POS1 POS2_1 POS2_2] }
-      let(:parsed_expected) do
-        {
-          opt1: true, opt2: 'OPT2', opt3: true, pos1: 'POS1', pos2: %w[POS2_1 POS2_2]
-        }
-      end
-
-      it { expect(instance.error).to be_blank }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'with only required values' do
-      let(:argv) { %w[--opt3 POS1] }
-      let(:parsed_expected) { { opt1: false, opt2: nil, opt3: true, pos1: 'POS1', pos2: [] } }
-
-      it { expect(instance.error).to be_blank }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'with double dash' do
-      let(:argv) { %w[--opt3 POS1 -- --opt1 --] }
-      let(:parsed_expected) do
-        { opt1: false, opt2: nil, opt3: true, pos1: 'POS1', pos2: %w[--opt1 --] }
-      end
-
-      it { expect(instance.error).to be_blank }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'without required positional' do
-      let(:argv) { %w[--opt1 --opt3] }
-      let(:parsed_expected) { { opt1: true, opt2: nil, opt3: true, pos1: nil, pos2: [] } }
-
-      it { expect(instance.error).to be_present }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'without required option' do
-      let(:argv) { %w[--opt1 POS1] }
-      let(:parsed_expected) { { opt1: true, opt2: nil, opt3: false, pos1: 'POS1', pos2: [] } }
-
-      it { expect(instance.error).to be_present }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'without any required option or positional' do
-      let(:argv) { %w[] }
-      let(:parsed_expected) { { opt1: false, opt2: nil, opt3: false, pos1: nil, pos2: [] } }
-
-      it { expect(instance.error).to be_present }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-
-    context 'with excedent positional' do
-      let(:alternative) do
-        r = EacCli::Definition::Alternative.new
-        r.pos_arg :pos1
-        r
-      end
-
-      let(:argv) { %w[POS1 POS2] }
-      let(:parsed_expected) { { pos1: 'POS1' } }
-
-      it { expect(instance.error).to be_present }
-      it { expect(actual_parsed).to eq(parsed_expected) }
-    end
-  end
-end