eac_tools 0.103.1 → 0.104.0

data/sub/eac_cli/lib/eac_cli/runner_with/help/builder.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Help
-      class Builder
-        include ::EacCli::RunnerWith::Help::Layout
-
-        require_sub __FILE__, require_mode: :kernel
-        common_constructor :runner
-
-        class << self
-          def option_long(option)
-            b = option.long
-            b += '=<value>' if option.argument?
-            b
-          end
-
-          def option_short(option)
-            b = option.short
-            b += '=<value>' if option.argument?
-            b
-          end
-
-          def option_usage_full(option)
-            if option.long.present?
-              [option.short, option_long(option)].compact_blank.join(word_separator)
-            else
-              option_short(option)
-            end
-          end
-
-          def word_separator
-            WORD_SEPARATOR
-          end
-        end
-
-        delegate :word_separator, to: :class
-
-        def definition
-          runner.class.runner_definition
-        end
-
-        # @return [Enumerable<String>]
-        def extra_sections
-          runner.if_respond(:help_extra_text, []) do |v|
-            [v.to_s]
-          end
-        end
-
-        def option_definition(option)
-          [self.class.option_usage_full(option), option.description,
-           option.default_value? ? "[Default: \"#{option.default_value}\"]" : nil]
-            .compact_blank.join(OPTION_DESCRIPTION_SEPARATOR)
-        end
-
-        # @return [String]
-        def options_section
-          list_section(
-            'Options',
-            definition.alternatives.flat_map(&:options).map { |option| option_definition(option) }
-          )
-        end
-
-        # @return [String]
-        def usage_section
-          list_section(
-            'Usage',
-            definition.alternatives.map { |alternative| self.alternative(alternative) }
-          )
-        end
-
-        def to_s
-          join_sections(definition.description, usage_section, options_section, *extra_sections)
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/help/layout.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Help
-      module Layout
-        common_concern do
-          include InstanceClassMethods
-          extend InstanceClassMethods
-        end
-
-        module InstanceClassMethods
-          WORD_SEPARATOR = ' '
-          IDENTATION = WORD_SEPARATOR * 2
-          OPTION_DESCRIPTION_SEPARATOR = IDENTATION * 2
-          LINE_BREAK = "\n"
-          SECTION_SEPARATOR = LINE_BREAK * 2
-
-          # @param title String
-          # @param items [Enumerable<String>]
-          # @return [String]
-          def list_section(title, items)
-            (["#{title}:"] + items.map { |line| "#{IDENTATION}#{line}" })
-              .map { |line| "#{line}\n" }.join
-          end
-
-          # @param sections [Enumerable<String>]
-          # @return [String]
-          def join_sections(*sections)
-            sections.map { |s| s.to_s.strip }.join(SECTION_SEPARATOR) + LINE_BREAK
-          end
-        end
-
-        extend InstanceClassMethods
-      end
-    end
-  end
-end

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

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Help
-      require_sub __FILE__, require_mode: :kernel
-      common_concern do
-        include ::EacCli::Runner
-        include ::EacCli::RunnerWith::Help::Layout
-
-        runner_definition.alt do
-          bool_opt '-h', '--help', 'Show help.', usage: true, required: true
-          any_opt
-          pos_arg :any_arg_with_help, repeat: true, optional: true, visible: false
-        end
-
-        set_callback :run, :before do
-          help_run
-        end
-      end
-
-      # @param items [Enumerable<String>]
-      # @return [String]
-      def help_list_section(title, items)
-        ::EacCli::RunnerWith::Help::Layout.list_section(title, items)
-      end
-
-      # @param items [Enumerable<String>]
-      # @return [String]
-      def help_join_sections(*sections)
-        ::EacCli::RunnerWith::Help::Layout.join_sections(*sections)
-      end
-
-      def help_run
-        return unless show_help?
-
-        puts help_text
-        raise ::EacCli::Runner::Exit
-      end
-
-      # @return [String]
-      def help_text
-        ::EacCli::RunnerWith::Help::Builder.new(self).to_s
-      end
-
-      def show_help?
-        parsed.help? && !if_respond(:run_subcommand?, false)
-      end
-    end
-  end
-end

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

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Input
-      STDIN_OPTION = '-'
-      BLANK_OPTION = '+'
-      DEFAULT_DEFAULT_INPUT_OPTION = BLANK_OPTION
-
-      common_concern do
-        enable_settings_provider
-        include ::EacCli::Runner
-
-        runner_definition do
-          arg_opt '-i', '--input', 'Input from file.'
-        end
-      end
-
-      def input_content
-        case input_option
-        when STDIN_OPTION then $stdin.read
-        when BLANK_OPTION then ''
-        else input_option.to_pathname.read
-        end
-      end
-
-      def input_option
-        parsed.input || setting_value(:default_input_option, default: DEFAULT_DEFAULT_INPUT_OPTION)
-      end
-    end
-  end
-end

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

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Output
-      STDOUT_OPTION = '-'
-      DEFAULT_FILE_OPTION = '+'
-      DEFAULT_DEFAULT_OUTPUT_OPTION = STDOUT_OPTION
-      DEFAULT_DEFAULT_FILE_TO_OUTPUT = 'output'
-
-      common_concern do
-        enable_abstract_methods
-        enable_settings_provider
-        include ::EacCli::Runner
-
-        abstract_methods :output_content
-
-        runner_definition do
-          arg_opt '-o', '--output', 'Output to file.'
-        end
-      end
-
-      def run_output
-        file = file_to_output
-        if file
-          file.to_pathname.write(output_content)
-        else
-          $stdout.write(output_content)
-        end
-      end
-
-      def output_option
-        parsed.output || default_output_option_value
-      end
-
-      def file_to_output
-        case output_option
-        when STDOUT_OPTION then nil
-        when DEFAULT_FILE_OPTION then default_file_to_output_value
-        else output_option
-        end
-      end
-
-      def default_output_option_value
-        setting_value(:default_output_option,
-                      default: DEFAULT_DEFAULT_OUTPUT_OPTION)
-      end
-
-      def default_file_to_output_value
-        setting_value(:default_file_to_output, default: DEFAULT_DEFAULT_FILE_TO_OUTPUT)
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_item/asciidoc_formatter.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-module EacCli
-  module RunnerWith
-    module OutputItem
-      class AsciidocFormatter < ::EacCli::RunnerWith::OutputItem::BaseFormatter
-        STARTING_LEVEL = 2
-
-        # @return [String]
-        def to_output
-          output_hash(item_hash, STARTING_LEVEL)
-        end
-
-        protected
-
-        # @param hash [Hash]
-        # @param level [Integer]
-        # @return [String]
-        def output_enumerable(enumerable, level)
-          enumerable.map { |e| output_object(e, level + 1) }.join
-        end
-
-        # @param hash [Hash]
-        # @param level [Integer]
-        # @return [String]
-        def output_hash(hash, level)
-          hash.map { |k, v| section(k, v, level) }.join("\n")
-        end
-
-        def output_object(object, level)
-          return output_hash(object, level) if object.is_a?(::Hash)
-          return output_enumerable(object, level) if object.is_a?(::Enumerable)
-
-          output_string(object, level)
-        end
-
-        # @param string [String]
-        # @param level [Integer]
-        # @return [String]
-        def output_string(string, _level)
-          "* #{string.to_s.strip}\n"
-        end
-
-        # @param title [String]
-        # @param content [String]
-        # @param level [Integer]
-        # @return [String]
-        def section(title, content, level)
-          "#{section_title(title, level)}\n\n#{section_content(content, level)}"
-        end
-
-        # @param title [String]
-        # @param level [Integer]
-        # @return [String]
-        def section_title(title, level)
-          "#{'=' * level} #{title}"
-        end
-
-        # @param content [String]
-        # @param level [Integer]
-        # @return [String]
-        def section_content(content, level)
-          output_object(content, level)
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_item/base_formatter.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module OutputItem
-      class BaseFormatter
-        acts_as_abstract :to_output
-        common_constructor :item_hash
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_item/csv_formatter.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require 'csv'
-
-module EacCli
-  module RunnerWith
-    module OutputItem
-      class CsvFormatter < ::EacCli::RunnerWith::OutputItem::BaseFormatter
-        COLUMNS = %w[key value].freeze
-
-        # @return [String]
-        def to_output
-          ::CSV.generate do |csv|
-            csv << COLUMNS
-            item_hash.each { |k, v| csv << [k, v] }
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_item/yaml_formatter.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-module EacCli
-  module RunnerWith
-    module OutputItem
-      class YamlFormatter < ::EacCli::RunnerWith::OutputItem::BaseFormatter
-        # @return [String]
-        def to_output
-          ::YAML.dump(item_hash.deep_stringify_keys)
-        end
-      end
-    end
-  end
-end

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

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module OutputItem
-      require_sub __FILE__
-
-      FORMATS = %w[asciidoc csv yaml].freeze
-
-      common_concern do
-        acts_as_abstract :item_hash
-        include ::EacCli::RunnerWith::Output
-
-        runner_definition do
-          arg_opt '-f', '--format', 'Format to output item.', default: 'yaml'
-        end
-      end
-
-      # @return [String]
-      def output_content
-        formatter.to_output
-      end
-
-      # @return [EacCli::RunnerWith::OutputList::BaseFormatter]
-      def formatter
-        formatter_class.new(item_hash)
-      end
-
-      # @return [Class]
-      def formatter_class
-        formats.fetch(parsed.format)
-      end
-
-      # @return [Hash<String, Class>]
-      def formats
-        FORMATS.to_h do |e|
-          [e, ::EacCli::RunnerWith::OutputItem.const_get("#{e.camelize}Formatter")]
-        end
-      end
-
-      # @return [Hash<String, Enumerable<String>]
-      def help_extra_text
-        help_list_section('Formats', formats.keys.sort)
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_list/base_formatter.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module OutputList
-      class BaseFormatter
-        acts_as_abstract :to_output
-        common_constructor :columns, :rows
-
-        # @return [String]
-        def build_column(column)
-          column.to_s
-        end
-
-        # @return [Array<String>]
-        def build_columns
-          columns.map(&:to_s)
-        end
-
-        # @param row [Object]
-        # @return [Object]
-        def build_row(_row)
-          raise_abstract_method __method__
-        end
-
-        # @return [Array<Hash<String, String>>]
-        def build_rows
-          rows.map { |row| build_row(row) }
-        end
-
-        # @param row [Object]
-        # @param column [String]
-        # @return [Object]
-        def build_value(row, column)
-          return row.send(column) if row.respond_to?(column)
-          return row.with_indifferent_access.fetch(column) if row.is_a?(::Hash)
-
-          raise ::ArgumentError, "Row \"#{row}\" do not respond to column \"#{column}\" neither " \
-                                 "is a Hash (Row: #{row}, Column: #{column})"
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_list/csv_formatter.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require 'csv'
-
-module EacCli
-  module RunnerWith
-    module OutputList
-      class CsvFormatter < ::EacCli::RunnerWith::OutputList::BaseFormatter
-        # @return [Array]
-        def build_row(row)
-          build_columns.map { |c| build_value(row, c) }
-        end
-
-        # @return [String]
-        def to_output
-          ::CSV.generate do |csv|
-            csv << build_columns
-            build_rows.each { |row| csv << row }
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_list/tty_formatter.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require 'tty/table'
-
-module EacCli
-  module RunnerWith
-    module OutputList
-      class TtyFormatter < ::EacCli::RunnerWith::OutputList::BaseFormatter
-        # @param row [Object]
-        # @return [Array]
-        def build_row(row)
-          build_columns.map { |c| build_value(row, c) }
-        end
-
-        # @return [String]
-        def to_output
-          "#{tty_table_output}\n"
-        end
-
-        # @return [TTY::Table]
-        def tty_table
-          ::TTY::Table.new(build_columns, build_rows)
-        end
-
-        # @return [String]
-        def tty_table_output
-          tty_table.render(:unicode, multiline: true) do |renderer|
-            renderer.border.separator = ->(row) { ((row + 1) % columns.count).zero? }
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_cli/lib/eac_cli/runner_with/output_list/yaml_formatter.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-module EacCli
-  module RunnerWith
-    module OutputList
-      class YamlFormatter < ::EacCli::RunnerWith::OutputList::BaseFormatter
-        # @return [Hash<String, String>]
-        def build_row(row)
-          build_columns.inject({}) { |a, e| a.merge(e => build_value(row, e).to_s) }
-        end
-
-        # @return [String]
-        def to_output
-          ::YAML.dump(build_rows)
-        end
-      end
-    end
-  end
-end

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

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module OutputList
-      require_sub __FILE__
-
-      FORMATS = {
-        'csv' => ::EacCli::RunnerWith::OutputList::CsvFormatter,
-        'tty' => ::EacCli::RunnerWith::OutputList::TtyFormatter,
-        'yaml' => ::EacCli::RunnerWith::OutputList::YamlFormatter
-      }.freeze
-
-      common_concern do
-        acts_as_abstract :list_columns, :list_rows
-        include ::EacCli::RunnerWith::Output
-
-        runner_definition do
-          arg_opt '-f', '--format', 'Format to output list.', default: 'yaml'
-        end
-      end
-
-      # @return [String]
-      def output_content
-        formatter.to_output
-      end
-
-      # @return [EacCli::RunnerWith::OutputList::BaseFormatter]
-      def formatter
-        formatter_class.new(list_columns, list_rows)
-      end
-
-      # @return [Class]
-      def formatter_class
-        FORMATS.fetch(parsed.format)
-      end
-    end
-  end
-end

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

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module EacCli
-  module RunnerWith
-    module Subcommands
-      module DefinitionConcern
-      end
-    end
-  end
-end