eac_ruby_utils 0.64.0 → 0.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aebc2af21cfa1d812eb22e31af074450b65a3fd9641cfc072086f63b79e42ca5
-  data.tar.gz: 86257e2b0311d994c1ca761826c0726c77433765f8604a072339256d2145e9fc
+  metadata.gz: 0fab6e5db312ff7ad93ceadf6412b41ecb725d5ad8ea13c0b0f4f350b6d2dfa0
+  data.tar.gz: 1a3a81dfa1baaac26a79bcd25f2b6559555445b7f1075a00d54d7ed78fd999c6
 SHA512:
-  metadata.gz: 953714355bec27c6d0c732391c15fc63042b50953a042e13e7d9563998c83e3ca74f0c3547aca0d2367008ca6c655e76cab52eedd6ab7de1b4f0a572c38ad2f4
-  data.tar.gz: d2714d1ceee3653692b2cf7ba197cb8814145e4a40e2e9a80edd1d7b08e6abe8dfef274b64536b5f68634086eabcb0a0e65a20724d40754b34dd5ccaf57fce91
+  metadata.gz: e776c88a80777227d29e2055e2f06e865d849486aa8d7489f56156e986030dd0bf6a9c261c01a3ec7a1775581780f2ad201e4c26a9b68fc4b24c6eef0b01f090
+  data.tar.gz: ca955067e64bd91a42d606e6d55c0bb3655ee140b18db5452276972f4ac1dcbceb5aacbfedf6f8638f8f246e8d1b9b0a6f56c639415ce91510cd67754b9f8848

data/lib/eac_ruby_utils/context.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  class Context
+    def current
+      optional_current || raise('No elements in context')
+    end
+
+    def optional_current
+      stack.last
+    end
+
+    delegate :pop, to: :stack
+    delegate :push, to: :stack
+
+    def on(obj)
+      push(obj)
+      begin
+        yield
+      ensure
+        pop
+      end
+    end
+
+    private
+
+    def stack
+      @stack ||= []
+    end
+  end
+end

data/lib/eac_ruby_utils/contextualizable.rb

@@ -1,16 +1,21 @@
 # frozen_string_literal: true
 
+require 'eac_ruby_utils/context'
+
 module EacRubyUtils
-  # Provides the method context which search and call a method in self and ancestor objects.
   module Contextualizable
-    def context(method)
-      current = self
-      while current
-        return current.send(method) if current.respond_to?(method)
+    common_concern
+
+    module ClassMethods
+      def context
+        @context ||= ::EacRubyUtils::Context.new
+      end
+    end
 
-        current = current.respond_to?(:parent) ? current.parent : nil
+    module InstanceMethods
+      def context
+        self.class.context
       end
-      raise "Context method \"#{method}\" not found for #{self.class}"
     end
   end
 end

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

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

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/speaker/sender'
+
+class Module
+  def enable_speaker
+    include ::EacRubyUtils::Speaker::Sender
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+class Pathname
+  # Apply .parent n times.
+  # @return [Pathname]
+  def parent_n(n) # rubocop:disable Naming/MethodParameterName
+    n.times.inject(self) { |a, _e| a.parent }
+  end
+end

data/lib/eac_ruby_utils/simple_cache.rb

@@ -3,11 +3,19 @@
 module EacRubyUtils
   module SimpleCache
     UNCACHED_METHOD_NAME_SUFFIX = '_uncached'
-    UNCACHED_METHOD_PATTERN = /\A(\s+)_#{::Regexp.quote(UNCACHED_METHOD_NAME_SUFFIX)}\z/.freeze
+    UNCACHED_METHOD_PATTERN = /
+      \A(\s+)_#{::Regexp.quote(UNCACHED_METHOD_NAME_SUFFIX)}([\!\?]?)\z
+    /x.freeze
 
     class << self
       def uncached_method_name(method_name)
-        "#{method_name}#{UNCACHED_METHOD_NAME_SUFFIX}"
+        method_name = method_name.to_s
+        end_mark = nil
+        if %w[! ?].any? { |mark| method_name.end_with?(mark) }
+          end_mark = method_name[-1]
+          method_name = method_name[0..-2]
+        end
+        "#{method_name}#{UNCACHED_METHOD_NAME_SUFFIX}#{end_mark}"
       end
     end
 

