eitil 1.0.1.e.2 → 1.0.1.e.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 161ea1fef5a7b13407bb26a3d99a8904c703892c1694810736c0730f641e979e
-  data.tar.gz: 4c41d1d6fdd1b3b801159bc636f4c21671f70c4abae545c36ce51c84c830bc14
+  metadata.gz: 838e2414fac15c66b76d95da3fecd112e366bf9b860b6c2b4647efd7907fc92b
+  data.tar.gz: b4d80aab7d63d69522749d958673acee64764bb986421e0165a7804ef1eb0cfd
 SHA512:
-  metadata.gz: 94ac07f583fab8447efcb1db503d64aa568ce5afd93c33bd41463b41b2e1bc9ce6ed8ce91fb7991e785626f2d2ec92ec168dc7622906bc6d41836a5fd9a5211e
-  data.tar.gz: 8cdca2036c3c4da7bb3a733143faa3e319f1f05aea30bd049413ab7e913929f1dd277575b02e1274dc77dc8318286c98d305873733f714286b2f04aebe0908e4
+  metadata.gz: 454ba3ec3f1dc1538651ac29b6ca4423614e8d923c4111aadaa0e3f646e3d539cb78326989f699f9d4eaafeb0cd2357b04e92eaa0840b5680f4c2650bed46e84
+  data.tar.gz: 7531ed1078d5416180aa02fd9f1eeaf366787e4fbe7d05d4580d0e23308b8a9caadc5e4f7fd25c0fa1e3dbae2dfae6ff20b9b8e86d39c6be87cb14b19ca051f9

data/eitil_core/README.md

