eac_ruby_utils 0.61.0 → 0.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a49138197a3fe16cb9a5e1f22326be1240a10f568c3ddc913e9c6f2a7501475
-  data.tar.gz: e218f41a27514ca27c634619ae7eecc3fe4d7442ba546a9c24f584d437ecfe77
+  metadata.gz: 823da035ba7b8dc287824ac361ede6806dc17dd19aeb1ae2cd4626f3d1883231
+  data.tar.gz: 44ad34e935574af466a3a3b9eb72859074f58b43759c2355423f7162bab9df66
 SHA512:
-  metadata.gz: f3000972a617e1f15500506c4e61909c50418dd9794c6516154962dd5f55b1173b612aa9d1bf0c23dbaee205ccc01abd93b1349f80147c53bc4f3640bb7739e6
-  data.tar.gz: 9a021a5edb6bb22208d22cfc45fd17a486f9cd6c919a8a9495b2afe3b75a51b238172fd350f6977edd02669f7e77beab1ed7e53f7070bd36ebfa058dc52273a4
+  metadata.gz: a98249defe02854ceb5b865b6ed1c63cb78cf93ec2e70340428dc0a7ebc5f864fddd30f57108b7892959a3bbc9ab9a00c574c73d2e827e59d105f927347df2d0
+  data.tar.gz: 414b7753c72ea221e05a9b41f2563fe5c01c82025658aae6ca13bd705c791a7c78400c45e0663c7118b24d8007fcd7164c9ad88864a45767f472fa52e31ba99d

data/lib/eac_ruby_utils/envs/command.rb

@@ -10,7 +10,6 @@ module EacRubyUtils
   module Envs
     class Command
       require_sub __FILE__, include_modules: true
-      enable_console_speaker
 
       def initialize(env, command, extra_options = {})
         @env = env
@@ -61,17 +60,17 @@ module EacRubyUtils
 
       def execute(options = {})
         c = command(options)
-        puts "BEFORE: #{c}".light_red if debug?
+        debug_print("BEFORE: #{c}")
         t1 = Time.now
         r = ::EacRubyUtils::Envs::Process.new(c).to_h
         i = Time.now - t1
-        puts "AFTER [#{i}]: #{c}".light_red if debug?
+        debug_print("AFTER [#{i}]: #{c}")
         r
       end
 
       def spawn(options = {})
         c = command(options)
-        puts "SPAWN: #{c}".light_red if debug?
+        debug_print("SPAWN: #{c}")
         ::EacRubyUtils::Envs::Spawn.new(c)
       end
 
@@ -83,7 +82,7 @@ module EacRubyUtils
 
       def system(options = {})
         c = command(options)
-        puts c.light_red if debug?
+        debug_print(c)
         Kernel.system(c)
       end
 
@@ -109,6 +108,12 @@ module EacRubyUtils
         ENV['DEBUG'].to_s.strip != ''
       end
 
+      # Print a message if debugging is enabled.
+      def debug_print(message)
+        message = message.to_s
+        puts message.if_respond(:light_red, message) if debug?
+      end
+
       def append_command_options(command, options)
         command = options[:input].command + ' | ' + command if options[:input]
         if options[:input_file]

data/lib/eac_ruby_utils/filesystem_cache.rb

@@ -24,6 +24,12 @@ module EacRubyUtils
       ::File.read(content_path)
     end
 
+    def read_or_cache
+      write(yield) unless cached?
+
+      read
+    end
+
     def write(value)
       assert_directory_on_path
       ::File.write(content_path, value)

data/lib/eac_ruby_utils/inflector.rb

@@ -7,11 +7,19 @@ module EacRubyUtils
     class << self
       VARIABLE_NAME_PATTERN = /[_a-z][_a-z0-9]*/i.freeze
 
