avm-tools 0.92.0 → 0.94.3

data/vendor/eac_ruby_base0/spec/lib/eac_ruby_base0/runner_with/output_spec.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base0/runner_with/output'
+require 'eac_ruby_utils/fs/temp'
+
+RSpec.describe ::EacRubyBase0::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', ::EacRubyBase0::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', ::EacRubyBase0::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/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/base.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/fs/logs'
 require 'eac_ruby_utils/fs_cache'
 require 'eac_ruby_utils/listable'
 require 'eac_ruby_utils/on_clean_ruby_environment'
@@ -27,20 +28,16 @@ module EacRubyGemsUtils
         self.class.name.demodulize.gsub(/Test\z/, '')
       end
 
-      def stdout_cache
-        root_cache.child('stdout')
-      end
-
-      def stderr_cache
-        root_cache.child('stderr')
-      end
-
       def to_s
         "#{gem}[#{name}]"
       end
 
       private
 
+      def logs_uncached
+        ::EacRubyUtils::Fs::Logs.new.add(:stdout).add(:stderr)
+      end
+
       def result_uncached
         return RESULT_NONEXISTENT unless elegible?
 
@@ -53,8 +50,8 @@ module EacRubyGemsUtils
 
       def exec_run_with_log
         r = exec_run
-        stdout_cache.write(r[:stdout])
-        stderr_cache.write(r[:stderr])
+        logs[:stdout].write(r[:stdout])
+        logs[:stderr].write(r[:stderr])
         r[:exit_code].zero?
       end
 

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/tests/multiple.rb

@@ -27,6 +27,12 @@ module EacRubyGemsUtils
         decorated_gems.flat_map(&:tests)
       end
 
+      def clear_logs
+        all_tests.each do |test|
+          test.logs.remove_all
+        end
+      end
+
       def prepare_all_gems
         infom 'Preparing all gems...'
         decorated_gems.each(&:prepare)
@@ -47,8 +53,7 @@ module EacRubyGemsUtils
           warn 'Some test did not pass:'
           failed_tests.each do |test|
             infov '  * Test', test
-            infov '    * STDOUT', test.stdout_cache.content_path
-            infov '    * STDERR', test.stderr_cache.content_path
+            info test.logs.truncate_all
           end
         else
           success 'All tests passed'
@@ -60,6 +65,8 @@ module EacRubyGemsUtils
         prepare_all_gems
         test_all_gems
         final_results_banner
+      ensure
+        clear_logs
       end
 
       def start_banner

data/vendor/eac_ruby_gems_utils/lib/eac_ruby_gems_utils/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EacRubyGemsUtils
-  VERSION = '0.8.0'
+  VERSION = '0.9.0'
 end

data/vendor/eac_ruby_utils/eac_ruby_utils.gemspec

@@ -19,6 +19,7 @@ Gem::Specification.new do |s|
   s.add_dependency 'addressable', '~> 2.6'
   s.add_dependency 'colorize', '~> 0.8.1'
   s.add_dependency 'docopt', '~> 0.6.1'
+  s.add_dependency 'filesize'
   s.add_dependency 'net-ssh', '~> 4.2'
   s.add_development_dependency 'eac_ruby_gem_support', '~> 0.1', '>= 0.1.1'
 end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/fs/logs.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string/filters'
