eac_ruby_utils 0.125.0 → 0.127.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4decfb4061ccef911b55104f59a49e4a75dee175d5cc08fff7d8cde0f826a126
-  data.tar.gz: dc239d0a41eb9e43ccbfc3a9776dc36f689f0963243b0df9f43dc5f5e6213e43
+  metadata.gz: 1eca375f90c7ffb3c396d1ca14f300e80a371d257634d7c09c8ae0f18f435dfd
+  data.tar.gz: 5a52cdfc7394d729ac702b0b5df8a5721afcdb79aa75d69aee25be06a20159c5
 SHA512:
-  metadata.gz: f7fa02c030b616f9463453e072d1eff2ae00b5e7a100655670d869858f4d2f6a2261426832e7390dae78ab6869e984912ae785c4149cf20dd412442be9bec507
-  data.tar.gz: bbec39d79d0ebe83ed89ccb00810dd5f330c2600225d3ea832533aa25271d29a7a95740055aac0338f1155e6c6620cb9e171d548f4b345ace3cc584da6b93e18
+  metadata.gz: 33098fe65997ad6b380543fb11a1d43be9b604748c180f1ac1bd294e98dba83892b4ebd90c5cead54fe3a21c684c1cda2464cec67ef599605758e207fba1518b
+  data.tar.gz: fdc66f5a7426bc825db9e472574b6500c656f9cd6aad33587b60daf438db6b45fc6f6971bdd4c3515a799d67515e85bfd76d10e6f0f75bc8f129ecd351e5ebfe

data/lib/eac_ruby_utils/common_constructor.rb

@@ -4,6 +4,7 @@ require 'active_support/callbacks'
 require 'eac_ruby_utils/arguments_consumer'
 require 'eac_ruby_utils/common_constructor/class_accessors'
 require 'eac_ruby_utils/common_constructor/class_initialize'
+require 'eac_ruby_utils/patches/object/call_if_proc'
 
 module EacRubyUtils
   class CommonConstructor
@@ -66,8 +67,9 @@ module EacRubyUtils
       options[:block_arg] || false
     end
 
+    # @return [Enumerable]
     def default_values
-      options[:default] || []
+      options[:default].call_if_proc || []
     end
 
     def setup_class(klass)

data/lib/eac_ruby_utils/fs/extname.rb

@@ -1,28 +1,33 @@
 # frozen_string_literal: true
 
+require 'eac_ruby_utils/patches/module/common_concern'
+
 module EacRubyUtils
   module Fs
-    class << self
-      # A [File.extname] which find multiple extensions (Ex.: .tar.gz).
-      def extname(path, limit = -1)
-        recursive_extension(::File.basename(path), limit)
-      end
+    module Extname
+      common_concern
+      class_methods do
+        # A [File.extname] which find multiple extensions (Ex.: .tar.gz).
+        def extname(path, limit = -1)
+          recursive_extension(::File.basename(path), limit)
+        end
 
-      # Shortcut to +extname(2)+.
-      def extname2(path)
-        extname(path, 2)
-      end
+        # Shortcut to +extname(2)+.
+        def extname2(path)
+          extname(path, 2)
+        end
 
-      private
+        private
 
-      def recursive_extension(basename, limit)
-        return '' if limit.zero?
+        def recursive_extension(basename, limit)
+          return '' if limit.zero?
 
-        m = /\A(.+)(\.[a-z][a-z0-9]*)\z/i.match(basename)
-        if m
-          "#{recursive_extension(m[1], limit - 1)}#{m[2]}"
-        else
-          ''
+          m = /\A(.+)(\.[a-z][a-z0-9]*)\z/i.match(basename)
+          if m
+            "#{recursive_extension(m[1], limit - 1)}#{m[2]}"
+          else
+            ''
+          end
         end
       end
     end

data/lib/eac_ruby_utils/fs.rb

@@ -4,6 +4,8 @@ require 'eac_ruby_utils/require_sub'
 
 module EacRubyUtils
   module Fs