-      def variableize(string)
+      # Convert a string to a variable format: first character as a lowercase letter or underscore
+      # and other as a lowercase letter, underscore or numbers.
+      # @param string [String] The source string.
+      # @param validate [Boolean] Affect the outcome when the result builded is not in a valid
+      #   variable format. If `true`, it raises a {ArgumentError}. If `false`, return `nil`.
+      # @return [String, nil]
+      # @raise [ArgumentError]
+      def variableize(string, validate = true)
         r = ::ActiveSupport::Inflector.transliterate(string).gsub(/[^_a-z0-9]/i, '_')
                                       .gsub(/_+/, '_').gsub(/_\z/, '').gsub(/\A_/, '').downcase
         m = VARIABLE_NAME_PATTERN.match(r)
         return r if m
+        return nil unless validate
 
         raise ::ArgumentError, "Invalid variable name \"#{r}\" was generated " \
           "from string \"#{string}\""

data/lib/eac_ruby_utils/listable/list.rb

@@ -54,8 +54,9 @@ module EacRubyUtils
       end
 
       def value_validate!(value, error_class = ::StandardError)
-        value_valid?(value) ||
-          raise(error_class, "Invalid value: \"#{value}\" (Valid: #{values_to_s})")
+        return value if value_valid?(value)
+
+        raise(error_class, "Invalid value: \"#{value}\" (Valid: #{values_to_s})")
       end
 
       def values_to_s

data/lib/eac_ruby_utils/patches/kernel/nyi.rb

@@ -2,7 +2,9 @@
 
 module Kernel
   # Raise exception with text "Not yet implemented".
-  def nyi
-    raise "Not yet implemented (Called in #{caller.first})"
+  def nyi(message = nil)
+    s = "Not yet implemented (Called in #{caller.first})"
+    s += ": #{message}" if message
+    raise s
   end
 end

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

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'eac_ruby_utils/common_concern'
-require 'eac_ruby_utils/console/speaker'
 
 class Module
   def common_concern(&after_callback)

data/lib/eac_ruby_utils/patches/regexp/to_parser.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/regexp_parser'
+
+class Regexp
+  # @return [::EacRubyUtils::RegexpParser]
+  def to_parser(&block)
+    ::EacRubyUtils::RegexpParser.new(self, &block)
+  end
+end

data/lib/eac_ruby_utils/patches/string/inflector.rb

@@ -3,7 +3,9 @@
 require 'eac_ruby_utils/inflector'
 
 class String
-  def variableize
-    ::EacRubyUtils::Inflector.variableize(self)
+  # Shortcut to `EacRubyUtils::Inflector.variableize(self, ...)`.
+  # @see EacRubyUtils::Inflector.variableize
+  def variableize(validate = true)
+    ::EacRubyUtils::Inflector.variableize(self, validate)
   end
 end

data/lib/eac_ruby_utils/regexp_parser.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  class RegexpParser
+    attr_reader :pattern, :builder_proc
+
+    def initialize(pattern, &builder_proc)
+      @pattern = pattern
+      @builder_proc = builder_proc
+    end
+
+    def parse(string)
+      internal_parse(string)[1]
+    end
+
+    def parse!(string)
+      match, result = internal_parse(string)
+      return result if match
+
+      raise ::ArgumentError, "String \"#{string}\" does not match pattern \"#{pattern}\""
+    end
+
+    private
+
+    def internal_parse(string)
+      m = pattern.match(string)
+      if m
+        [true, builder_proc ? builder_proc.call(m) : m]
+      else
+        [false, nil]
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/rspec/conditional.rb

@@ -1,13 +1,10 @@
 # frozen_string_literal: true
 
 require 'active_support/core_ext/object/blank'
-require 'eac_ruby_utils/console/speaker'
 
 module EacRubyUtils
   module Rspec
     class Conditional
-      include ::EacRubyUtils::Console::Speaker
-
       def self.default
         @default ||= new
       end
@@ -24,7 +21,7 @@ module EacRubyUtils
         tags.each do |tag, condition|
           message = condition.call
           if message.present?
-            warn("Excluded tag: #{tag}: #{message}")
+            puts("[WARN] Excluded tag: #{tag}: #{message}")
             rspec_config.filter_run_excluding tag
           end
         end