@@ -0,0 +1,288 @@
+
+
+
+# EitilCore
+
+EitilCore extends the core classes of Ruby and Rails.
+
+
+## ApplicationController
+
+```ruby
+
+require "eitil_core/application_controller"
+
+```
+
+```ruby
+# require "eitil_core/application_controller/slice_params"
+
+slice_params(*args)
+# slices request params, converts them to JSON and symbolizes the keys
+# call as: slice_params :id, :user
+# => { id: 1, user: 69 }
+```
+
+
+## ApplicationRecord
+
+```ruby
+
+require "eitil_core/application_controller"
+
+```
+
+```ruby
+# require "eitil_core/application_record/find_by_like"
+
+self.find_by_like(_hash)
+# runs .find_by with your string field made into a wildcard and case insensitive
+# call as: User.find_by_like(name: 'jurriaan')
+```
+
+```ruby
+# require "eitil_core/application_record/where_like"
+
+self.where_like(_hash)
+# runs .where with your string field made into a wildcard and case insensitive
+# call as: User.where_like(name: 'jurriaan')
+```
+
+```ruby
+# require "eitil_core/application_record/all_associations"
+
+self.all_associations
+# returns all associations for a given model
+# call as: Environment.all_associations
+```
+
+
+## ArgumentHelpers
+
+```ruby
+
+require "eitil_core/arugment_helpers"
+
+```
+
+
+```ruby
+# require "eitil_core/argument_helpers/all_args_to_ivars"
+
+all_args_to_ivars(binding)
+# sets all keywords arguments of the method's local binding to instance variables
+# call as: all_args_to_ivars binding
+```
+
+
+```ruby
+# require "eitil_core/argument_helpers/args_to_ivars"
+
+args_to_ivars(binding, *local_vars)
+# sets specified keywords arguments of the method's local binding to instance variables
+# call as: all_args_to_ivars binding :user_id, :user_name
+```
+
+
+```ruby
+# require "eitil_core/argument_helpers/all_kwargs_to_ivars"
+
+all_kwargs_to_ivars(local_binding, namespace= :kwargs)
+# sets the method's **kwargs argument to instance variables, with each key as the ivar's "@#{name}" and the value as its value
+# call as: kwargs_to_ivars binding
+# the keywords container name can be overwritten, e.g. the common :attributes
+```
+
+
+## Concerns
+
+```ruby
+
+require "eitil_core/concerns"
+
+```
+
+```ruby
+# require "eitil_core/concerns/include_concerns_of"
+
+include_concerns_of(*directories, namespace: nil)
+# includes models/concerns/{directories}/* if no namespace if given, or all concerns within the given namespace
+# call as: include_concerns_of :user, :mail 
+# => includes all modules of models/concerns/user/* and models/oncerns/mail/*
+# or call as: include_concerns_of :request_service, namespace: Eivid::Concerns
+# tip: call Class.included_modules to view all included modules 
+```
+
+
+## DateTime
+
+```ruby
+
+require "eitil_core/datetime"
+
+```
+
+```ruby
+# require "eitil_core/datetime/prettify"
+
+prettify
+# formats DateTime instances into a pretty, simple and filename friendly format
+# call as: DateTime.now.prettify 
+# => "2021-04-21.17:51:42"
+```
+
+
+## Errors
+
+```ruby
+
+require "eitil_core/errors"
+
+```
+
+```ruby
+# require "eitil_core/errors/raise_error"
+
+raise_error(_class_name, message = nil)
+# creates an error class if currently undefined, inheriting from StandardError, and raises the error with the given message
+# call as: raise_error "SomethingWentWrongError", "check your code, bro!"
+# => SomethingWentWrongError (check your code, bro!)
+```
+
+
+## Float
+
+```ruby
+
+require "eitil_core/float"
+
+```
+
+```ruby
+# require "eitil_core/float/safe_to_i"
+
+safe_to_i
+# converts a float to an integer, only when no decimal values are lost.
+# 8.00.safe_to_i returns 8    (Integer)
+# 8.88.safe_to_i returns 8.88 (Float)
+```
+
+
+## Hash
+
+```ruby
+
+require "eitil_core/hash"
+
+```
+
+```ruby
+# require "eitil_core/hash/auto_dig"
+
+auto_dig(_hash = self, _key)
+# finds the value for the given hash key, irregardless of the amount of nested layers 
+# call as: {a: 1, b: {c: 2, d: {e: 3}}}.auto_dig :e
+# => 3
+```
+
+
+## Lookups
+
+```ruby
+
+require "eitil_core/lookups"
+
+```
+
+```ruby
+# require "eitil_core/lookups/all_methods"
+
+all_methods(include_ancestors = true, grep: nil)
+# pretty prints all methods for any object, grouped per type (e.g. private_methods, public_instance_methods)
+# call as: Class.all_methods false, grep: /json/
+```
+
+
+## SafeExecutions
+
+```ruby
+
+require "eitil_core/safe_executions"
+
+```
+
+```ruby
+# require "eitil_core/safe_executions/safe_send"
+
+safe_send(method, *args, return_value: nil)
+# a safe version of .send, which in case of an error rescues and returns return_value (default: nil) instead
+```
+
+```ruby
+# require "eitil_core/safe_executions/safe_call"
+
+safe_call(*args, return_value: nil, &block)
+# a safe version of .call, which in case of an error rescues and returns return_value (default: nil) instead
+# accepts either a proc argument or a block
+```
+
+
+## Setters
+
+```ruby
+
+require "eitil_core/setters"
+
+```
+
+```ruby
+# require "eitil_core/setters/set_ivars"
+
+set_ivars(*ivars)
+# sets instance variables named @"#{ivar}" for each symbol passed, by invoking send("set_#{ivar}")
+# e.g. set_ivars(:user) sets @user with the value returned by your local method .set_user
+# call as: set_ivars :user, :authentication, :connection
+```
+
+
+## TypeCheckers
+
+```ruby
+
+require "eitil_core/type_checkers"
+
+```
+
+```ruby
+# require "eitil_core/type_checkers/is_num_or_nan"
+
+is_num?
+# returns true if a string matches the Rubinius source code regex for strings and integers, false otherwise
+# comes in handy since ruby plays it safe on string to number conversion ('aaa'.to_f returns 0.0, thus is valid)
+# this method is also implemented for all other classes, such as Integer, Float, NilClass, TrueClass, Hash and so on...
+
+is_nan?
+# returns true if a string does NOT match the Rubinius source code regex for strings and integers, false otherwise
+# comes in handy since ruby plays it safe on string to number conversion ('aaa'.to_f returns 0.0, thus is valid)
+# this method is also implemented for all other classes, such as Integer, Float, NilClass, TrueClass, Hash and so on...
+```
+
+
+## Validations
+
+```ruby
+
+require "eitil_core/validations"
+
+```
+
+```ruby
+# require "eitil_core/validations/run_validations"
+
+run_validations(*validations)
+# calls a method for each argument, namespaced as "validate_#{argument}"
+# call as: run_validations(:single_receipt, :single_order)
+# => calls #validate_single_receipt and #validate_single_order
+```
+
+

data/eitil_core/lib/eitil_core/application_controller/slice_params.rb

