eitil 1.0.1.e.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e69ced77b66d59f27e9099a7797a456cde74b16c6335ef8b5a2ac97c66b5682
-  data.tar.gz: 46b8fe67b5ff1565a08c0e9305890f60af39706da8f7c32a63641ebef6273666
+  metadata.gz: 2f00d6cb9618a2ac3b44228369fbf6c0dc1a7c4e4f7b8f458fb74ab49d842d93
+  data.tar.gz: c9b52d358edd18661a02c7961d30706b123f24708b48f864c842c8d6d5554d51
 SHA512:
-  metadata.gz: 24a0162b9243e07c02fe243a69f13ade1b2e94ecf27b6f23178439ade082078ca7c4fa6e2c651a5452fa56496b25eeed820b689e34cd244c29e78f6d95a1654a
-  data.tar.gz: f5ddd6a9820025ac558361761132d0da305f511d0b8f9edca3c2469aa49a1a98e09f63382a8463f293756556ac6a5fc9084ad6f155712211f348c2d52b0d60ae
+  metadata.gz: 013e9004bbc5bb836c43c008ad749d55c05f9088268247d8519be72e28636735604cc8af8a3405848f88bc92cb902cad3bdd3af72d4907cb33fc2a9ec87dcde1
+  data.tar.gz: af236edfe30a37449bbe255d18deffa75e196a7825eed2da9fc81d542f4e694c05931e139a4f40999ba63df1f25574a142d553669d7c2bde6c2b50d5ac8574f6

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.rb

@@ -0,0 +1,24 @@
+
+# require "eitil_core"
+
+# core class patches
+require "eitil_core/hash"
+require "eitil_core/float"
+require "eitil_core/datetime"
+
+# multi class patches
+require "eitil_core/type_checkers"
+
+# rails class patches
+require "eitil_core/application_record"
+require "eitil_core/application_controller"
+
+# helper patches
+require "eitil_core/errors"
+require "eitil_core/argument_helpers"
+require "eitil_core/safe_executions"
+require "eitil_core/setters"
+require "eitil_core/validations"
+require "eitil_core/lookups"
+require "eitil_core/concerns"
+

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_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_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/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/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/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