data/lib/eac_ruby_utils/simple_cache.rb

@@ -2,12 +2,18 @@
 
 module EacRubyUtils
   module SimpleCache
-    UNCACHED_METHOD_PATTERN = /\A(\s+)_uncached\z/.freeze
+    UNCACHED_METHOD_NAME_SUFFIX = '_uncached'
+    UNCACHED_METHOD_PATTERN = /\A(\s+)_#{::Regexp.quote(UNCACHED_METHOD_NAME_SUFFIX)}\z/.freeze
+
+    class << self
+      def uncached_method_name(method_name)
+        "#{method_name}#{UNCACHED_METHOD_NAME_SUFFIX}"
+      end
+    end
 
     def method_missing(method, *args, &block)
-      uncached_method = "#{method}_uncached"
-      if respond_to?(uncached_method, true)
-        call_method_with_cache(uncached_method, args, &block)
+      if respond_to?(::EacRubyUtils::SimpleCache.uncached_method_name(method), true)
+        call_method_with_cache(method, args, &block)
       else
         super
       end
@@ -35,10 +41,17 @@ module EacRubyUtils
       raise 'Não é possível realizar o cache de métodos com bloco' if block
 
       key = ([method] + args).join('@@@')
-      cache_keys[key] = send(method, *args) unless cache_keys.key?(key)
+      unless cache_keys.key?(key)
+        uncached_value = call_uncached_method(method, args)
+        cache_keys[key] = uncached_value
+      end
       cache_keys[key]
     end
 
+    def call_uncached_method(method, args)
+      send(::EacRubyUtils::SimpleCache.uncached_method_name(method), *args)
+    end
+
     def cache_keys
       @cache_keys ||= {}
     end

data/lib/eac_ruby_utils/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.61.0
+  version: 0.65.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-17 00:00:00.000000000 Z
+date: 2021-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -38,34 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-- !ruby/object:Gem::Dependency
-  name: colorize
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.8.1
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.8.1
-- !ruby/object:Gem::Dependency
-  name: docopt
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.1
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.1
 - !ruby/object:Gem::Dependency
   name: filesize
   requirement: !ruby/object:Gem::Requirement
@@ -100,20 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.2'
 description: 
 email: 
 executables: []
@@ -134,26 +100,6 @@ 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/configs.rb
-- lib/eac_ruby_utils/configs/base.rb
-- lib/eac_ruby_utils/configs/file.rb
-- lib/eac_ruby_utils/console.rb
-- lib/eac_ruby_utils/console/configs.rb
-- lib/eac_ruby_utils/console/configs/entry_reader.rb
-- lib/eac_ruby_utils/console/configs/password_entry_reader.rb
-- lib/eac_ruby_utils/console/configs/read_entry_options.rb
-- lib/eac_ruby_utils/console/configs/store_passwords_entry_reader.rb
-- lib/eac_ruby_utils/console/docopt_runner.rb
-- lib/eac_ruby_utils/console/docopt_runner/_class_methods.rb
-- lib/eac_ruby_utils/console/docopt_runner/_doc.rb
-- lib/eac_ruby_utils/console/docopt_runner/_settings.rb
-- lib/eac_ruby_utils/console/docopt_runner/_subcommands.rb
-- lib/eac_ruby_utils/console/speaker.rb
-- lib/eac_ruby_utils/console/speaker/_class_methods.rb
-- lib/eac_ruby_utils/console/speaker/_constants.rb
-- lib/eac_ruby_utils/console/speaker/list.rb
-- lib/eac_ruby_utils/console/speaker/node.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/envs.rb
@@ -222,33 +168,28 @@ 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/console_speaker.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/template.rb
 - lib/eac_ruby_utils/patches/object.rb
 - lib/eac_ruby_utils/patches/object/asserts.rb
 - lib/eac_ruby_utils/patches/object/debug.rb
 - lib/eac_ruby_utils/patches/object/if_nil.rb
 - lib/eac_ruby_utils/patches/object/if_present.rb
 - lib/eac_ruby_utils/patches/object/if_respond.rb