+    include ::EacRubyUtils::Fs::Extname
+
     ::EacRubyUtils.require_sub __FILE__
   end
 end

data/lib/eac_ruby_utils/objects_table.rb

@@ -4,7 +4,10 @@ require 'eac_ruby_utils/regexp_parser'
 
 module EacRubyUtils
   class ObjectsTable
-    BY_PARSER = ::EacRubyUtils::RegexpParser.new(/\Aby_(.+)\z/) { |m| m[1] }
+    BY_PARSER = ::EacRubyUtils::RegexpParser.new(/\Aby_([^!\?]+)(!)?\z/) do |m|
+      BY_PARSER_PARSED_STRUCT.new(m[1], "by_attribute#{m[2].present? ? '!' : ''}")
+    end
+    BY_PARSER_PARSED_STRUCT = ::Struct.new(:attribute, :method_name)
 
     common_constructor :objects, default: [[]]
 
@@ -28,8 +31,8 @@ module EacRubyUtils
     end
 
     def method_missing(method_name, *arguments, &block)
-      if (attribute = BY_PARSER.parse(method_name))
-        return by_attribute(attribute, *arguments, &block)
+      if (parsed = BY_PARSER.parse(method_name))
+        return send(parsed.method_name, parsed.attribute, *arguments, &block)
       end
 
       super

data/lib/eac_ruby_utils/patch_module.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patches/module/common_concern'
+
+module EacRubyUtils
+  module PatchModule
+    common_concern
+
+    class_methods do
+      def patch_module(target, patch)
+        return if target.included_modules.include?(patch)
+
+        target.send(:include, patch)
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/patches/class/method_class.rb

@@ -4,6 +4,6 @@ require 'eac_ruby_utils/method_class'
 
 class Module
   def enable_method_class
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::MethodClass)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::MethodClass)
   end
 end

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

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

data/lib/eac_ruby_utils/patches/class/static_method_class.rb

@@ -4,6 +4,6 @@ require 'eac_ruby_utils/static_method_class'
 
 class Module
   def enable_static_method_class
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::StaticMethodClass)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::StaticMethodClass)
   end
 end

data/lib/eac_ruby_utils/patches/integer/rjust_zero.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils'
+
+class Integer
+  RJUST_ZERO_STRING = '0'
+
+  # @param size [Integer]
+  # @return [String]
+  def rjust_zero(size)
+    to_s.rjust(size, RJUST_ZERO_STRING)
+  end
+end

data/lib/eac_ruby_utils/patches/integer.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+EacRubyUtils.require_sub __FILE__

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

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/patch_module'
 require 'eac_ruby_utils/acts_as_immutable'
 
 class Module
   def acts_as_immutable
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::ActsAsImmutable)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::ActsAsImmutable)
   end
 end

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

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/patch_module'
 require 'eac_ruby_utils/contextualizable'
 
 class Module
   # Patches module with [EacRubyUtils::Contextualizable].
   def enable_context
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::Contextualizable)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::Contextualizable)
   end
 end

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

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/patch_module'
 require 'eac_ruby_utils/acts_as_immutable'
 
 class Module
   # @deprecated Use {#acts_as_immutable} instead.
   def enable_immutable
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::ActsAsImmutable)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::ActsAsImmutable)
   end
 end

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

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/patch_module'
 require 'eac_ruby_utils/listable'
 
 class Module
   def enable_listable
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::Listable)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::Listable)
   end
 end

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patch_module'
+
+class Module
+  def patch_self(patch_module)
+    ::EacRubyUtils.patch_module(self, patch_module)
+  end
+end

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

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/patch'
+require 'eac_ruby_utils/patch_module'
 require 'eac_ruby_utils/simple_cache'
 
 class Module
   def enable_simple_cache
-    ::EacRubyUtils.patch(self, ::EacRubyUtils::SimpleCache)
+    ::EacRubyUtils.patch_module(self, ::EacRubyUtils::SimpleCache)
   end
 end

