eac_ruby_utils 0.78.0 → 0.81.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04265a77c385833952f4e144e1384702799030c28add480973ac925d1042bde7
-  data.tar.gz: bdb7856467fd1d77f75a468c2a2c3c292231a3387c40281da5325d098eda76cd
+  metadata.gz: 117028f86bd05a2b0ac4c20a34e486ce524241a85031992e22ba4afa596ca56c
+  data.tar.gz: 3a41859f48637bbf64a7846741d50e56d91df95f87906a256ac4332fd3ba9b85
 SHA512:
-  metadata.gz: 70556b9064c0cf84e202e3f65c2f172c60e79304263abe596a1d7ec7a46753f4f58f81565ebeeaa644035f5fbb45f12cb2a5158a3084cd3fac634a0448c1953d
-  data.tar.gz: 9c664e92bcefc75aac89e85016c8b8007bd14a061e46409b5c4b20cb36b8a80707046cb16302a8b1b26bd154cbb28c09027599e7494839abc707b6fe531a65f3
+  metadata.gz: 03140e219584a5544f3972cdcdb3050ec179ea7c2dd5dfcf0a1bbcb91b2dd20c077dd1be1c9a24e33c18937fecb0060b5b5126873b37e72efad2068ae217b121
+  data.tar.gz: 9d4c7245ef22cf5c160d5c56451ce0e25c8faa0f1a230cd6acdcb72ae507a8fc0fdef335fa2fab1268498d975513d966fdab72a2fd5aa046f1d53c9686f47e7f

data/lib/eac_ruby_utils/abstract_methods.rb

@@ -60,7 +60,8 @@ module EacRubyUtils
       end
 
       def raise_abstract_method(method_name)
-        raise ::NoMethodError, "Abstract method \"#{method_name}\" hit in \"#{self}\""
+        raise ::NoMethodError, "Abstract method \"#{method_name}\" hit in \"#{self}\"" \
+          " (Class: #{self.class})"
       end
     end
   end

data/lib/eac_ruby_utils/compare_by.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/common_concern/module_setup'
+
+module EacRubyUtils
+  class CompareBy
+    attr_reader :fields
+
+    def initialize(fields)
+      @fields = fields
+    end
+
+    def apply(klass)
+      pself = self
+      klass.include(::Comparable)
+      %i[<=> eql?].each do |cmp_method|
+        klass.define_method(cmp_method) do |other|
+          pself.object_values(self).send(cmp_method, pself.object_values(other))
+        end
+      end
+      klass.define_method(:hash) { pself.object_values(self).hash }
+    end
+
+    def object_values(object)
+      fields.map { |field| object.send(field) }
+    end
+  end
+end

data/lib/eac_ruby_utils/enum.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/inflector'
+
+module EacRubyUtils
+  # Similar to Java's enum type (https://docs.oracle.com/javase/tutorial/java/javaOO/enum.html).
+  class Enum
+    class << self
+      def enum(key, *args, &block)
+        value = Value.new(self, key, args, &block)
+        raise ::ArgumentError, "#{self} already has a value with key=#{value.key}" if
+          value_set.include?(value)
+
+        value_set << value.apply
+
+        self
+      end
+
+      def values
+        value_set.map(&:value)
+      end
+
+      private
+
+      def value_set
+        @value_set ||= []
+      end
+    end
+
+    attr_reader :key
+
+    protected
+
+    def initialize(key)
+      @key = key
+    end
+
+    class Value
+      include ::Comparable
+
+      attr_reader :klass, :key, :args, :block
+
+      def initialize(klass, key, args, &block)
+        @klass = klass
+        @key = ::EacRubyUtils::Inflector.variableize(key.to_s).to_sym
+        @args = args
+        @block = block
+      end
+
+      def <=>(other)
+        key <=> other.key
+      end
+
+      def apply
+        define_constant
+        define_class_method
+
+        self
+      end
+
+      # @return [String]
+      def class_method_name
+        key.to_s
+      end
+
+      # @return [String]
+      def constant_name
+        class_method_name.upcase
+      end
+
+      def value
+        @value ||= uncached_value
+      end
+
+      private
+
+      def define_class_method
+        the_value = self
+        klass.define_singleton_method(class_method_name) { the_value.value }
+      end
+
+      def define_constant
+        klass.const_set(constant_name, value)
+      end
+
+      def uncached_value
+        klass.new(key, *value_args)
+      end
+
+      def value_args
+        r = if block
+              block.call
+            elsif args.count == 1 && args.first.is_a?(::Enumerable)
+              args.first
+            else
+              args
+            end
+        r.is_a?(::Enumerable) ? r : [r]
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/patches/module/compare_by.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/compare_by'
+
+class Module
+  def compare_by(*fields)
+    ::EacRubyUtils::CompareBy.new(fields).apply(self)
+  end
+end

