eac_tools 0.126.1 → 0.126.2

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

@@ -1,100 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/module_ancestors_variable/hash'
-require 'eac_ruby_utils/patches/class/self_included_modules'
-require 'eac_ruby_utils/patches/module/common_concern'
-require 'eac_ruby_utils/unimplemented_method_error'
-
-module EacRubyUtils
-  # Support to abstract methods.
-  #
-  # Usage:
-  #
-  #   require 'eac_ruby_utils/acts_as_abstract'
-  #
-  #   class BaseClass
-  #     include EacRubyUtils::ActsAsAbstract
-  #
-  #     abstract_methods :mymethod
-  #   end
-  #
-  #   BaseClass.new.mymethod # raise "Abstract method: mymethod"
-  #
-  #   class SubClass
-  #     def mymethod
-  #       "Implemented"
-  #     end
-  #   end
-  #
-  #   SubClass.new.mymethod # return "Implemented"
-  module ActsAsAbstract
-    common_concern
-
-    class << self
-      def abstract?(a_class)
-        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)
-        abstract_methods_hash[name.to_sym] = arguments
-      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|
-          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
-
-      # @return [Hash<Symbol, Array]
-      def abstract_methods_hash
-        @abstract_methods_hash ||=
-          ::EacRubyUtils::ModuleAncestorsVariable::Hash.new(self, __method__)
-      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, &)
-        raise_abstract_method(method_name) if abstract_method?(method_name)
-
-        super
-      end
-
-      # @param method_name [Symbol]
-      # @return [Boolean]
-      def abstract_method?(method_name)
-        return false if self.class.method_defined?(method_name)
-
-        self.class.send(:abstract_methods_hash).key?(method_name.to_sym)
-      end
-
-      def raise_abstract_method(method_name, arguments = [])
-        raise ::EacRubyUtils::UnimplementedMethodError,
-              "Abstract method #{method_name}(#{arguments.join(', ')}) hit in " \
-              "#{self}\" (Class: #{self.class})"
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/array_accessor.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/enumerable_accessor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class ArrayAccessor < ::EacRubyUtils::ActsAsImmutable::EnumerableAccessor
-      INITIAL_VALUE = [].freeze
-
-      # @param value [Object]
-      # @return [Array]
-      def immutable_value_set_assert(value)
-        return value if value.is_a?(::Array)
-        return value.to_a if value.respond_to?(:to_a)
-
-        Array(value)
-      end
-
-      # @return [Array] A empty array.
-      def initial_value
-        INITIAL_VALUE
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/base_accessor.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/object/if_respond'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class BaseAccessor
-      FILTER_GET_METHOD_NAME_FORMAT = '%s_get_filter'
-      FILTER_SET_METHOD_NAME_FORMAT = '%s_set_filter'
-
-      common_constructor :name do
-        self.name = name.to_sym
-      end
-
-      def duplicate_object(object)
-        accessor_new_value = yield(immutable_value_get(object))
-        new_values = object.send(:immutable_values_get).merge(name => accessor_new_value)
-        r = object.class.new(*object.immutable_constructor_args)
-        r.send(:immutable_values_set, new_values)
-        r
-      end
-
-      def immutable_value_get(object)
-        object.send(:immutable_values_get)[name]
-      end
-
-      # @param object [Object]
-      # @return [Object]
-      def immutable_value_get_filtered(object)
-        r = immutable_value_get(object)
-        if object.respond_to?(immutable_value_get_filtered_method_name, true)
-          r = object.send(immutable_value_get_filtered_method_name, r)
-        end
-        r
-      end
-
-      # @return [Symbol]
-      def immutable_value_get_filtered_method_name
-        format(FILTER_GET_METHOD_NAME_FORMAT, name)
-      end
-
-      # @param object [Object]
-      # @return [Object]
-      def immutable_value_set_filtered(object, value)
-        if object.respond_to?(immutable_value_set_filtered_method_name, true)
-          value = object.send(immutable_value_set_filtered_method_name, value)
-        end
-        immutable_value_set(object, value)
-      end
-
-      # @return [Symbol]
-      def immutable_value_set_filtered_method_name
-        format(FILTER_SET_METHOD_NAME_FORMAT, name)
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/boolean_accessor.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/common_accessor'
-require 'eac_ruby_utils/patches/class/common_constructor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class BooleanAccessor < ::EacRubyUtils::ActsAsImmutable::CommonAccessor
-      def apply(klass)
-        super
-        accessor = self
-        klass.send(:define_method, "#{name}?") { send(accessor.name) }
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/class_methods.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module ActsAsImmutable
-    module ClassMethods
-      def immutable_accessor(*accessors)
-        options = accessors.extract_options!
-        options[:type] ||= const_get('TYPE_COMMON')
-        accessors.each do |name|
-          class_name = "#{options.fetch(:type).to_s.camelize}Accessor"
-          ::EacRubyUtils::ActsAsImmutable.const_get(class_name).new(name).apply(self)
-        end
-      end
-
-      private
-
-      def imutable_single_accessor(name, options); end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/common_accessor.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/base_accessor'
-require 'eac_ruby_utils/patches/class/common_constructor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class CommonAccessor < ::EacRubyUtils::ActsAsImmutable::BaseAccessor
-      def apply(klass)
-        accessor = self
-        klass.send(:define_method, name) do |*args|
-          case args.count
-          when 0 then next accessor.immutable_value_get_filtered(self)
-          when 1 then next accessor.immutable_value_set_filtered(self, args.first)
-          else
-            raise ::ArgumentError, "wrong number of arguments (given #{args.count}, expected 0..1)"
-          end
-        end
-      end
-
-      def immutable_value_get(object)
-        object.send(:immutable_values_get)[name]
-      end
-
-      def immutable_value_set(object, value)
-        duplicate_object(object) { |_old_value| value }
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/enumerable_accessor.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/inflector'
-require 'eac_ruby_utils/acts_as_immutable/base_accessor'
-require 'eac_ruby_utils/patches/class/common_constructor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    # Should implement in concrect classes:
-    # * immutable_value_set_assert(value)
-    # * initial_value()
-    class EnumerableAccessor < ::EacRubyUtils::ActsAsImmutable::BaseAccessor
-      def apply(klass)
-        apply_singular(klass)
-        apply_plural(klass)
-      end
-
-      def apply_plural(klass)
-        accessor = self
-        klass.send(:define_method, ::ActiveSupport::Inflector.pluralize(name)) do |*args|
-          case args.count
-          when 0 then next accessor.immutable_value_get_filtered(self)
-          when 1 then next accessor.immutable_value_set_filtered(self, args.first)
-          else
-            raise ::ArgumentError, "wrong number of arguments (given #{args.count}, expected 0..1)"
-          end
-        end
-      end
-
-      def apply_singular(klass)
-        accessor = self
-        klass.send(:define_method, name) do |value|
-          accessor.immutable_value_push(self, value)
-        end
-      end
-
-      def immutable_value_get(object)
-        super || initial_value.dup
-      end
-
-      def immutable_value_push(object, value)
-        duplicate_object(object) do |old_value|
-          (old_value || initial_value.dup) + [value]
-        end
-      end
-
-      def immutable_value_set(object, value)
-        duplicate_object(object) { |_old_value| immutable_value_set_assert(value) }
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/hash_accessor.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/base_accessor'
-require 'eac_ruby_utils/patches/class/common_constructor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class HashAccessor < ::EacRubyUtils::ActsAsImmutable::BaseAccessor
-      def apply(klass)
-        apply_plural(klass)
-        apply_singular(klass)
-      end
-
-      def immutable_value_get(object)
-        super || {}
-      end
-
-      def immutable_value_get_single(object, key)
-        immutable_value_get(object)[key]
-      end
-
-      def immutable_value_set(object, new_hash)
-        duplicate_object(object) { |_old_value| new_hash }
-      end
-
-      def immutable_value_set_single(object, key, value)
-        immutable_value_set(object, immutable_value_get(object).merge(key => value))
-      end
-
-      private
-
-      def apply_plural(klass)
-        accessor = self
-        klass.send(:define_method, ::ActiveSupport::Inflector.pluralize(name)) do |*args|
-          case args.count
-          when 0 then next accessor.immutable_value_get_filtered(self)
-          when 1 then next accessor.immutable_value_set_filtered(self, args[0])
-          else
-            raise ::ArgumentError, "wrong number of arguments (given #{args.count}, expected 0..1)"
-          end
-        end
-      end
-
-      def apply_singular(klass)
-        accessor = self
-        klass.send(:define_method, name) do |*args|
-          case args.count
-          when 1 then next accessor.immutable_value_get_single(self, args[0])
-          when 2 then next accessor.immutable_value_set_single(self, *args[0..1])
-          else
-            raise ::ArgumentError, "wrong number of arguments (given #{args.count}, expected 1..2)"
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/instance_methods.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module ActsAsImmutable
-    module InstanceMethods
-      def immutable_constructor_args
-        []
-      end
-
-      private
-
-      def immutable_values_get
-        @immutable_values || {}
-      end
-
-      def immutable_values_set(new_values)
-        @immutable_values = new_values
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable/set_accessor.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_immutable/enumerable_accessor'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    class SetAccessor < ::EacRubyUtils::ActsAsImmutable::EnumerableAccessor
-      INITIAL_VALUE = ::Set.new.freeze
-
-      # @param value [Object]
-      # @return [Set]
-      def immutable_value_set_assert(value)
-        return value if value.is_a?(::Set)
-        return value.to_set if value.respond_to?(:to_set)
-
-        ::Set.new(value)
-      end
-
-      # @return [Set] A empty Set.
-      def initial_value
-        INITIAL_VALUE
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_immutable.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/module/common_concern'
-require 'eac_ruby_utils/require_sub'
-
-module EacRubyUtils
-  module ActsAsImmutable
-    ::EacRubyUtils.require_sub __FILE__
-
-    common_concern do
-      include ::EacRubyUtils::Listable
-
-      lists.add_symbol :type, :array, :boolean, :common, :hash
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_instance_method.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/core_ext/module/introspection'
-require 'eac_ruby_utils/patches/class/common_constructor'
-require 'eac_ruby_utils/patches/module/listable'
-require 'eac_ruby_utils/patches/module/module_parent'
-require 'eac_ruby_utils/patches/string/inflector'
-
-module EacRubyUtils
-  class ActsAsInstanceMethod
-    enable_listable
-    lists.add_symbol :option, :name_mark
-    lists.add_symbol :name_mark, '': :none, '!': :exclamation, '?': :interrogation
-
-    common_constructor :method_class, :options, default: [{}] do
-      self.options = ::EacRubyUtils::ActsAsInstanceMethod.lists.option.hash_keys_validate!(options)
-    end
-
-    # @param sender_module [Module, nil]
-    # @return [self]
-    def setup(sender_module = nil)
-      sender_module ||= default_sender_module
-      the_setup = self
-      sender_module.define_method(method_name) do |*args, &block|
-        the_setup.method_class.new(self, *args, &block).result
-      end
-
-      self
-    end
-
-    # @return [String]
-    def method_name
-      "#{method_class.name.demodulize.underscore.variableize}#{method_name_mark}"
-    end
-
-    # @return [Symbol]
-    def method_name_mark
-      options[OPTION_NAME_MARK] || NAME_MARK_NONE
-    end
-
-    # @return [Module]
-    def default_sender_module
-      method_class.module_parent
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/acts_as_static_method.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/acts_as_instance_method'
-
-module EacRubyUtils
-  class ActsAsStaticMethod < ::EacRubyUtils::ActsAsInstanceMethod
-    # @return [Module]
-    def default_sender_module
-      method_class.module_parent.singleton_class
-    end
-  end
-end

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

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/hash_with_indifferent_access'
-
-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 = ::Struct.new(:value, :index).new(value, 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,47 +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) # rubocop:disable Style/OptionalBooleanParameter
-      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