data/lib/eac_ruby_utils/patches/pathname/basename_noext.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/fs/extname'
 require 'pathname'
 
 class Pathname

data/lib/eac_ruby_utils/root_module_setup.rb

@@ -1,16 +1,107 @@
 # frozen_string_literal: true
 
+require 'active_support/inflector'
+require 'eac_ruby_utils/patches/pathname'
+require 'eac_ruby_utils/patches/object/to_pathname'
 require 'zeitwerk'
 
 module EacRubyUtils
   class RootModuleSetup
+    DEFAULT_NAMESPACE = ::Object
+    LIB_DIRECTORY_BASENAME = 'lib'
+
     class << self
-      def perform; end
+      # @param root_module_file [String]
+      def perform(root_module_file, &block)
+        new(root_module_file, &block).perform
+      end
+    end
+
+    attr_reader :block, :root_module_file
+
+    # @param root_module_file [String]
+    def initialize(root_module_file, &block)
+      self.root_module_file = root_module_file
+      self.block = block
+    end
+
+    # @return [Module, nil]
+    def extension_for
+      dirname = ::File.dirname(relative_root_module_file)
+      return nil if ['.', '/', ''].include?(dirname)
+
+      require dirname
+      ::ActiveSupport::Inflector.constantize(dirname.classify)
     end
 
+    # @param path [String] Relative path to root module's directory.
+    def ignore(path)
+      count_before = loader.send(:ignored_paths).count
+      target_path = path.to_pathname.basename_sub { |b| "#{b.basename('.*')}.rb" }
+                      .expand_path(root_module_directory)
+      result = loader.ignore target_path
+      return result if result.count > count_before
+
+      raise ::ArgumentError, [
+        "Trying to ignore path \"#{path}\" did not increase the ignored paths.",
+        "Argument path: \"#{path}\"", "Target path: \"#{target_path}\"", "Ignored paths: #{result}"
+      ].join("\n")
+    end
+
+    # @return [Module]
+    def namespace
+      extension_for || DEFAULT_NAMESPACE
+    end
+
+    # @return [void]
     def perform
-      loader = Zeitwerk::Loader.for_gem
+      perform_block
+      perform_zeitwerk
+    end
+
+    # @return [String]
+    def relative_root_module_file
+      count = 0
+      current = ::File.basename(root_module_file, '.*')
+      dirname = ::File.dirname(root_module_file)
+      loop do
+        ibr if dirname == '/'
+
+        break current if ::File.basename(dirname) == LIB_DIRECTORY_BASENAME
+
+        current = ::File.join(::File.basename(dirname), current)
+        dirname = ::File.dirname(dirname)
+
+        count += 1
+      end
+    end
+
+    # @return [String]
+    def root_module_directory
+      ::File.expand_path(::File.basename(root_module_file, '.*'),
+                         ::File.dirname(root_module_file))
+    end
+
+    protected
+
+    attr_writer :block, :root_module_file
+
+    def perform_block
+      instance_eval(&block) if block
+    end
+
+    # @return [void]
+    def perform_zeitwerk
       loader.setup
     end
+
+    # @return [Zeitwerk::GemLoader]
+    def loader
+      @loader ||= ::Zeitwerk::Registry.loader_for_gem(
+        root_module_file,
+        namespace: namespace,
+        warn_on_extra_files: true
+      )
+    end
   end
 end

data/lib/eac_ruby_utils/rspec/default_setup.rb

@@ -4,16 +4,19 @@ require 'eac_ruby_utils/rspec/setup_manager'
 
 module EacRubyUtils
   module Rspec
-    class << self
-      # @return [EacRubyUtils::Rspec::SetupManager]
-      def default_setup
-        @default_setup ||
-          raise("Default instance was not set. Use #{self.class.name}.default_setup_create")
-      end
+    module DefaultSetup
+      common_concern
+      class_methods do
+        # @return [EacRubyUtils::Rspec::SetupManager]
+        def default_setup
+          @default_setup ||
+            raise("Default instance was not set. Use #{self.class.name}.default_setup_create")
+        end
 
