eac_ruby_utils 0.49.1 → 0.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 950ee0e703e04a530326ce6df19fa23a921061a3cc046d1ec880e1c078fd30fa
-  data.tar.gz: 3e81efb81e7fc9e8e5d23f1e5228eb6767be645a5ed1abefcb1d5551c39dc4b0
+  metadata.gz: 8a940f8552466eaafa352add89628375c73a4bc93132d6a85308ed8734806112
+  data.tar.gz: ee918b5a6e350bfff2e835fbc36c4167c06c13ae264039b2e6281d217538029f
 SHA512:
-  metadata.gz: a05690c1726e671c20b7a85e1c0ac44387c085ff2cba3d7381a7ffab7850f056a014f301d2360c8610cd266879ac368af0f27a4c7738ae9a53306442316bbed6
-  data.tar.gz: 256ad147935d38435623279add15c7ae78de97357864cc0d065aaed9b3e2095a4ded3a63ca51ac70c966900f8dff2acc07d887656140cfa65068f5ced27b5eef
+  metadata.gz: 55d385b536020ab4a7f295e88eeccb2baa93cb329d0d7fa4e8c968ba2e1f89f4412e1c6d497614a6433f78a95fce27889f1062d6cfd9fbe95dbae6317bee70b3
+  data.tar.gz: b06d996d30f1d6db36d9d2b3d4f67ba6a730f6afb1d41f08e6be4718cb063b2b4171bc609b8e07f0b304ee09440c60eca798e10b8957d1ee0d3f5505e9fdf2f4

data/lib/eac_ruby_utils/abstract_methods.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patches/module/common_concern'
+
+module EacRubyUtils
+  # Support to abstract methods.
+  #
+  # Usage:
+  #
+  #   require 'eac_ruby_utils/abstract_methods'
+  #
+  #   class BaseClass
+  #     include EacRubyUtils::AbstractMethods
+  #
+  #     abstract_methods :mymethod
+  #   end
+  #
+  #   BaseClass.new.mymethod # raise "Abstract method: mymethod"
+  #
+  #   class SubClass
+  #     def mymethod
+  #       "Implemented"
+  #     end
+  #   end
+  #
+  #   SubClass.new.mymethod # return "Implemented"
+  module AbstractMethods
+    common_concern
+
+    module ClassMethods
+      def abstract_methods(*methods_names)
+        methods_names.each do |method_name|
+          define_method method_name do
+            raise_abstract_method(method_name)
+          end
+        end
+      end
+    end
+
+    module InstanceMethods
+      def respond_to_missing?(method_name, include_private = false)
+        super || abstract_method?(method_name)
+      end
+
+      def method_missing(method_name, *arguments, &block)
+        raise_abstract_method(method_name) if abstract_method?(method_name)
+
+        super
+      end
+
+      def abstract_method?(method_name)
+        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}\""
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/console/configs.rb

@@ -11,18 +11,10 @@ module EacRubyUtils
 
       class << self
         def entry_key_to_envvar_name(entry_key)
-          path = if entry_key.is_a?(::Array)
-                   entry_key
-                 else
-                   ::EacRubyUtils::PathsHash.parse_entry_key(entry_key)
-                 end
-          path.join('_').gsub(/[^a-z0-9_]/i, '').gsub(/\A_+/, '').gsub(/_+\z/, '')
-              .gsub(/_{2,}/, '_').upcase
+          ::EacRubyUtils::Console::Configs::EntryReader.entry_key_to_envvar_name(entry_key)
         end
       end
 
-      STORE_PASSWORDS_KEY = 'core.store_passwords'
-
       attr_reader :configs
 
       def initialize(configs_key, options = {})
@@ -31,72 +23,15 @@ module EacRubyUtils
       end
 
       def read_password(entry_key, options = {})
-        options = ReadEntryOptions.new(options.merge(noecho: true))
-        if store_passwords?
-          read_entry(entry_key, options)
-        else
-          looped_entry_value_from_input(entry_key, options)
-        end
+        ::EacRubyUtils::Console::Configs::PasswordEntryReader.new(self, entry_key, options).read
       end
 
       def read_entry(entry_key, options = {})
-        options = ReadEntryOptions.new(options)
-        unless options[:noenv]
-          envvar_value = envvar_read_entry(entry_key)
-          return envvar_value if envvar_value.present?
-        end
-        stored_value = configs.read_entry(entry_key)
-        return stored_value if stored_value
-        return read_entry_from_console(entry_key, options) unless options[:noinput]
-
-        raise "No value found for entry \"#{entry_key}\"" if options[:required]
+        ::EacRubyUtils::Console::Configs::EntryReader.new(self, entry_key, options).read
       end
 
       def store_passwords?