@@ -0,0 +1,14 @@
+
+# require "eitil_core/application_controller/slice_params"
+
+module EitilCore
+  module ApplicationController
+    module SliceParams
+
+      def slice_params(*args)
+        params.slice(*args).as_json.symbolize_keys
+      end
+
+    end
+  end
+end

data/eitil_core/lib/eitil_core/application_controller.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/application_controller/slice_params"

data/eitil_core/lib/eitil_core/application_record/all_associations.rb

@@ -0,0 +1,16 @@
+
+# require "eitil_core/application_record/all_associations"
+
+module EitilCore
+  module ApplicationRecord
+    module AllAssociations
+
+      def all_associations
+        reflect_on_all_associations.map do |assoc|
+          { assoc.name => assoc.association_class.to_s.demodulize }
+        end.inject &:merge
+      end
+
+    end
+  end
+end

data/eitil_core/lib/eitil_core/application_record/find_by_like.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/application_record/find_by_like"
+
+module EitilCore
+  module ApplicationRecord
+    module FindByLike
+
+      def find_by_like(_hash)
+        column, like = _hash.first
+        find_by("LOWER(#{column}) LIKE ?", "%#{like.downcase}%")
+      end
+
+    end
+  end
+end

data/eitil_core/lib/eitil_core/application_record/where_like.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/application_record/where_like"
+
+module EitilCore
+  module ApplicationRecord
+    module WhereLike
+
+      def where_like(_hash)
+        column, like = _hash.first
+        where("LOWER(#{column}) LIKE ?", "%#{like.downcase}%")
+      end
+
+    end
+  end
+end

data/eitil_core/lib/eitil_core/application_record.rb

@@ -0,0 +1,4 @@
+
+require "eitil_core/application_record/where_like"
+require "eitil_core/application_record/find_by_like"
+require "eitil_core/application_record/all_associations"

data/eitil_core/lib/eitil_core/argument_helpers/all_args_to_ivars.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/argument_helpers/all_args_to_ivars"
+
+Kernel.module_eval do
+
+  def all_args_to_ivars(local_binding)
+    local_binding.local_variables.each do |lvar|
+      instance_variable_set("@#{lvar}", local_binding.local_variable_get(lvar))
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers/all_kwargs_to_ivars.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/argument_helpers/all_kwargs_to_ivars"
+
+Kernel.module_eval do
+
+  def all_kwargs_to_ivars(local_binding, namespace=:kwargs)
+    local_binding.local_variable_get(namespace).each do |name, value|
+      instance_variable_set "@#{name}", value
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers/args_to_ivars.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/argument_helpers/args_to_ivars"
+
+Kernel.module_eval do
+
+  def args_to_ivars(local_binding, *local_vars)
+    local_vars.each do |lvar|
+      instance_variable_set("@#{lvar}", local_binding.local_variable_get(lvar))
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers.rb

@@ -0,0 +1,5 @@
+# require "eitil_core/arugment_helpers"
+
+require "eitil_core/argument_helpers/all_args_to_ivars"
+require "eitil_core/argument_helpers/args_to_ivars"
+require "eitil_core/argument_helpers/all_kwargs_to_ivars"

data/eitil_core/lib/eitil_core/concerns/include_concerns_of.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/concerns/include_concerns_of"
+
+class Module
+
+  def include_concerns_of(*directories, namespace: nil)
+    directories.map! { |dir| "#{namespace}::#{dir.to_s.camelcase}" }
+
+    directories.each do |dir|
+      konstants = dir.constantize.constants(false)
+      konstants.each { |kon| include(const_get "#{dir}::#{kon}") }
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/concerns.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/concerns/include_concerns_of"

data/eitil_core/lib/eitil_core/datetime/prettify.rb

@@ -0,0 +1,10 @@
+
+# require "eitil_core/datetime/prettify"
+
+class DateTime
+
+  def prettify
+    strftime "%Y-%m-%d.%H:%M:%S"
+  end
+
+end

data/eitil_core/lib/eitil_core/datetime.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/datetime/prettify"

data/eitil_core/lib/eitil_core/errors/raise_error.rb

@@ -0,0 +1,11 @@
+
+# require "eitil_core/errors/raise_error"
+
+Kernel.module_eval do
+
+  def raise_error(_class_name, message = nil)   
+    Object.const_set(_class_name, Class.new(StandardError)) unless Object.const_defined?(_class_name)
+    raise _class_name.constantize.new message
+  end
+
+end