data/lib/eac_ruby_utils/patches/object/debug.rb

@@ -8,7 +8,7 @@ class Object
   end
 
   def to_debug
-    "|#{self.class}|#{self}|"
+    "|#{::Object.instance_method(:to_s).bind(self).call}|#{self}|"
   end
 
   def raise_debug

data/lib/eac_ruby_utils/simple_cache.rb

@@ -20,7 +20,7 @@ module EacRubyUtils
     end
 
     def method_missing(method, *args, &block)
-      if respond_to?(::EacRubyUtils::SimpleCache.uncached_method_name(method), true)
+      if respond_to?(uncached_method_name(method), true)
         call_method_with_cache(method, args, &block)
       else
         super
@@ -37,27 +37,37 @@ module EacRubyUtils
 
     def reset_cache(*keys)
       if keys.any?
-        keys.each { |key| cache_keys.delete(key) }
+        keys.each { |key| cache_keys.delete(sanitize_cache_key(key)) }
       else
         @cache_keys = nil
       end
     end
 
+    def sanitize_cache_key(key)
+      key.to_s.to_sym
+    end
+
+    protected
+
+    def uncached_method_name(original_method_name)
+      ::EacRubyUtils::SimpleCache.uncached_method_name(original_method_name)
+    end
+
     private
 
     def call_method_with_cache(method, args, &block)
       raise 'Não é possível realizar o cache de métodos com bloco' if block
 
       key = ([method] + args).join('@@@')
-      unless cache_keys.key?(key)
+      unless cache_keys.key?(sanitize_cache_key(key))
         uncached_value = call_uncached_method(method, args)
-        cache_keys[key] = uncached_value
+        cache_keys[sanitize_cache_key(key)] = uncached_value
       end
-      cache_keys[key]
+      cache_keys[sanitize_cache_key(key)]
     end
 
     def call_uncached_method(method, args)
-      send(::EacRubyUtils::SimpleCache.uncached_method_name(method), *args)
+      send(uncached_method_name(method), *args)
     end
 
     def cache_keys

data/lib/eac_ruby_utils/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.78.0
+  version: 0.81.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-06 00:00:00.000000000 Z
+date: 2021-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -107,10 +107,12 @@ files:
 - lib/eac_ruby_utils/common_constructor/instance_initialize.rb
 - lib/eac_ruby_utils/common_constructor/super_args.rb
 - lib/eac_ruby_utils/compact.rb
+- lib/eac_ruby_utils/compare_by.rb
 - lib/eac_ruby_utils/context.rb
 - lib/eac_ruby_utils/contextualizable.rb
 - lib/eac_ruby_utils/core_ext.rb
 - lib/eac_ruby_utils/custom_format.rb
+- lib/eac_ruby_utils/enum.rb
 - lib/eac_ruby_utils/envs.rb
 - lib/eac_ruby_utils/envs/base_env.rb
 - lib/eac_ruby_utils/envs/command.rb
@@ -130,12 +132,9 @@ files:
 - lib/eac_ruby_utils/fs.rb
 - lib/eac_ruby_utils/fs/clearable_directory.rb
 - lib/eac_ruby_utils/fs/extname.rb
-- lib/eac_ruby_utils/fs/logs.rb
 - lib/eac_ruby_utils/fs/temp.rb
 - lib/eac_ruby_utils/fs/temp/directory.rb
 - lib/eac_ruby_utils/fs/temp/file.rb
