eac_tools 0.117.5 → 0.119.0

data/sub/eac_cli/.gitrepo

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

data/sub/eac_cli/eac_cli.gemspec

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.push File.expand_path('lib', __dir__)
-
-require 'eac_cli/version'
-
-Gem::Specification.new do |s|
-  s.name        = 'eac_cli'
-  s.version     = EacCli::VERSION
-  s.authors     = ['Esquilo Azul Company']
-  s.summary     = 'Utilities to build CLI applications with Ruby.'
-
-  s.files = Dir.glob('{lib}/**/*', File::FNM_DOTMATCH)
-              .reject { |f| ['.', '..'].include?(File.basename(f)) }
-
-  s.required_ruby_version = '>= 3.2'
-
-  s.add_dependency 'clipboard', '~> 2.0'
-  s.add_dependency 'colorize', '~> 0.8', '>= 0.8.1'
-  s.add_dependency 'eac_config', '~> 0.15'
-  s.add_dependency 'eac_ruby_utils', '~> 0.131', '>= 0.131.4'
-  s.add_dependency 'tty-table', '~> 0.12'
-
-  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.14'
-end

data/sub/eac_cli/lib/eac_cli/config/entry/options.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Config < ::SimpleDelegator
-    class Entry < ::EacConfig::NodeEntry
-      class Options
-        enable_simple_cache
-        enable_listable
-
-        lists.add_symbol :type, :undefined
-
-        DEFAULT_VALUES = {
-          before_input: nil, bool: false, list: false, noecho: false, noenv: false, noinput: false,
-          required: true, store: true, type: TYPE_UNDEFINED, validator: nil
-        }.freeze
-
-        lists.add_symbol :option, *DEFAULT_VALUES.keys
-
-        common_constructor :options do
-          self.options = self.class.lists.option.hash_keys_validate!(options)
-        end
-
-        delegate :to_h, to: :options
-
-        def [](key)
-          values.fetch(key.to_sym)
-        end
-
-        def request_input_options
-          values.slice(:bool, :list, :noecho)
-        end
-
-        DEFAULT_VALUES.each do |attr, default_value|
-          define_method(attr.to_s + ([true, false].include?(default_value) ? '?' : '')) do
-            self[attr]
-          end
-        end
-
-        private
-
-        def values_uncached
-          consumer = options.to_options_consumer
-          r = {}
-          DEFAULT_VALUES.each do |key, default_value|
-            value = consumer.consume(key)
-            value = default_value if value.nil?
-            r[key] = value
-          end
-          consumer.validate
-          r
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/config/entry/undefined.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Config < ::SimpleDelegator
-    class Entry < ::EacConfig::NodeEntry
-      module Undefined
-        private
-
-        def undefined_value
-          loop do
-            entry_value = undefined_value_no_loop
-            next unless options[:validator].if_present(true) { |v| v.call(entry_value) }
-
-            return entry_value
-          end
-        end
-
-        def undefined_value_no_loop
-          input("Value for entry \"#{path}\"", options.request_input_options)
-        rescue ::EacCli::Speaker::InputRequested
-          raise ::EacConfig::Entry::NotFoundError, self
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/config/entry.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Config < ::SimpleDelegator
-    class Entry < ::EacConfig::NodeEntry
-      require_sub __FILE__, include_modules: true
-      enable_listable
-      enable_simple_cache
-      enable_speaker
-
-      common_constructor :root_node, :path, :options, super_args: -> { [root_node, path] } do
-        self.options = ::EacCli::Config::Entry::Options.new(options)
-      end
-
-      # @return [EacCli::Config]
-      def config
-        root_node
-      end
-
-      # @return [Object, nil]
-      def value
-        sub_entry.found? ? sub_value_to_return : nil
-      end
-
-      def value!
-        return sub_value_to_return if sub_entry.found?
-        return nil unless options.required?
-
-        input_value
-      end
-
-      def secret_value
-        self.class.new(config, path, options.to_h.merge(noecho: true).to_h).value
-      end
-
-      delegate :found?, :value=, to: :sub_entry
-
-      private
-
-      def sub_value_to_return
-        sub_entry.value.presence || ::EacRubyUtils::BlankNotBlank.instance
-      end
-
-      def sub_entry_uncached
-        config.sub.entry(path)
-      end
-
-      def input_value_uncached
-        r = send("#{options.type}_value")
-        sub_entry.value = r if options.store?
-        r
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/config.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Config < ::SimpleDelegator
-    def entry(path, options = {})
-      ::EacCli::Config::Entry.new(self, path, options)
-    end
-
-    def sub
-      __getobj__
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/default_runner.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module DefaultRunner
-    common_concern do
-      include ::EacCli::RunnerWith::Help
-
-      enable_speaker
-      enable_simple_cache
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/alternative.rb