+require 'eac_ruby_utils/fs/temp'
+require 'filesize'
+
+module EacRubyUtils
+  module Fs
+    class Logs
+      TRUNCATE_DEFAULT_LENGTH = 1000
+      TRUNCATE_APPEND_TEXT = '(...) '
+
+      def [](label)
+        log_set.fetch(sanitize_label(label))
+      end
+
+      def add(label)
+        log_set[sanitize_label(label)] = ::EacRubyUtils::Fs::Temp.file
+
+        self
+      end
+
+      def remove_all
+        log_set.each_key { |label| remove(label) }
+
+        self
+      end
+
+      def remove(label)
+        log_set.fetch(sanitize_label(label)).remove
+        log_set.delete(sanitize_label(label))
+      end
+
+      def truncate(label, length = TRUNCATE_DEFAULT_LENGTH)
+        content = self[label].read.strip
+        return content if content.length <= TRUNCATE_DEFAULT_LENGTH
+
+        TRUNCATE_APPEND_TEXT + content[content.length - length + TRUNCATE_APPEND_TEXT.length,
+                                       length - TRUNCATE_APPEND_TEXT.length]
+      end
+
+      def truncate_all(length = TRUNCATE_DEFAULT_LENGTH)
+        s = "Files: #{log_set.length}\n"
+        log_set.each do |label, path|
+          x = truncate(label, length)
+          y = [label, path, ::Filesize.from("#{path.size} B").pretty].join(' / ')
+          s += x.blank? ? ">>> #{y} (Blank) <<<" : ">>> #{y}\n#{x}\n<<< #{y}\n"
+        end
+        s
+      end
+
+      private
+
+      def sanitize_label(label)
+        label.to_sym
+      end
+
+      def log_set
+        @log_set ||= {}
+      end
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/inflector.rb

@@ -7,11 +7,19 @@ module EacRubyUtils
     class << self
       VARIABLE_NAME_PATTERN = /[_a-z][_a-z0-9]*/i.freeze
 
-      def variableize(string)
+      # Convert a string to a variable format: first character as a lowercase letter or underscore
+      # and other as a lowercase letter, underscore or numbers.
+      # @param string [String] The source string.
+      # @param validate [Boolean] Affect the outcome when the result builded is not in a valid
+      #   variable format. If `true`, it raises a {ArgumentError}. If `false`, return `nil`.
+      # @return [String, nil]
+      # @raise [ArgumentError]
+      def variableize(string, validate = true)
         r = ::ActiveSupport::Inflector.transliterate(string).gsub(/[^_a-z0-9]/i, '_')
                                       .gsub(/_+/, '_').gsub(/_\z/, '').gsub(/\A_/, '').downcase
         m = VARIABLE_NAME_PATTERN.match(r)
         return r if m
+        return nil unless validate
 
         raise ::ArgumentError, "Invalid variable name \"#{r}\" was generated " \
           "from string \"#{string}\""

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/listable/list.rb

@@ -54,8 +54,9 @@ module EacRubyUtils
       end
 
       def value_validate!(value, error_class = ::StandardError)
-        value_valid?(value) ||
-          raise(error_class, "Invalid value: \"#{value}\" (Valid: #{values_to_s})")
+        return value if value_valid?(value)
+
+        raise(error_class, "Invalid value: \"#{value}\" (Valid: #{values_to_s})")
       end
 
       def values_to_s

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/local_time_zone.rb

@@ -10,6 +10,7 @@ module EacRubyUtils
     class << self
       TIMEDATECTL_TIMEZONE_LINE_PATTERN = %r{\s*Time zone:\s*(\S+/\S+)\s}.freeze
 
+      # @return [ActiveSupport::TimeZone]
       def auto
         %w[tz_env debian_config offset].lazy.map { |s| send("by_#{s}") }.find(&:present?)
       end
@@ -18,22 +19,27 @@ module EacRubyUtils
         ::Time.zone = auto
       end
 
+      # @return [ActiveSupport::TimeZone]
       def by_debian_config
         path = ::Pathname.new(DEBIAN_CONFIG_PATH)
-        path.exist? ? path.read.strip.presence : nil
+        path.exist? ? path.read.strip.if_present { |v| ::ActiveSupport::TimeZone[v] } : nil
       end
 
+      # @return [ActiveSupport::TimeZone]
       def by_offset
-        ::ActiveSupport::TimeZone[::Time.now.getlocal.gmt_offset].name
+        ::ActiveSupport::TimeZone[::Time.now.getlocal.gmt_offset]
       end
 
+      # @return [ActiveSupport::TimeZone]
       def by_timedatectl
         executable = ::EacRubyUtils::Envs.local.executable('timedatectl', '--version')
         return nil unless executable.exist?
 
         TIMEDATECTL_TIMEZONE_LINE_PATTERN.if_match(executable.command.execute!) { |m| m[1] }