data/lib/eac_ruby_utils/speaker.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/contextualizable'
+
+module EacRubyUtils
+  module Speaker
+    include ::EacRubyUtils::Contextualizable
+
+    class << self
+      # @return [EacRubyUtils::Speaker::Receiver]
+      def current_receiver
+        context.current
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/speaker/receiver.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/abstract_methods'
+
+module EacRubyUtils
+  module Speaker
+    module Receiver
+      extend ::EacRubyUtils::AbstractMethods
+
+      def error(_string)
+        raise_abstract_method(__FILE__)
+      end
+
+      def fatal_error(string)
+        error(string)
+        ::Kernel.exit 1 # rubocop:disable Rails/Exit
+      end
+
+      # @see EacRubyUtils::Speaker::Sender.input
+      def input(_question, _options = {})
+        raise_abstract_method(__FILE__)
+      end
+
+      def info(_string)
+        raise_abstract_method(__FILE__)
+      end
+
+      def infom(_string)
+        raise_abstract_method(__FILE__)
+      end
+
+      def infov(*_args)
+        raise_abstract_method(__FILE__)
+      end
+
+      def out(_string = '')
+        raise_abstract_method(__FILE__)
+      end
+
+      def puts(_string = '')
+        raise_abstract_method(__FILE__)
+      end
+
+      def success(_string)
+        raise_abstract_method(__FILE__)
+      end
+
+      def title(_string)
+        raise_abstract_method(__FILE__)
+      end
+
+      def warn(_string)
+        raise_abstract_method(__FILE__)
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/speaker/sender.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  module Speaker
+    module Sender
+      delegate :error, :fatal_error, :info, :infom, :title, :success, :warn, to: :speaker_receiver
+
+      def infov(*args)
+        speaker_receiver.infov(*args)
+      end
+
+      delegate :out, to: :speaker_receiver
+
+      delegate :puts, to: :speaker_receiver
+
+      # Shortcut to [EacRubyUtils::Speaker.current_receiver].
+      #
+      # @return [EacRubyUtils::Speaker::Receiver]
+      def speaker_receiver
+        ::EacRubyUtils::Speaker.current_receiver
+      end
+
+      # Options:
+      #   +bool+ ([Boolean], default: +false+): requires a answer "yes" or "no".
+      #   +list+ ([Hash] or [Array], default: +nil+): requires a answer from a list.
+      #   +noecho+ ([Boolean], default: +false+): does not output answer.
+      def input(question, options = {})
+        speaker_receiver.input(question, options)
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.64.0
+  version: 0.69.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-23 00:00:00.000000000 Z
+date: 2021-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -100,6 +100,7 @@ files:
 - lib/eac_ruby_utils/common_constructor/class_initialize.rb
 - lib/eac_ruby_utils/common_constructor/instance_initialize.rb
 - lib/eac_ruby_utils/common_constructor/super_args.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
@@ -169,11 +170,13 @@ 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/context.rb
 - lib/eac_ruby_utils/patches/module/immutable.rb
 - lib/eac_ruby_utils/patches/module/listable.rb
 - lib/eac_ruby_utils/patches/module/patch.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
 - lib/eac_ruby_utils/patches/object.rb
 - lib/eac_ruby_utils/patches/object/asserts.rb
 - lib/eac_ruby_utils/patches/object/debug.rb
@@ -183,6 +186,7 @@ files:
 - lib/eac_ruby_utils/patches/object/to_pathname.rb
 - lib/eac_ruby_utils/patches/pathname.rb
 - lib/eac_ruby_utils/patches/pathname/basename_sub.rb
+- lib/eac_ruby_utils/patches/pathname/parent_n.rb
 - lib/eac_ruby_utils/patches/regexp.rb
 - lib/eac_ruby_utils/patches/regexp/if_match.rb
 - lib/eac_ruby_utils/patches/regexp/to_parser.rb
@@ -201,6 +205,9 @@ files:
 - lib/eac_ruby_utils/settings_provider.rb
 - lib/eac_ruby_utils/settings_provider/setting_value.rb
 - lib/eac_ruby_utils/simple_cache.rb
+- lib/eac_ruby_utils/speaker.rb
+- lib/eac_ruby_utils/speaker/receiver.rb
+- lib/eac_ruby_utils/speaker/sender.rb
 - lib/eac_ruby_utils/struct.rb
 - lib/eac_ruby_utils/version.rb
 - lib/eac_ruby_utils/yaml.rb