data/eitil_core/lib/eitil_core/errors.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/errors/raise_error"

data/eitil_core/lib/eitil_core/float/safe_to_i.rb

@@ -0,0 +1,9 @@
+class Float
+
+  # converts a float to an integer, only when no decimal values are lost.
+
+  def safe_to_i
+    self == self.to_i ? self.to_i : self
+  end
+
+end

data/eitil_core/lib/eitil_core/float.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/float/safe_to_i"

data/eitil_core/lib/eitil_core/hash/auto_dig.rb

@@ -0,0 +1,17 @@
+
+# require "eitil_core/hash/auto_dig"
+
+class Hash
+
+    def auto_dig(_hash = self, _key)
+    return _hash[_key] if _hash.fetch(_key, false)
+
+    _hash.keys.each do |k|
+      answer = auto_dig(_hash[k], _key) if _hash[k].is_a? Hash
+      return answer if answer
+    end
+
+    nil
+  end
+
+end

data/eitil_core/lib/eitil_core/hash.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/hash/auto_dig"

data/eitil_core/lib/eitil_core/lookups/all_methods.rb

@@ -0,0 +1,32 @@
+
+# require "eitil_core/lookups/all_methods"
+
+require "awesome_print"
+
+class Object
+
+  def all_methods(include_ancestors = true, grep: nil)
+
+    _introspection_methods = %i$
+      methods
+      singleton_methods
+      instance_methods
+      private_methods
+      public_methods
+      protected_methods
+      private_instance_methods
+      public_instance_methods
+      protected_instance_methods
+    $
+
+    _introspection_methods.map! do |_m|
+      _methods = safe_send _m, include_ancestors
+      _methods = grep ? _methods&.grep(grep) : _methods
+      { _m => _methods }
+    end
+
+    ap _introspection_methods.inject &:merge
+    
+  end
+
+end

data/eitil_core/lib/eitil_core/lookups.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/lookups/all_methods"

data/eitil_core/lib/eitil_core/railtie.rb

@@ -0,0 +1,37 @@
+
+require "rails"
+require "eitil_core"
+
+module EitilCore
+
+  class Railtie < Rails::Railtie
+
+      initializer "my_railtie.configure_rails_initialization", options: :after do |app|
+
+        # Dynamic dispatching after initialization of Rails classes.
+
+        # ApplicationRecord
+        
+        if Object.const_defined?('EitilCore::ApplicationRecord::WhereLike')
+          ::ApplicationRecord.send(:extend, EitilCore::ApplicationRecord::WhereLike)
+        end
+
+        if Object.const_defined?('EitilCore::ApplicationRecord::FindByLike')
+          ::ApplicationRecord.send(:extend, EitilCore::ApplicationRecord::FindByLike)
+        end
+
+        if Object.const_defined?('EitilCore::ApplicationRecord::AllAssociations')
+          ::ApplicationRecord.send(:extend, EitilCore::ApplicationRecord::AllAssociations)
+        end
+
+        # ApplicationController
+
+        if Object.const_defined?('EitilCore::ApplicationController::SliceParams')
+          ::ActionController::API.send(:include, EitilCore::ApplicationController::SliceParams)
+        end        
+
+      end
+
+  end
+
+end

data/eitil_core/lib/eitil_core/safe_executions/safe_call.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/safe_executions/safe_call"
+
+Kernel.module_eval do
+
+  def safe_call(*args, return_value: nil, &block)
+    block.call self, *args
+    rescue
+      return_value
+  end
+
+end

data/eitil_core/lib/eitil_core/safe_executions/safe_send.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/safe_executions/safe_send"
+
+Kernel.module_eval do
+
+  def safe_send(method, *args, return_value: nil)
+    self.send method, *args
+    rescue
+      return_value
+  end
+
+end

data/eitil_core/lib/eitil_core/safe_executions.rb

@@ -0,0 +1,3 @@
+
+require "eitil_core/safe_executions/safe_send"
+require "eitil_core/safe_executions/safe_call"

data/eitil_core/lib/eitil_core/setters/set_ivars.rb

@@ -0,0 +1,12 @@
+
+# require "eitil_core/setters/set_ivars"
+
+Kernel.module_eval do
+
+  def set_ivars(*ivars)
+    ivars.each do |ivar|
+      instance_variable_set("@#{ivar}", send("set_#{ivar}"))
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/setters.rb

@@ -0,0 +1,2 @@
+
+require "eitil_core/setters/set_ivars"