-        read_entry(
-          STORE_PASSWORDS_KEY,
-          before_input: -> { store_password_banner },
-          validator: ->(entry_value) { %w[yes no].include?(entry_value) }
-        ) == 'yes'
-      end
-
-      protected
-
-      def envvar_read_entry(entry_key)
-        env_entry_key = self.class.entry_key_to_envvar_name(entry_key)
-        return nil unless ENV.key?(env_entry_key)
-
-        ENV.fetch(env_entry_key).if_present(::EacRubyUtils::BlankNotBlank.instance)
-      end
-
-      def read_entry_from_console(entry_key, options)
-        options[:before_input].call if options[:before_input].present?
-        entry_value = looped_entry_value_from_input(entry_key, options)
-        configs.write_entry(entry_key, entry_value)
-        entry_value
-      end
-
-      def store_password_banner
-        infom 'Do you wanna to store passwords?'
-        infom "Warning: the passwords will be store in clear text in \"#{configs.storage_path}\""
-        infom 'Enter "yes" or "no"'
-      end
-
-      def looped_entry_value_from_input(entry_key, options)
-        loop do
-          entry_value = entry_value_from_input(entry_key, options)
-          next if entry_value.blank?
-          next if options[:validator] && !options[:validator].call(entry_value)
-
-          return entry_value
-        end
-      end
-
-      def entry_value_from_input(entry_key, options)
-        entry_value = request_input("Value for entry \"#{entry_key}\"",
-                                    options.request_input_options)
-        warn('Entered value is blank') if entry_value.blank?
-        entry_value
+        ::EacRubyUtils::Console::Configs::StorePasswordsEntryReader.new(self) == 'yes'
       end
     end
   end

data/lib/eac_ruby_utils/console/configs/entry_reader.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/console/configs/read_entry_options'
+require 'eac_ruby_utils/core_ext'
+
+module EacRubyUtils
+  module Console
+    class Configs
+      class EntryReader
+        enable_console_speaker
+
+        class << self
+          def entry_key_to_envvar_name(entry_key)
+            path = if entry_key.is_a?(::Array)
+                     entry_key
+                   else
+                     ::EacRubyUtils::PathsHash.parse_entry_key(entry_key)
+                   end
+            path.join('_').gsub(/[^a-z0-9_]/i, '').gsub(/\A_+/, '').gsub(/_+\z/, '')
+                .gsub(/_{2,}/, '_').upcase
+          end
+        end
+
+        common_constructor :console_configs, :entry_key, :options do
+          self.options = ::EacRubyUtils::Console::Configs::ReadEntryOptions.new(options)
+        end
+
+        def read
+          %w[envvars storage console].each do |suffix|
+            value = send("read_from_#{suffix}")
+            return value if value.present?
+          end
+          return nil unless options[:required]
+
+          raise "No value found for entry \"#{entry_key}\""
+        end
+
+        def read_from_storage
+          console_configs.configs.read_entry(entry_key)
+        end
+
+        def read_from_envvars
+          return if options[:noenv]
+
+          env_entry_key = self.class.entry_key_to_envvar_name(entry_key)
+          return unless ENV.key?(env_entry_key)
+
+          ENV.fetch(env_entry_key).if_present(::EacRubyUtils::BlankNotBlank.instance)
+        end
+
+        def read_from_console
+          return if options[:noinput]
+
+          options[:before_input].if_present(&:call)
+          entry_value = looped_entry_value_from_input
+          console_configs.configs.write_entry(entry_key, entry_value) if options[:store]
+          entry_value
+        end
+
+        private
+
+        def looped_entry_value_from_input
+          loop do
+            entry_value = entry_value_from_input(entry_key, options)
+            next if entry_value.blank?
+            next if options[:validator] && !options[:validator].call(entry_value)
+
+            return entry_value
+          end
+        end
+
+        def entry_value_from_input(entry_key, options)
+          entry_value = request_input("Value for entry \"#{entry_key}\"",
+                                      options.request_input_options)
+          warn('Entered value is blank') if entry_value.blank?
+          entry_value
+        end
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/console/configs/password_entry_reader.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/console/configs/entry_reader'
+
+module EacRubyUtils
+  module Console
+    class Configs
+      class PasswordEntryReader < ::EacRubyUtils::Console::Configs::EntryReader
+        ENTRY_KEY = 'core.store_passwords'
+
+        def initialize(console_configs, entry_key, options = {})
+          super(console_configs, entry_key, options.merge(noecho: true,
+                                                          store: console_configs.store_passwords?))
+        end
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/console/configs/read_entry_options.rb

@@ -7,13 +7,18 @@ module EacRubyUtils
     class Configs
       class ReadEntryOptions
         enable_simple_cache
