avm-tools 0.120.0 → 0.121.0

data/sub/eac_ruby_utils/MIT-LICENCE

@@ -1,16 +0,0 @@
-Copyright 2018 Eduardo Henrique Bogoni <eduardobogoni@gmail.com>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-associated documentation files (the "Software"), to deal in the Software without restriction,
-including without limitation the rights to use, copy, modify, merge, publish, distribute,
-sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial
-portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
-NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
-OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/sub/eac_ruby_utils/README.rdoc

@@ -1,3 +0,0 @@
-= E.A.C. Ruby Utilities
-
-Utilities for E.A.C.'s Ruby projects.

data/sub/eac_ruby_utils/eac_ruby_utils.gemspec

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.push File.expand_path('lib', __dir__)
-
-# Maintain your gem's version:
-require 'eac_ruby_utils/version'
-
-# Describe your gem and declare its dependencies:
-Gem::Specification.new do |s|
-  s.name        = 'eac_ruby_utils'
-  s.version     = ::EacRubyUtils::VERSION
-  s.authors     = ['Esquilo Azul Company']
-  s.summary     = 'Utilities for E.A.C.\'s Ruby projects.'
-  s.license     = 'MIT'
-
-  s.files = Dir['{lib}/**/*', 'MIT-LICENSE', 'README.rdoc']
-
-  s.add_dependency 'activesupport', '>= 4', '< 7'
-  s.add_dependency 'addressable', '~> 2.6'
-  s.add_dependency 'filesize'
-  s.add_dependency 'net-ssh', '~> 4.2'
-  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.5.1'
-end

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

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/class/self_included_modules'
-require 'eac_ruby_utils/patches/module/common_concern'
-
-module EacRubyUtils
-  # Support to abstract methods.
-  #
-  # Usage:
-  #
-  #   require 'eac_ruby_utils/abstract_methods'
-  #
-  #   class BaseClass
-  #     include EacRubyUtils::AbstractMethods
-  #
-  #     abstract_methods :mymethod
-  #   end
-  #
-  #   BaseClass.new.mymethod # raise "Abstract method: mymethod"
-  #
-  #   class SubClass
-  #     def mymethod
-  #       "Implemented"
-  #     end
-  #   end
-  #
-  #   SubClass.new.mymethod # return "Implemented"
-  module AbstractMethods
-    common_concern
-
-    class << self
-      def abstract?(a_class)
-        a_class.self_included_modules.include?(::EacRubyUtils::AbstractMethods)
-      end
-    end
-
-    module ClassMethods
-      def abstract_methods(*methods_names)
-        methods_names.each do |method_name|
-          define_method method_name do
-            raise_abstract_method(method_name)
-          end
-        end
-      end
-    end
-
-    module InstanceMethods
-      def respond_to_missing?(method_name, include_private = false)
-        super || abstract_method?(method_name)
-      end
-
-      def method_missing(method_name, *arguments, &block)
-        raise_abstract_method(method_name) if abstract_method?(method_name)
-
-        super
-      end
-
-      def abstract_method?(method_name)
-        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})"
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/arguments_consumer.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/hash_with_indifferent_access'
-require 'ostruct'
-
-module EacRubyUtils
-  class ArgumentsConsumer
-    class << self
-      def parse(args, positional = [], options = {})
-        new(args, positional, options).data
-      end
-    end
-
-    attr_reader :positional, :default_options
-
-    def initialize(positional, default_options)
-      @positional = positional.dup.freeze
-      @default_options = default_options.dup.freeze
-    end
-
-    def parse(args)
-      Parser.new(self, args).data
-    end
-
-    class Parser
-      attr_reader :data, :arguments_consumer
-
-      def initialize(arguments_consumer, args)
-        @arguments_consumer = arguments_consumer
-        @data = ::ActiveSupport::HashWithIndifferentAccess.new
-        @options_found = false
-        arguments_consumer.positional.each { |key| data[key] = nil }
-        data.merge!(arguments_consumer.default_options)
-        args.each_with_index { |value, index| add_arg(value, index) }
-        data.freeze
-      end
-
-      private
-
-      def add_arg(value, index)
-        arg = ::OpenStruct.new(value: value, index: index)
-        if arg.value.is_a?(::Hash)
-          add_hash_arg(arg)
-        else
-          add_positional_arg(arg)
-        end
-      end
-
-      def add_hash_arg(arg)
-        check_no_more_arguments(arg)
-        data.merge!(arg.value)
-        @options_found = true
-      end
-
-      def add_positional_arg(arg)
-        check_no_more_arguments(arg)
-        invalid_argument arg, 'No more valid positional' if
-          arg.index >= arguments_consumer.positional.count
-        data[arguments_consumer.positional[arg.index]] = arg.value
-      end
-
-      def check_no_more_arguments(arg)
-        return unless @options_found
-
-        invalid_argument arg, 'Hash already found - no more positional allowed'
-      end
-
-      def invalid_argument(arg, message)
-        raise InvalidArgumentError.new(self, arg, message)
-      end
-    end
-
-    class InvalidArgumentError < StandardError
-      def initialize(args_consumer, arg, message)
-        @args_consumer = args_consumer
-        @arg = arg
-        super "#{message} (Arg: #{arg}, Args Consumer: #{args_consumer})"
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/bit.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/module/compare_by'
-
-module EacRubyUtils
-  class Bit
-    VALID_VALUES = [0, 1].freeze
-
-    class << self
-      def assert(obj)
-        return obj if obj.is_a?(self)
-
-        new(obj.to_i)
-      end
-
-      def valid_integer?(value)
-        value.is_a?(::Integer) && VALID_VALUES.include?(value)
-      end
-
-      def validate_integer(value)
-        return value if valid_integer?(value)
-
-        raise(::ArgumentError, "Invalid bit value: #{value} (Valid: #{VALID_VALUES})")
-      end
-    end
-
-    attr_reader :value
-    compare_by :value
-    delegate :to_s, :zero?, to: :value
-
-    # @param value [Integer]
-    def initialize(value)
-      @value = self.class.validate_integer(value)
-    end
-
-    # @return [Boolean]
-    def one?
-      !zero?
-    end
-
-    # @return [Integer]
-    def to_i
-      value
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/bit_array.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/bit'
-require 'eac_ruby_utils/byte'
-require 'eac_ruby_utils/byte_array'
-require 'eac_ruby_utils/patches/module/compare_by'
-
-module EacRubyUtils
-  class BitArray
-    class << self
-      def assert(obj)
-        return obj if obj.is_a?(self)
-        return new(obj) if obj.is_a?(::Enumerable)
-
-        raise "Could not convert #{obj} to #{self}"
-      end
-    end
-
-    delegate :each, :each_with_index, :to_a, :size, :count, :length, :[], :fetch, to: :values_array
-    compare_by :values_array
-
-    def initialize(values = [])
-      values.each { |value| push(value) }
-    end
-
-    def <<(value)
-      push(value)
-    end
-
-    # @return [EacRubyUtils::BitArray] +self+.
-    def push_array(other_bit_array)
-      values_array.push(*other_bit_array.to_a)
-
-      self
-    end
-
-    # @param value [EacRubyUtils::Bit]
-    # @return [EacRubyUtils::Bit]
-    def push(value)
-      values_array.push(::EacRubyUtils::Bit.assert(value))
-    end
-
-    # @return [EacRubyUtils::BitArray]
-    def reverse
-      self.class.new(values_array.reverse)
-    end
-
-    # @param big_endian [Boolean]
-    # @return [EacRubyUtils::ByteArray]
-    def to_byte_array(big_endian = false)
-      unless count.modulo(::EacRubyUtils::Byte::BIT_COUNT).zero?
-        raise 'Bits returned is not multile of 8'
-      end
-
-      byte_bits_enumerator.each_with_object(::EacRubyUtils::ByteArray.new) do |e, a|
-        a << ::EacRubyUtils::Byte.from_bit_array(e, big_endian)
-      end
-    end
-
-    # @return [Array<Integer>]
-    def to_int_array
-      values_array.map(&:to_i)
-    end
-
-    private
-
-    def byte_bits_enumerator
-      ::Enumerator.new do |y|
-        offset = 0
-        while offset < values_array.count
-          y.yield(values_array.slice(offset, ::EacRubyUtils::Byte::BIT_COUNT))
-          offset += ::EacRubyUtils::Byte::BIT_COUNT
-        end
-      end
-    end
-
-    def values_array
-      @values_array ||= []
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/blank_not_blank.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/core_ext/object/blank'
-require 'singleton'
-
-module EacRubyUtils
-  # A blank string which returns +false+ for +blank?+ method.
-  class BlankNotBlank < String
-    include ::Singleton
-
-    def initialize
-      super('')
-    end
-
-    def blank?
-      false
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/boolean.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  class Boolean
-    class << self
-      def parse(value)
-        return parse_string(value) if value.is_a?(::String)
-        return parse_string(value.to_s) if value.is_a?(::Symbol)
-        return parse_number(value) if value.is_a?(::Numeric)
-
-        value ? true : false
-      end
-
-      private
-
-      def parse_string(value)
-        ['', 'n', 'no', 'f', 'false'].include?(value.strip.downcase) ? false : true
-      end
-
-      def parse_number(value)
-        value.zero?
-      end
-    end
-
-    attr_reader :value
-
-    def initialize(value)
-      @value = self.class.parse(value)
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/by_reference.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  class ByReference
-    def initialize(&object_provider)
-      @object_provider = object_provider
-    end
-
-    def method_missing(method_name, *arguments, &block)
-      return object.send(method_name, *arguments, &block) if object.respond_to?(method_name)
-
-      super
-    end
-
-    def object
-      @object_provider.call
-    end
-
-    def respond_to_missing?(method_name, include_private = false)
-      object.respond_to?(method_name, include_private)
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/byte.rb