+                                         .if_present { |v| ::ActiveSupport::TimeZone[v] }
       end
 
+      # @return [ActiveSupport::TimeZone]
       def by_tz_env
         ENV['TZ'].presence
       end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/patches/class/settings_provider.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/settings_provider'
+
+class Class
+  def enable_settings_provider
+    ::EacRubyUtils.patch(self, ::EacRubyUtils::SettingsProvider)
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/patches/kernel/nyi.rb

@@ -2,7 +2,9 @@
 
 module Kernel
   # Raise exception with text "Not yet implemented".
-  def nyi
-    raise "Not yet implemented (Called in #{caller.first})"
+  def nyi(message = nil)
+    s = "Not yet implemented (Called in #{caller.first})"
+    s += ": #{message}" if message
+    raise s
   end
 end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/patches/object/if_nil.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Object
+  # @return +block.call(self)+ if +self+ is not nil, +default_value+ otherwise.
+  def if_not_nil(default_value = nil)
+    return default_value if nil?
+
+    block_given? ? yield(self) : self
+  end
+
+  # @return +yield+ if +self+ is nil, +self+ otherwise.
+  def if_nil
+    return yield if nil? && block_given?
+
+    self
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/patches/string/inflector.rb

@@ -3,7 +3,9 @@
 require 'eac_ruby_utils/inflector'
 
 class String
-  def variableize
-    ::EacRubyUtils::Inflector.variableize(self)
+  # Shortcut to `EacRubyUtils::Inflector.variableize(self, ...)`.
+  # @see EacRubyUtils::Inflector.variableize
+  def variableize(validate = true)
+    ::EacRubyUtils::Inflector.variableize(self, validate)
   end
 end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/patches/time/required_zone.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/local_time_zone'
+
+class Time
+  class << self
+    def required_zone
+      zone || ::EacRubyUtils::LocalTimeZone.auto || raise('No zone set or discovered')
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/settings_provider.rb

@@ -1,15 +1,14 @@
 # frozen_string_literal: true
 
-require 'active_support/core_ext/string/inflections'
-require 'eac_ruby_utils/options_consumer'
+require 'eac_ruby_utils/require_sub'
 
 module EacRubyUtils
   # Provide a option by constant, method or options object.
   module SettingsProvider
+    ::EacRubyUtils.require_sub __FILE__, base: self
+
     def setting_constant_name(key, fullname = false)
-      name = key.to_s.underscore.upcase
-      name = "#{self.class.name}::#{name}" if fullname
-      name
+      setting_value_instance(key).constant_name(fullname)
     end
 
     def setting_search_order
@@ -25,41 +24,23 @@ module EacRubyUtils
     end
 
     def setting_value(key, options = {})
-      options = parse_setting_value_options(options)
-      options.order.each do |method|
-        value = send("setting_value_by_#{method}", key)
-        return value if value
-      end
-      return nil unless options.required
-
-      raise "Setting \"#{key}\" not found. Supply in #{settings_object_name}, implement a " \
-        "\"#{key}\" method or declare a #{setting_constant_name(key, true)} constant."
+      setting_value_instance(key, options).value
     end
 
     def setting_value_by_constant(key)
-      constant_name = setting_constant_name(key)
-      begin
-        self.class.const_get(constant_name)
-      rescue NameError
-        nil
-      end
+      setting_value_instance(key).value_by_constant
     end
 
     def setting_value_by_method(key)
-      respond_to?(key) ? send(key) : nil
+      setting_value_instance(key).value_by_method
     end
 
     def setting_value_by_settings_object(key)
-      settings_object[key.to_s] || settings_object[key.to_sym]
+      setting_value_instance(key).value_by_settings_object
     end
 
-    private
-
-    def parse_setting_value_options(options)
-      r = ::EacRubyUtils::OptionsConsumer.new(options).consume_all(:required, :order, ostruct: true)
-      r.required = true if r.required.nil?
-      r.order = setting_search_order if r.order.nil?
-      r
+    def setting_value_instance(key, options = {})
+      ::EacRubyUtils::SettingsProvider::SettingValue.new(self, key, options)
     end
   end
 end