@@ -1,101 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class Alternative
-      ANY_OPTION_DESCRIPTION = 'ANY_OPTION'
-      ANY_OPTION_LONG = '__'
-      ANY_OPTION_SHORT = '_'
-      SUBCOMMAND_NAME_ARG = :subcommand
-      SUBCOMMAND_ARGS_ARG = :subcommand_args
-
-      # @return [Boolean]
-      def any_opt
-        @any_opt = true
-      end
-
-      # @return [Boolean]
-      def any_option?
-        @any_opt ? true : false
-      end
-
-      # @return [EacCli::Definition::BooleanOption]
-      def any_options_option
-        @any_options_option ||= ::EacCli::Definition::BooleanOption.new(
-          ANY_OPTION_SHORT, ANY_OPTION_LONG, ANY_OPTION_DESCRIPTION,
-          optional: true, repeat: true, usage: false
-        )
-      end
-
-      def arg_opt(*args)
-        options_set << ::EacCli::Definition::ArgumentOption.from_args(args)
-      end
-
-      def bool_opt(*args)
-        options_set << ::EacCli::Definition::BooleanOption.from_args(args)
-      end
-
-      def options
-        options_set.to_a
-      end
-
-      def options_argument?
-        @options_argument ? true : false
-      end
-
-      def options_argument(enable)
-        @options_argument = enable
-
-        self
-      end
-
-      def pos_arg(name, arg_options = {})
-        new_pos_arg = ::EacCli::Definition::Positional.new(name, arg_options)
-        check_positional_blocked(new_pos_arg)
-        pos_set << new_pos_arg
-      end
-
-      def positional
-        pos_set.to_a
-      end
-
-      def positional_arguments_blocked_reason(new_pos_arg)
-        last = pos_set.last
-        return nil unless last
-        return 'there are subcommands' if subcommands?
-        return 'last argument repeats' if last.repeat?
-        return 'new argument is required and last is optional' if
-        last.optional? && new_pos_arg.if_present(&:required?)
-
-        nil
-      end
-
-      def subcommands
-        pos_arg(SUBCOMMAND_NAME_ARG, subcommand: true)
-        pos_set << ::EacCli::Definition::Positional.new(SUBCOMMAND_ARGS_ARG,
-                                                        optional: true, repeat: true)
-      end
-
-      def subcommands?
-        pos_set.any?(&:subcommand?)
-      end
-
-      private
-
-      def check_positional_blocked(new_pos_arg)
-        positional_arguments_blocked_reason(new_pos_arg).if_present do |v|
-          raise ::EacCli::Definition::Error, "Positional arguments are blocked: #{v} " \
-                                             "(New argument: #{new_pos_arg})"
-        end
-      end
-
-      def pos_set
-        @pos_set ||= []
-      end
-
-      def options_set
-        @options_set ||= []
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/argument_option.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class ArgumentOption < ::EacCli::Definition::Option
-      def argument?
-        true
-      end
-
-      def build_value(new_value, previous_value)
-        repeat? ? previous_value + [new_value] : new_value
-      end
-
-      def default_default_value
-        repeat? ? [] : nil
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/boolean_option.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class BooleanOption < ::EacCli::Definition::Option
-      def argument?
-        false
-      end
-
-      def build_value(_new_value, previous_value)
-        repeat? ? previous_value + 1 : true
-      end
-
-      def default_value
-        return super unless default_value?
-
-        raise("Unallowed default value for boolean options (Option: #{self})")
-      end
-
-      def default_default_value
-        repeat? ? 0 : false
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/error.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class Error < ::StandardError
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/option/initialize_args_parser.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class Option
-      class InitializeArgsParser
-        PROPERTIES = %i[short long description options].freeze
-        attr_reader(*PROPERTIES)
-
-        def initialize(args)
-          self.options = args.extract_options!.freeze
-          args.each { |arg| absorb_arg(arg) }
-        end
-
-        private
-
-        attr_writer(*PROPERTIES)
-
-        def absorb_arg(arg)
-          arg_ext = ArgumentParser.new(arg)
-          send("#{arg_ext.type}=", arg_ext.value)
-        end
-
-        class ArgumentParser
-          TYPES = %i[short long description].freeze
-          common_constructor :value
-
-          def type
-            TYPES.find { |type| send("#{type}?") } ||
-              raise(::EacCli::Definition::Error, "Unknown type for \"#{value}\"")
-          end
-
-          def short?
-            value.start_with?('-') && !long?
-          end
-
-          def long?
-            value.start_with?('--')
-          end
-
-          def description?
-            !short? || !long?
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/option.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    # @abstract
-    class Option < ::EacCli::Definition::OptionOrPositional
-      class << self
-        # @param args [Enumerable<String>]
-        # @return [EacCli::Definition::Option]
-        def from_args(args)
-          p = ::EacCli::Definition::Option::InitializeArgsParser.new(args)
-          new(p.short, p.long, p.description, p.options)
-        end
-      end
-
-      DEFAULT_REQUIRED = false
-
-      enable_abstract_methods
-      lists.add_symbol :option, *OPTION_LIST, :default, :usage
-
-      # @!method initialize(short, long, description, options = {})
-      # @param short [String]
-      # @param long [String]
-      # @param description [String]
-      # @param options [Hash<Symbol, Object>]
-      # @raise [EacCli::Definition::Error]
-      common_constructor :short, :long, :description, :options, default: [{}] do
-        validate
-        self.options = ::EacCli::Definition::Option.lists.option.hash_keys_validate!(
-          options.symbolize_keys
-        )
-      end
-
-      # @return [Object]
-      def default_value
-        default_value? ? options[OPTION_DEFAULT] : default_default_value
-      end
-
-      # @return [Boolean]
-      def default_value?
-        options.key?(OPTION_DEFAULT)
-      end
-
-      # @return [Symbol]
-      # @raise [EacCli::Definition::Error] If no short or long option is provided.
-      def identifier
-        [long, short].each do |v|
-          v.to_s.if_present { |vv| return vv.variableize.to_sym }
-        end
-
-        raise('No short or long option to build identifier')
-      end
-
-      # @return [Boolean]
-      def show_on_usage?
-        options[:usage]
-      end
-
-      private
-
-      # @return [void]
-      # @raise [EacCli::Definition::Error]
-      def validate
-        raise 'Nor short neither long selector was set' if short.blank? && long.blank?
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/option_or_positional.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    # @abstract
-    class OptionOrPositional
-      acts_as_abstract :build_value, :default_value, :identifier, :options
-      enable_listable
-
-      OPTION_LIST = %i[optional repeat required].freeze
-
-      # @return [Boolean]
-      def optional?
-        !required?
-      end
-
-      # @raise [EacCli::Definition::Error]
-      def raise(*)
-        ::Kernel.raise(::EacCli::Definition::Error, *)
-      end
-
-      # @return [Boolean]
-      def repeat?
-        options[:repeat] ? true : false
-      end
-
-      # @return [Boolean]
-      def required?
-        return true if options.key?(:required) && options.fetch(:required)
-        return false if options.key?(:optional) && options.fetch(:optional)
-
-        self.class.const_get('DEFAULT_REQUIRED')
-      end
-
-      # @return [String]
-      def to_s
-        "#{self.class.name.demodulize}[#{identifier}]"
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/definition/positional.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    class Positional < ::EacCli::Definition::OptionOrPositional
-      DEFAULT_REQUIRED = true
-      DEFAULT_VISIBLE = true
-
-      lists.add_symbol :option, *OPTION_LIST, :subcommand, :visible
-
-      # @!method initialize(name, options = {})
-      # @param name [String]
-      # @param options [Hash<Symbol, Object>]
-      common_constructor :name, :options, default: [{}] do
-        options.assert_valid_keys(self.class.lists.option.values)
-      end
-
-      # @param new_value [Array, Object]
-      # @param previous_value [Array, Object]
-      # @return [Array]
-      def build_value(new_value, previous_value)
-        if previous_value.is_a?(::Array)
-          previous_value + [new_value]
-        else
-          new_value
-        end
-      end
-
-      # @return [Object]
-      def default_value
-        repeat? ? [] : nil
-      end
-
-      # @return [Symbol]
-      def identifier
-        name.to_s.variableize.to_sym
-      end
-
-      # @return [Boolean]
-      def subcommand?
-        options[OPTION_SUBCOMMAND]
-      end
-
-      # @return [Boolean]
-      def visible?
-        options.key?(OPTION_VISIBLE) ? options.fetch(OPTION_VISIBLE) : DEFAULT_VISIBLE
-      end
-    end
-  end
-end

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

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  class Definition
-    MAIN_ALTERNATIVE_KEY = :main
-    SUBCOMMAND_NAME_ARG = 'subcommand'
-    SUBCOMMAND_ARGS_ARG = 'subcommand_args'
-
-    # @return [String, nil]
-    attr_accessor :description
-
-    def initialize
-      self.description = '-- NO DESCRIPTION SET --'
-      alternatives_set[MAIN_ALTERNATIVE_KEY] = main_alternative
-    end
-
-    # @return [EacCli::Definition::Alternative]
-    def alt(key = nil, &)
-      key ||= new_alternative_key
-      raise(::EacCli::Definition::Error, "A alternative with key=\"#{key}\" already exists") if
-        key.present? && alternatives_set.key?(key)
-
-      r = ::EacCli::Definition::Alternative.new
-      r.instance_eval(&)
-      alternatives_set[key] = r
-      r
-    end
-
-    # @return [Enumerable<EacCli::Definition::Alternative>]
-    def alternatives
-      alternatives_set.values
-    end
-
-    # @return [EacCli::Definition::Alternative]
-    # @raise [KeyError] If there is not a alternative with provided key.
-    def alternative(key)
-      alternatives_set.fetch(key)
-    end
-
-    # Same as {#description=}.
-    def desc(description)
-      self.description = description
-    end
-
-    # @return [EacCli::Definition::Alternative]
-    def main_alternative
-      @main_alternative ||= begin
-        r = ::EacCli::Definition::Alternative.new
-        r.options_argument(true)
-        r
-      end
-    end
-
-    # Same as {#options_argument=}.
-    # @param options_argument [Boolean]
-    def options_arg(options_argument)
-      self.options_argument = options_argument
-    end
-
-    # @return [Boolean]
-    def options_argument # rubocop:disable Naming/PredicateMethod
-      main_alternative.options_argument?
-    end
-
-    def options_argument=(enable)
-      main_alternative.options_argument(enable)
-    end
-
-    delegate :arg_opt, :bool_opt, :options, :pos_arg,
-             :positional, :subcommands, to: :main_alternative
-
-    def subcommands?
-      alternatives.any?(&:subcommands?)
-    end
-
-    def options_first(enable = true) # rubocop:disable Style/OptionalBooleanParameter
-      @options_first = enable
-    end
-
-    def options_first?
-      @options_first ? true : false
-    end
-
-    private
-
-    def alternatives_set
-      @alternatives_set ||= ::ActiveSupport::HashWithIndifferentAccess.new
-    end
-
-    def new_alternative_key
-      @last_key ||= 0
-      loop do
-        @last_key += 1
-        break @last_key unless alternatives_set.key?(@last_key)
-      end
-    end
-
-    def pos_set
-      @pos_set ||= []
-    end
-  end
-end