eac_tools 0.63.0 → 0.65.0

data/sub/avm-tools/lib/avm/tools/runner/instance/data/load.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Load
+            runner_with :help do
+              desc 'Load utility for EacRailsBase instance.'
+              arg_opt '-S', '--source-instance', 'Informa a instância a ser extraída o dump.'
+              pos_arg :dump_path, optional: true
+            end
+
+            def run
+              return fatal_error("Dump \"#{dump_path}\" does not exist") unless
+              ::File.exist?(dump_path)
+
+              load_dump
+              success("Dump loaded from \"#{dump_path}\"")
+            end
+
+            def dump_path_uncached
+              return parsed.dump_path.to_s if parsed.dump_path.present?
+              return source_instance_dump_path if parsed.source_instance.present?
+
+              raise "Dump path unknown (Options: #{parsed})"
+            end
+
+            def source_instance_dump_path
+              runner_context.call(:instance).class.by_id(parsed.source_instance).run_subcommand(
+                ::Avm::Tools::Runner::Instance::Data::Dump, []
+              )
+            end
+
+            def load_dump
+              info "Loading dump \"#{dump_path}\"..."
+              package_load.run
+            end
+
+            def dump_instance_method
+              :dump_database
+            end
+
+            private
+
+            def package_load_uncached
+              runner_context.call(:instance).data_package.load(dump_path)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/{avm-eac_webapp_base0/lib/avm/eac_webapp_base0/instances/runners → avm-tools/lib/avm/tools/runner/instance}/data/unit/clear.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
+require 'avm/instances/runner'
 require 'eac_cli/core_ext'
 
 module Avm
-  module EacWebappBase0
-    module Instances
-      module Runners
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
         class Data
           class Unit
             class Clear

data/sub/avm-tools/lib/avm/tools/runner/instance/data/unit/dump.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            class Dump
+              runner_with :help do
+                pos_arg :dump_path, optional: true
+              end
+
+              def run
+                runner_context.call(:data_unit).dump(dump_path)
+              end
+
+              # @return [String]
+              def help_extra_text
+                "Default dump path: \"#{default_dump_path}\""
+              end
+
+              # @return [Pathname]
+              def dump_path
+                (parsed.dump_path || default_dump_path).to_pathname
+              end
+
+              # @return [String]
+              def default_dump_path
+                runner_context.call(:data_unit).data_default_dump_path
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/{avm-eac_webapp_base0/lib/avm/eac_webapp_base0/instances/runners → avm-tools/lib/avm/tools/runner/instance}/data/unit/load.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
+require 'avm/instances/runner'
 require 'eac_cli/core_ext'
 
 module Avm
-  module EacWebappBase0
-    module Instances
-      module Runners
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
         class Data
           class Unit
             class Load
@@ -14,7 +15,12 @@ module Avm
               end
 
               def run
-                nyi
+                runner_context.call(:data_unit).load(dump_path)
+              end
+
+              # @return [Pathname]
+              def dump_path
+                parsed.dump_path.to_pathname
               end
             end
           end

data/sub/{avm-eac_webapp_base0/lib/avm/eac_webapp_base0/instances/runners → avm-tools/lib/avm/tools/runner/instance}/data/unit.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
+require 'avm/instances/runner'
 require 'eac_cli/core_ext'
 
 module Avm
-  module EacWebappBase0
-    module Instances
-      module Runners
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
         class Data
           class Unit
             require_sub __FILE__
@@ -29,9 +30,9 @@ module Avm
               data_package.unit(parsed.identifier)
             end
 
-            # @return [Hash<String, Enumerable<String>]
+            # @return [String]
             def help_extra_text
-              super.merge('Available units' => available_units_ids)
+              help_join_sections(super, list_section('Available units', available_units_ids))
             end
           end
         end

data/sub/{avm-eac_webapp_base0/lib/avm/eac_webapp_base0/instances/runners → avm-tools/lib/avm/tools/runner/instance}/data.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
+require 'avm/instances/runner'
 require 'eac_cli/core_ext'
 
 module Avm
-  module EacWebappBase0
-    module Instances
-      module Runners
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
         class Data
           require_sub __FILE__
           runner_with :help, :subcommands do

data/sub/avm-tools/lib/avm/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Avm
   module Tools
-    VERSION = '0.145.1'
+    VERSION = '0.147.0'
   end
 end

data/sub/eac_cli/eac_cli.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |s|
 
   s.add_dependency 'colorize', '~> 0.8', '>= 0.8.1'
   s.add_dependency 'eac_config', '~> 0.12'