-- lib/eac_ruby_utils/patches/object/template.rb
 - 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/regexp.rb
 - lib/eac_ruby_utils/patches/regexp/if_match.rb
+- lib/eac_ruby_utils/patches/regexp/to_parser.rb
 - lib/eac_ruby_utils/patches/string.rb
 - lib/eac_ruby_utils/patches/string/inflector.rb
 - lib/eac_ruby_utils/patches/time.rb
 - lib/eac_ruby_utils/patches/time/required_zone.rb
-- lib/eac_ruby_utils/paths_hash.rb
-- lib/eac_ruby_utils/paths_hash/entry_key_error.rb
-- lib/eac_ruby_utils/paths_hash/node.rb
-- lib/eac_ruby_utils/paths_hash/path_search.rb
+- lib/eac_ruby_utils/regexp_parser.rb
 - lib/eac_ruby_utils/require_sub.rb
 - lib/eac_ruby_utils/rspec.rb
 - lib/eac_ruby_utils/rspec/conditional.rb
@@ -260,16 +201,6 @@ files:
 - lib/eac_ruby_utils/settings_provider/setting_value.rb
 - lib/eac_ruby_utils/simple_cache.rb
 - lib/eac_ruby_utils/struct.rb
-- lib/eac_ruby_utils/templates.rb
-- lib/eac_ruby_utils/templates/directory.rb
-- lib/eac_ruby_utils/templates/file.rb
-- lib/eac_ruby_utils/templates/searcher.rb
-- lib/eac_ruby_utils/templates/variable_not_found_error.rb
-- lib/eac_ruby_utils/templates/variable_providers.rb
-- lib/eac_ruby_utils/templates/variable_providers/base.rb
-- lib/eac_ruby_utils/templates/variable_providers/entries_reader.rb
-- lib/eac_ruby_utils/templates/variable_providers/generic.rb
-- lib/eac_ruby_utils/templates/variable_providers/hash.rb
 - lib/eac_ruby_utils/version.rb
 - lib/eac_ruby_utils/yaml.rb
 homepage: 

data/lib/eac_ruby_utils/configs.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/core_ext/string'
-require 'yaml'
-require 'eac_ruby_utils/configs/file'
-require 'eac_ruby_utils/patches/hash/sym_keys_hash'
-require 'eac_ruby_utils/paths_hash'
-require 'eac_ruby_utils/simple_cache'
-
-module EacRubyUtils
-  class Configs
-    include ::EacRubyUtils::SimpleCache
-
-    attr_reader :configs_key, :options
-
-    # Valid options: [:storage_path]
-    def initialize(configs_key, options = {})
-      @configs_key = configs_key
-      @options = options.to_sym_keys_hash.freeze
-      load
-    end
-
-    delegate :clear, to: :file
-
-    delegate :save, to: :file
-
-    delegate :load, to: :file
-
-    def []=(entry_key, entry_value)
-      write_entry(entry_key, entry_value)
-    end
-
-    def write_entry(entry_key, entry_value)
-      file.write(entry_key, entry_value)
-    end
-
-    def [](entry_key)
-      read_entry(entry_key)
-    end
-
-    def read_entry(entry_key)
-      file.read(entry_key)
-    end
-
-    delegate :autosave?, to: :file
-
-    private
-
-    attr_accessor :data
-
-    def file_uncached
-      ::EacRubyUtils::Configs::File.new(
-        storage_path, options
-      )
-    end
-
-    def storage_path_uncached
-      path = options_storage_path || default_storage_path
-      return path if ::File.exist?(path) && ::File.size(path).positive?
-
-      ::FileUtils.mkdir_p(::File.dirname(path))
-      ::File.write(path, {}.to_yaml)
-      path
-    end
-
-    def options_storage_path
-      options[:storage_path]
-    end
-
-    def default_storage_path
-      ::File.join(ENV['HOME'], '.config', configs_key, 'settings.yml')
-    end
-  end
-end