-        common_constructor :options
+        common_constructor :options do
+          self.options = options.to_h.symbolize_keys
+                                .assert_valid_keys(DEFAULT_VALUES.keys).freeze
+        end
 
         DEFAULT_VALUES = {
           before_input: nil, bool: false, list: false, noecho: false, noenv: false, noinput: false,
-          required: true, validator: nil
+          required: true, store: true, validator: nil
         }.freeze
 
+        delegate :to_h, to: :options
+
         def [](key)
           values.fetch(key.to_sym)
         end

data/lib/eac_ruby_utils/console/configs/store_passwords_entry_reader.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/console/configs/entry_reader'
+
+module EacRubyUtils
+  module Console
+    class Configs
+      class StorePasswordsEntryReader < ::EacRubyUtils::Console::Configs::EntryReader
+        ENTRY_KEY = 'core.store_passwords'
+
+        def initialize(console_configs)
+          super(console_configs, ENTRY_KEY,
+            before_input: -> { banner },
+            validator: ->(entry_value) { %w[yes no].include?(entry_value) }
+          )
+        end
+
+        def banner
+          infom 'Do you wanna to store passwords?'
+          infom 'Warning: the passwords will be store in clear text in ' \
+            "\"#{console_configs.configs.storage_path}\""
+          infom 'Enter "yes" or "no"'
+        end
+      end
+    end
+  end
+end

data/lib/eac_ruby_utils/patches/enumerator.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/enumerator/current.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class Enumerator
+  def current(default_value = nil)
+    peek
+  rescue ::StopIteration
+    default_value
+  end
+end

data/lib/eac_ruby_utils/patches/enumerator/stopped.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class Enumerator
+  def ongoing?
+    !stopped?
+  end
+
+  def stopped?
+    peek
+    false
+  rescue ::StopIteration
+    true
+  end
+end

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

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/abstract_methods'
+
+class Module
+  def enable_abstract_methods(*methods)
+    include ::EacRubyUtils::AbstractMethods
+    abstract_methods(*methods)
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Object
+  def print_debug
+    STDERR.write(to_debug + "\n")
+
+    self
+  end
+
+  def to_debug
+    "|#{self.class}|#{self}|"
+  end
+
+  def raise_debug
+    raise to_debug
+  end
+end

data/lib/eac_ruby_utils/version.rb

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

data/lib/eac_ruby_utils/yaml.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
+require 'date'
 require 'yaml'
 
 module EacRubyUtils
   # A safe YAML loader/dumper with common types included.
   class Yaml
     class << self
-      DEFAULT_PERMITTED_CLASSES = [::Array, ::Date, ::FalseClass, ::Hash, ::NilClass, ::Numeric,
-                                   ::String, ::Symbol, ::Time, ::TrueClass].freeze
+      DEFAULT_PERMITTED_CLASSES = [::Array, ::Date, ::DateTime, ::FalseClass, ::Hash, ::NilClass,
+                                   ::Numeric, ::String, ::Symbol, ::Time, ::TrueClass].freeze
 
       def dump(object)
         ::YAML.dump(sanitize(object))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.49.1
+  version: 0.53.0
 platform: ruby
 authors:
 - Esquilo Azul Company
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-11-10 00:00:00.000000000 Z
+date: 2020-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -108,6 +108,7 @@ extra_rdoc_files: []
 files:
 - README.rdoc
 - lib/eac_ruby_utils.rb
+- lib/eac_ruby_utils/abstract_methods.rb
 - lib/eac_ruby_utils/arguments_consumer.rb
 - lib/eac_ruby_utils/blank_not_blank.rb
 - lib/eac_ruby_utils/boolean.rb
@@ -119,7 +120,10 @@ files:
 - 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
@@ -183,10 +187,14 @@ files:
 - lib/eac_ruby_utils/patches/class/common_constructor.rb
 - lib/eac_ruby_utils/patches/enumerable.rb
 - lib/eac_ruby_utils/patches/enumerable/boolean_combinations.rb
+- lib/eac_ruby_utils/patches/enumerator.rb
+- lib/eac_ruby_utils/patches/enumerator/current.rb
+- lib/eac_ruby_utils/patches/enumerator/stopped.rb
 - lib/eac_ruby_utils/patches/hash.rb
 - lib/eac_ruby_utils/patches/hash/options_consumer.rb
 - lib/eac_ruby_utils/patches/hash/sym_keys_hash.rb
 - 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
@@ -196,6 +204,7 @@ files:
 - lib/eac_ruby_utils/patches/module/simple_cache.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_present.rb
 - lib/eac_ruby_utils/patches/object/if_respond.rb
 - lib/eac_ruby_utils/patches/object/template.rb