-      # @return [EacRubyUtils::Rspec::SetupManager]
-      def default_setup_create(app_root_path, rspec_config = nil)
-        @default_setup = ::EacRubyUtils::Rspec::SetupManager.create(app_root_path, rspec_config)
+        # @return [EacRubyUtils::Rspec::SetupManager]
+        def default_setup_create(app_root_path, rspec_config = nil)
+          @default_setup = ::EacRubyUtils::Rspec::SetupManager.create(app_root_path, rspec_config)
+        end
       end
     end
   end

data/lib/eac_ruby_utils/rspec.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/require_sub'
-EacRubyUtils.require_sub(__FILE__)
+require 'eac_ruby_utils/patches/module/require_sub'
 
 module EacRubyUtils
   module Rspec
+    require_sub __FILE__, include_modules: true
   end
 end

data/lib/eac_ruby_utils/version.rb

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

data/lib/eac_ruby_utils.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
 require 'eac_ruby_utils/root_module_setup'
-EacRubyUtils::RootModuleSetup.perform
+EacRubyUtils::RootModuleSetup.perform __FILE__ do
+  ignore 'core_ext'
+  ignore 'locales/from_all_gems'
+  ignore 'patches'
+  ignore 'ruby/on_clean_environment'
+end
 
 module EacRubyUtils
+  include ::EacRubyUtils::PatchModule
 end
 
 require 'eac_ruby_utils/core_ext'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.125.0
+  version: 0.127.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-04-04 00:00:00.000000000 Z
+date: 2025-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -139,6 +139,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -146,6 +149,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.1
 description: 
 email: 
 executables: []
@@ -244,7 +250,7 @@ files:
 - lib/eac_ruby_utils/module_ancestors_variable/set.rb
 - lib/eac_ruby_utils/objects_table.rb
 - lib/eac_ruby_utils/options_consumer.rb
-- lib/eac_ruby_utils/patch.rb
+- lib/eac_ruby_utils/patch_module.rb
 - lib/eac_ruby_utils/patches.rb
 - lib/eac_ruby_utils/patches/addressable.rb
 - lib/eac_ruby_utils/patches/addressable/uri.rb
@@ -266,6 +272,8 @@ files:
 - lib/eac_ruby_utils/patches/hash/options_consumer.rb
 - lib/eac_ruby_utils/patches/hash/sym_keys_hash.rb
 - lib/eac_ruby_utils/patches/hash/to_struct.rb
+- lib/eac_ruby_utils/patches/integer.rb
+- lib/eac_ruby_utils/patches/integer/rjust_zero.rb
 - lib/eac_ruby_utils/patches/kernel.rb
 - lib/eac_ruby_utils/patches/kernel/ibr.rb
 - lib/eac_ruby_utils/patches/kernel/nyi.rb
@@ -281,7 +289,7 @@ files:
 - lib/eac_ruby_utils/patches/module/immutable.rb
 - lib/eac_ruby_utils/patches/module/listable.rb
 - lib/eac_ruby_utils/patches/module/module_parent.rb
-- lib/eac_ruby_utils/patches/module/patch.rb
+- lib/eac_ruby_utils/patches/module/patch_self.rb
 - lib/eac_ruby_utils/patches/module/require_sub.rb
 - lib/eac_ruby_utils/patches/module/simple_cache.rb
 - lib/eac_ruby_utils/patches/module/speaker.rb

data/lib/eac_ruby_utils/patch.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  class << self
-    def patch(target, patch)
-      return if target.included_modules.include?(patch)
-
-      target.send(:include, patch)
-    end
-  end
-end

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

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patch'
-
-class Module
-  def patch(patch_module)
-    ::EacRubyUtils.patch(self, patch_module)
-  end
-end