-- lib/eac_ruby_utils/fs/traversable.rb
-- lib/eac_ruby_utils/fs/traverser.rb
 - lib/eac_ruby_utils/gems_registry.rb
 - lib/eac_ruby_utils/gems_registry/gem.rb
 - lib/eac_ruby_utils/immutable.rb
@@ -178,6 +177,7 @@ files:
 - lib/eac_ruby_utils/patches/module.rb
 - lib/eac_ruby_utils/patches/module/abstract_methods.rb
 - lib/eac_ruby_utils/patches/module/common_concern.rb
+- lib/eac_ruby_utils/patches/module/compare_by.rb
 - lib/eac_ruby_utils/patches/module/context.rb
 - lib/eac_ruby_utils/patches/module/i18n_translate.rb
 - lib/eac_ruby_utils/patches/module/immutable.rb

data/lib/eac_ruby_utils/fs/logs.rb

@@ -1,63 +0,0 @@
-# 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/lib/eac_ruby_utils/fs/traversable.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/fs/traverser'
-
-module EacRubyUtils
-  module Fs
-    module Traversable
-      PROP_METHOD_PREFIX = 'traverser_'
-      BOOLEAN_PROPS = %i[hidden_directories recursive sort].freeze
-      PATH_PROPS = %i[check_directory check_file].freeze
-
-      class << self
-        def prop_method_name(prop)
-          "#{PROP_METHOD_PREFIX}#{prop}"
-        end
-      end
-
-      PATH_PROPS.each do |method|
-        define_method(::EacRubyUtils::Fs::Traversable.prop_method_name(method)) do |_path|
-          nil
-        end
-      end
-
-      BOOLEAN_PROPS.each do |method|
-        define_method(::EacRubyUtils::Fs::Traversable.prop_method_name(method)) do
-          false
-        end
-
-        define_method("#{::EacRubyUtils::Fs::Traversable.prop_method_name(method)}?") do
-          send(method_name)
-        end
-      end
-
-      def traverser_check_path(path)
-        traverser_new.check_path(path)
-      end
-
-      def traverser_new
-        r = ::EacRubyUtils::Fs::Traverser.new
-        (BOOLEAN_PROPS + PATH_PROPS).each do |prop|
-          r.send("#{prop}=", method(::EacRubyUtils::Fs::Traversable.prop_method_name(prop)))
-        end
-        r
-      end
-    end
-  end
-end

data/lib/eac_ruby_utils/fs/traverser.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module Fs
-    class Traverser
-      attr_accessor :check_directory, :check_file, :recursive, :hidden_directories, :sort
-
-      def check_path(path)
-        path = ::Pathname.new(path.to_s) unless path.is_a?(::Pathname)
-        internal_check_path(path, 0)
-      end
-
-      def hidden_directories?
-        boolean_value(hidden_directories)
-      end
-
-      def recursive?
-        boolean_value(recursive)
-      end
-
-      def sort?
-        boolean_value(sort)
-      end
-
-      private
-
-      def boolean_value(source_value)
-        source_value = source_value.call if source_value.respond_to?(:call)
-        source_value ? true : false
-      end
-
-      def each_child(dir, &block)
-        if sort?
-          dir.each_child.sort_by { |p| [p.to_s] }.each(&block)
-        else
-          dir.each_child(&block)
-        end
-      end
-
-      def process_directory?(level)
-        level.zero? || recursive?
-      end
-
-      def inner_check_directory(dir, level)
-        return unless process_directory?(level)
-
-        user_check_directory(dir)
-        each_child(dir) do |e|
-          next unless !e.basename.to_s.start_with?('.') || hidden_directories?
-
-          internal_check_path(e, level + 1)
-        end
-      end
-
-      def internal_check_path(path, level)
-        if path.file?
-          user_check_file(path)
-        elsif path.directory?
-          inner_check_directory(path, level)
-        end
-      end
-
-      def user_check_file(path)
-        check_file&.call(path)
-      end
-
-      def user_check_directory(path)
-        check_directory&.call(path)
-      end
-    end
-  end
-end