-  s.add_dependency 'eac_ruby_utils', '~> 0.113'
+  s.add_dependency 'eac_ruby_utils', '~> 0.114'
 
   s.add_development_dependency 'eac_ruby_gem_support', '~> 0.5.1'
 end

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

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require 'eac_cli/definition/default_value'
 require 'eac_ruby_utils/core_ext'
 
 module EacCli
   class Definition
     class BaseOption
       require_sub __FILE__
+      include ::EacCli::Definition::DefaultValue
 
       class << self
         def from_args(args)
@@ -17,7 +19,7 @@ module EacCli
       DEFAULT_REQUIRED = false
 
       enable_listable
-      enable_abstract_methods :build_value, :default_value
+      enable_abstract_methods :build_value
       lists.add_symbol :option, :default, :optional, :usage, :repeat, :required
       common_constructor :short, :long, :description, :options, default: [{}] do
         raise 'Nor short neither long selector was set' if short.blank? && long.blank?

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  class Definition
+    module DefaultValue
+      def default_value
+        default_value? ? options[OPTION_DEFAULT] : default_default_value
+      end
+
+      def default_value?
+        options.key?(OPTION_DEFAULT)
+      end
+    end
+  end
+end

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

@@ -1,18 +1,16 @@
 # frozen_string_literal: true
 
-require 'eac_cli/runner_with/help/list_section'
+require 'eac_cli/runner_with/help/layout'
 require 'eac_ruby_utils/core_ext'
 
 module EacCli
   module RunnerWith
     module Help
       class Builder
+        include ::EacCli::RunnerWith::Help::Layout
         require_sub __FILE__, require_dependency: true
         common_constructor :runner
 
-        OPTION_DESC_SEP = ::EacCli::RunnerWith::Help::ListSection::IDENTATION * 2
-        SECTION_SEPARATOR = "\n"
-
         class << self
           def option_long(option)
             b = option.long
@@ -35,7 +33,7 @@ module EacCli
           end
 
           def word_separator
-            ::EacCli::RunnerWith::Help::ListSection::WORD_SEPARATOR
+            WORD_SEPARATOR
           end
         end
 
@@ -45,36 +43,22 @@ module EacCli
           runner.class.runner_definition
         end
 
-        # @return [String, nil]
-        def extra_section
-          ess = extra_sections
-          return nil if ess.none?
-
-          ess.join(SECTION_SEPARATOR)
-        end
-
         # @return [Enumerable<String>]
         def extra_sections
           runner.if_respond(:help_extra_text, []) do |v|
-            if v.is_a?(::Hash)
-              v.map do |title, lines|
-                ::EacCli::RunnerWith::Help::ListSection.new(title, lines)
-              end
-            else
-              [v.to_s]
-            end
+            [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]
-            .reject(&:blank?).join(OPTION_DESC_SEP)
+            .reject(&:blank?).join(OPTION_DESCRIPTION_SEPARATOR)
         end
 
         # @return [String]
         def options_section