@@ -1,105 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/bit'
-require 'eac_ruby_utils/bit_array'
-require 'eac_ruby_utils/patches/module/compare_by'
-
-module EacRubyUtils
-  class Byte
-    ASSEMBLY_HEXADECIMAL_PREFIX = '$'
-    BIT_COUNT = 8
-    BIT_INDEX_RANGE = (0..7).freeze
-    VALUE_RANGE = (0..255).freeze
-
-    class << self
-      def assert(obj)
-        return obj if obj.is_a?(self)
-
-        new(obj.to_i)
-      end
-
-      def from_bit_array(bit_array, big_endian = false)
-        bit_array = ::EacRubyUtils::BitArray.assert(bit_array)
-        raise ::ArgumentError, "Wrong bit array size: #{bit_array.size}" if
-        bit_array.size != BIT_COUNT
-
-        bit_array = bit_array.reverse if big_endian
-        bit_array.each_with_index.inject(new(0)) do |a, e|
-          a.bit_set(e[1], e[0])
-        end
-      end
-
-      def valid_bit_index?(value)
-        value.is_a?(::Integer) && BIT_INDEX_RANGE.include?(value)
-      end
-
-      def validate_bit_index(value)
-        return value if valid_bit_index?(value)
-
-        raise(::ArgumentError, "Invalid bit index: #{value} (Range: #{BIT_INDEX_RANGE})")
-      end
-
-      def valid_value?(value)
-        value.is_a?(::Integer) && VALUE_RANGE.include?(value)
-      end
-
-      def validate_value(value)
-        return value if valid_value?(value)
-
-        raise(::ArgumentError, "Invalid byte value: #{value} (Range: #{VALUE_RANGE})")
-      end
-    end
-
-    attr_reader :value
-    compare_by :value
-
-    def initialize(value)
-      self.value = value
-    end
-
-    # @param bit_index [Integer]
-    # @return [EacRubyUtils::Bit]
-    def [](bit_index)
-      bit_get(bit_index)
-    end
-
-    # @param bit_index [Integer]
-    # @return [EacRubyUtils::Bit]
-    def bit_get(bit_index)
-      self.class.validate_bit_index(bit_index)
-
-      ::EacRubyUtils::Bit.new((value & (1 << bit_index)) >> bit_index)
-    end
-
-    def bit_set(bit_index, bit_value)
-      self.class.validate_bit_index(bit_index)
-      bit = ::EacRubyUtils::Bit.assert(bit_value)
-      mask = (1 << bit_index)
-      self.class.new(bit.zero? ? value & ~mask : value | mask)
-    end
-
-    # @return [EacRubyUtils::BitArray]
-    def to_bit_array(range = BIT_INDEX_RANGE)
-      ::EacRubyUtils::BitArray.new(range.map { |bit_index| self[bit_index] })
-    end
-
-    # @return [Integer]
-    def to_i
-      value
-    end
-
-    # @return [String]
-    def to_asm_hex
-      ASSEMBLY_HEXADECIMAL_PREFIX + to_hex
-    end
-
-    # @return [String]
-    def to_hex
-      value.to_s(16).upcase.rjust(2, '0')
-    end
-
-    private
-
-    attr_writer :value
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/byte_array.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/byte'
-require 'eac_ruby_utils/patches/module/compare_by'
-
-module EacRubyUtils
-  class ByteArray
-    delegate :to_a, :size, :count, :length, :[], :fetch, :map, to: :values_array
-    compare_by :values_array
-
-    def initialize(values = [])
-      values.each { |value| push(value) }
-    end
-
-    def <<(value)
-      push(value)
-    end
-
-    # @param value [EacRubyUtils::Byte]
-    # @return [EacRubyUtils::Byte]
-    def push(value)
-      values_array.push(::EacRubyUtils::Byte.assert(value))
-    end
-
-    # @return [Array<Integer>]
-    def to_int_array
-      values_array.map(&:to_i)
-    end
-
-    private
-
-    def values_array
-      @values_array ||= []
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/common_concern/class_setup.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/concern'
-require 'eac_ruby_utils/simple_cache'
-require 'eac_ruby_utils/patches/object/if_present'
-
-module EacRubyUtils
-  class CommonConcern
-    class ClassSetup
-      include ::EacRubyUtils::SimpleCache
-      attr_reader :a_class, :module_setup, :include_method
-
-      def initialize(module_setup, a_class, include_method)
-        @module_setup = module_setup
-        @a_class = a_class
-        @include_method = include_method
-      end
-
-      def run
-        %w[class_methods instance_methods after_callback].each do |suffix|
-          send("setup_#{suffix}")
-        end
-      end
-
-      def setup_class_methods
-        class_methods_module.if_present { |v| a_class.extend v }
-      end
-
-      def setup_instance_methods
-        instance_methods_module.if_present { |v| a_class.send(include_method, v) }
-      end
-
-      def setup_after_callback
-        module_setup.common_concern.after_callback.if_present do |v|
-          a_class.instance_eval(&v)
-        end
-      end
-
-      def class_methods_module_uncached
-        module_setup.a_module.const_get(CLASS_METHODS_MODULE_NAME)
-      rescue NameError
-        nil
-      end
-
-      def instance_methods_module_uncached
-        module_setup.a_module.const_get(INSTANCE_METHODS_MODULE_NAME)
-      rescue NameError
-        nil
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/common_concern/module_setup.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/concern'
-require 'eac_ruby_utils/common_concern/class_setup'
-require 'eac_ruby_utils/simple_cache'
-require 'eac_ruby_utils/patches/object/if_present'
-
-module EacRubyUtils
-  class CommonConcern
-    class ModuleSetup
-      include ::EacRubyUtils::SimpleCache
-      attr_reader :a_module, :common_concern
-
-      def initialize(common_concern, a_module)
-        @common_concern = common_concern
-        @a_module = a_module
-      end
-
-      def run
-        a_module.extend(::ActiveSupport::Concern)
-        include_or_prepend(:included, :include)
-        include_or_prepend(:prepended, :prepend)
-      end
-
-      private
-
-      def include_or_prepend(module_method, class_setup_method)
-        setup = self
-        a_module.send(module_method, *a_module_method_args(module_method)) do
-          ::EacRubyUtils::CommonConcern::ClassSetup.new(setup, self, class_setup_method).run
-        end
-      end
-
-      def a_module_method_args(module_method)
-        method_arity = a_module.method(module_method).arity
-        method_arity = -method_arity - 1 if method_arity.negative?
-        method_arity.times.map { |_n| a_module }
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/common_concern.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/common_concern/module_setup'
-
-module EacRubyUtils
-  class CommonConcern
-    CLASS_METHODS_MODULE_NAME = 'ClassMethods'
-    INSTANCE_METHODS_MODULE_NAME = 'InstanceMethods'
-
-    attr_reader :after_callback
-
-    def initialize(&after_callback)
-      @after_callback = after_callback
-    end
-
-    def setup(a_module)
-      ::EacRubyUtils::CommonConcern::ModuleSetup.new(self, a_module).run
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/common_constructor/class_initialize.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/common_constructor/instance_initialize'
-require 'eac_ruby_utils/common_constructor/super_args'
-
-module EacRubyUtils
-  class CommonConstructor
-    class ClassInitialize
-      attr_reader :common_constructor, :klass
-
-      def initialize(common_constructor, klass)
-        @common_constructor = common_constructor
-        @klass = klass
-      end
-
-      def run
-        class_initialize = self
-        klass.send(:define_method, :initialize) do |*args|
-          ::EacRubyUtils::CommonConstructor::InstanceInitialize.new(
-            class_initialize.common_constructor, args, self
-          ).run
-          super(*::EacRubyUtils::CommonConstructor::SuperArgs.new(
-            class_initialize, args, self
-          ).result)
-        end
-      end
-    end
-  end
-end