eac_ruby_utils 0.113.0 → 0.115.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e7deaaf568625e32fc58c45b43ef41e125924595707b3a2ca2ea394d9dc4393
-  data.tar.gz: 4af93c26f87f2918f36cc18b2ad5e3cefa8d6fe6a21bb09282f0112bd2138182
+  metadata.gz: be84b8b3b5f7b60b56a999c8aa958747cf415dc143ed654f192bbcfd7b3d0d1d
+  data.tar.gz: ca5988e39fe2641aac05312f9ceb18d3a96c1a9d47491832a52a796c7df1a064
 SHA512:
-  metadata.gz: 8144e44599f8dc4b5299a3353e79fc51fa558bcb085e1d8a46d0f40182d06b9c0481f56a4a8b464bddf00a52c67c97d3846875489f90f24d0eba8e87b5ed4384
-  data.tar.gz: 657df0404c6f3060e756198aeeb1181b210b7d18564e4b58437a5d79601e3c62d1f2d5bdb686b221b434c2ad81322817798ea329b77b94c2b110c189631055e0
+  metadata.gz: b21dcf87a2778009eb8571d78aa533e0a1806603c7a298bb181dd0ce3a18cccec688fca12b45954d61abe590a22c538738a0ae570d21a61d03a002f9d4fe74a2
+  data.tar.gz: '099e597c3949a781819a89a9d8c57eaa246696ee50c7d42e93a56e5e8fb5c7111c68042ed3bc483b9e6db68622b1311622a99a9c3d360c3f9733a86f7003fa24'

data/lib/eac_ruby_utils/{abstract_methods.rb → acts_as_abstract.rb}

@@ -8,10 +8,10 @@ module EacRubyUtils
   #
   # Usage:
   #
-  #   require 'eac_ruby_utils/abstract_methods'
+  #   require 'eac_ruby_utils/acts_as_abstract'
   #
   #   class BaseClass
-  #     include EacRubyUtils::AbstractMethods
+  #     include EacRubyUtils::ActsAsAbstract
   #
   #     abstract_methods :mymethod
   #   end
@@ -25,23 +25,44 @@ module EacRubyUtils
   #   end
   #
   #   SubClass.new.mymethod # return "Implemented"
-  module AbstractMethods
+  module ActsAsAbstract
     common_concern
 
     class << self
       def abstract?(a_class)
-        a_class.self_included_modules.include?(::EacRubyUtils::AbstractMethods)
+        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)
+        define_method name.to_sym do |*_the_args|
+          raise_abstract_method(name.to_sym, arguments)
+        end
+      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|
-          define_method method_name do
-            raise_abstract_method(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
     end
 
     module InstanceMethods
@@ -59,9 +80,9 @@ module EacRubyUtils
         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})"
+      def raise_abstract_method(method_name, arguments = [])
+        raise ::NoMethodError, "Abstract method #{method_name}(#{arguments.join(', ')}) hit in " \
+          "#{self}\" (Class: #{self.class})"
       end
     end
   end

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

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 class Class
   def abstract?
-    ::EacRubyUtils::AbstractMethods.abstract?(self)
+    ::EacRubyUtils::ActsAsAbstract.abstract?(self)
   end
 end

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

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/patches/module/acts_as_abstract'
 
 class Module
+  # @deprecated Use {#acts_as_abstract} instead.
   def enable_abstract_methods(*methods)
-    include ::EacRubyUtils::AbstractMethods
-    abstract_methods(*methods)
+    acts_as_abstract(*methods)
   end
 end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/acts_as_abstract'
+
+class Module
+  # Include [EacRubyUtils::ActsAsAbstract] and perform EacRubyUtils::ActsAsAbstract.abstract_methods
+  # on parameter +methods+.
+  # @param methods [Array<Symbol>]
+  # @return [void]
+  def acts_as_abstract(*methods)
+    include ::EacRubyUtils::ActsAsAbstract
+    abstract_methods(*methods)
+  end
+end

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

@@ -3,7 +3,11 @@
 require 'pathname'
 
 class Pathname
+  # @param suffix [String]
+  # @return [Pathname]
   def basename_sub(suffix = '')
-    parent.join(yield(basename(suffix)))
+    new_basename = basename(suffix)
+    new_basename = yield(new_basename) if block_given?
+    parent.join(new_basename)
   end
 end

data/lib/eac_ruby_utils/speaker/receiver.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require 'eac_ruby_utils/abstract_methods'
+require 'eac_ruby_utils/acts_as_abstract'
 
 module EacRubyUtils
   module Speaker
     module Receiver
       extend ::ActiveSupport::Concern
-      extend ::EacRubyUtils::AbstractMethods
+      extend ::EacRubyUtils::ActsAsAbstract
 
       module ClassMethods
         def on(*args, &block)

data/lib/eac_ruby_utils/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.113.0
+  version: 0.115.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-10 00:00:00.000000000 Z
+date: 2023-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -128,7 +128,7 @@ extra_rdoc_files: []
 files:
 - README.rdoc
 - lib/eac_ruby_utils.rb
-- lib/eac_ruby_utils/abstract_methods.rb
+- lib/eac_ruby_utils/acts_as_abstract.rb
 - lib/eac_ruby_utils/arguments_consumer.rb
 - lib/eac_ruby_utils/bit.rb
 - lib/eac_ruby_utils/bit_array.rb
@@ -234,6 +234,7 @@ files:
 - lib/eac_ruby_utils/patches/kernel/nyi.rb
 - lib/eac_ruby_utils/patches/module.rb
 - lib/eac_ruby_utils/patches/module/abstract_methods.rb
+- lib/eac_ruby_utils/patches/module/acts_as_abstract.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