-          ::EacCli::RunnerWith::Help::ListSection.new(
+          list_section(
             'Options',
             definition.alternatives.flat_map(&:options).map { |option| option_definition(option) }
           )
@@ -82,16 +66,14 @@ module EacCli
 
         # @return [String]
         def usage_section
-          ::EacCli::RunnerWith::Help::ListSection.new(
+          list_section(
             'Usage',
             definition.alternatives.map { |alternative| self.alternative(alternative) }
           )
         end
 
         def to_s
-          r = ["#{definition.description}\n", usage_section, options_section]
-                .map { |s| "#{s}#{SECTION_SEPARATOR}" }.join
-          extra_section.if_present(r) { |v| r + v }
+          join_sections(definition.description, usage_section, options_section, *extra_sections)
         end
       end
     end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+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

@@ -20,6 +20,18 @@ module EacCli
         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?
 

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

@@ -2,7 +2,7 @@
 
 require 'eac_cli/runner'
 require 'eac_ruby_utils/core_ext'
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 module EacCli
   module RunnerWith

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

@@ -2,7 +2,7 @@
 
 require 'eac_cli/runner'
 require 'eac_ruby_utils/core_ext'
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 module EacCli
   module RunnerWith

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

@@ -53,10 +53,7 @@ module EacCli
 
       # @return [Hash<String, Enumerable<String>]
       def help_extra_text
-        {
-          'Subcommands' =>
-          available_subcommands.keys.sort
-        }
+        help_list_section('Subcommands', available_subcommands.keys.sort)
       end
 
       def method_missing(method_name, *arguments, &block)

data/sub/eac_cli/lib/eac_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EacCli
-  VERSION = '0.32.0'
+  VERSION = '0.33.0'
 end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner_with/help/layout'
+
+::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

@@ -36,7 +36,6 @@ RSpec.describe ::EacCli::RunnerWith::Help do
 
           Options:
             -h --help    Show help.
-
         OUTPUT
       end
       let(:expected_output) do

data/sub/eac_ruby_utils/lib/eac_ruby_utils/{abstract_methods.rb → acts_as_abstract.rb}

@@ -8,10 +8,10 @@ module EacRubyUtils
   #
   # Usage:
   #
-  #   require 'eac_ruby_utils/abstract_methods'
+  #   require 'eac_ruby_utils/acts_as_abstract'
   #
   #   class BaseClass
-  #     include EacRubyUtils::AbstractMethods
+  #     include EacRubyUtils::ActsAsAbstract
   #
   #     abstract_methods :mymethod
   #   end
@@ -25,23 +25,44 @@ module EacRubyUtils
   #   end
   #
   #   SubClass.new.mymethod # return "Implemented"
-  module AbstractMethods
+  module ActsAsAbstract
     common_concern
 
     class << self
       def abstract?(a_class)
-        a_class.self_included_modules.include?(::EacRubyUtils::AbstractMethods)
+        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)
+        define_method name.to_sym do |*_the_args|
+          raise_abstract_method(name.to_sym, arguments)
+        end
+      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|
-          define_method method_name do
-            raise_abstract_method(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
     end
 
     module InstanceMethods
@@ -59,9 +80,9 @@ module EacRubyUtils
         self.class.abstract_methods.include?(method_name.to_sym)
       end
 
-      def raise_abstract_method(method_name)
-        raise ::NoMethodError, "Abstract method \"#{method_name}\" hit in \"#{self}\"" \
-          " (Class: #{self.class})"
+      def raise_abstract_method(method_name, arguments = [])
+        raise ::NoMethodError, "Abstract method #{method_name}(#{arguments.join(', ')}) hit in " \
+          "#{self}\" (Class: #{self.class})"
       end
     end
   end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/patches/class/abstract.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 class Class
   def abstract?
-    ::EacRubyUtils::AbstractMethods.abstract?(self)
+    ::EacRubyUtils::ActsAsAbstract.abstract?(self)
   end
 end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/patches/module/abstract_methods.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/patches/module/acts_as_abstract'
 
 class Module
+  # @deprecated Use {#acts_as_abstract} instead.
   def enable_abstract_methods(*methods)
-    include ::EacRubyUtils::AbstractMethods
-    abstract_methods(*methods)
+    acts_as_abstract(*methods)
   end
 end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/acts_as_abstract'
+
+class Module
+  # Include [EacRubyUtils::ActsAsAbstract] and perform EacRubyUtils::ActsAsAbstract.abstract_methods
+  # on parameter +methods+.
+  # @param methods [Array<Symbol>]
+  # @return [void]
+  def acts_as_abstract(*methods)
+    include ::EacRubyUtils::ActsAsAbstract
+    abstract_methods(*methods)
+  end
+end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/patches/pathname/basename_sub.rb

@@ -3,7 +3,11 @@
 require 'pathname'
 
 class Pathname
+  # @param suffix [String]
+  # @return [Pathname]
   def basename_sub(suffix = '')
-    parent.join(yield(basename(suffix)))
+    new_basename = basename(suffix)
+    new_basename = yield(new_basename) if block_given?
+    parent.join(new_basename)
   end
 end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/speaker/receiver.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 module EacRubyUtils
   module Speaker
     module Receiver
       extend ::ActiveSupport::Concern
-      extend ::EacRubyUtils::AbstractMethods
+      extend ::EacRubyUtils::ActsAsAbstract
 
       module ClassMethods
         def on(*args, &block)

data/sub/eac_ruby_utils/lib/eac_ruby_utils/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EacRubyUtils
-  VERSION = '0.113.0'
+  VERSION = '0.115.0'
 end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/{abstract_methods_spec.rb → acts_as_abstract_spec.rb}

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
-RSpec.describe(::EacRubyUtils::AbstractMethods) do
+RSpec.describe(::EacRubyUtils::ActsAsAbstract) do
   let(:base_class) do
     the_module = described_class
     ::Class.new do

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/class/abstract_spec.rb

@@ -5,7 +5,7 @@ require 'eac_ruby_utils/patches/class/abstract'
 RSpec.describe ::Class do
   let(:abstract_class) do
     described_class.new do
-      enable_abstract_methods
+      acts_as_abstract
     end
   end
 

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/class/acts_as_abstract_spec.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/acts_as_abstract'
+require 'eac_ruby_utils/patches/module/acts_as_abstract'
+
+::RSpec.describe ::Class do
+  let(:stub_class) do
+    described_class.new { acts_as_abstract }
+  end
+
+  describe '#acts_as_abstract' do
+    it { expect(stub_class.included_modules).to include(::EacRubyUtils::ActsAsAbstract) }
+  end
+end