eitil 0.3.3 → 0.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7472becb49f3ad8ed37b1af23436257255cd050fd6d101a552fad3b35d020e38
-  data.tar.gz: 3508a76cd84733740cc9b8e9be223406ec4f620f38d9ba86048118743c058dd5
+  metadata.gz: f742ee647b11b18765c5022fe55301317822282c3443cd161e0d49ded69678cf
+  data.tar.gz: 10aa2196982292c2cab87a25906b59eba9147294dfdddaafce8a53eb8521c7b7
 SHA512:
-  metadata.gz: 52c7c51884686864b8b1aede6fc70a03028636614ef309ef59f9a70336091bd1e122ca2e7ccd99dcd824e371c60a83db73924cda249c373fda62b6f548af32fd
-  data.tar.gz: 47071fee4cd78efdda04753406985bb093150b70e4d1bcfd355091f3c402cd08603a508c234e3dec2d9d324c1e2a23f0f86c2ae33d1bd914b0c5f1d3631d0de6
+  metadata.gz: 13b655a01ff36fd371f50cc9868409a0a0d51520afffaf3d8871bd9955a502bf342945f51d0f551cbd9c58b97bdcc6fa7d28f9a09ee06b9c1e127764abbc3854
+  data.tar.gz: c7a02991659f2c23d9c4846d2377e6160a3f15fdd0119f231ad1e78fef0686ba651c35c25b283f49405cd5f1fc545d40d082c7ff7639ee080cef76d8b25ff7b6

data/README.md

@@ -103,6 +103,20 @@ include_concerns_of(*directories, namespace: nil)
 
 
 
+## String
+
+```ruby
+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)
+
+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)
+```
+
+
+
 ## Hash
 
 ```ruby
@@ -131,6 +145,14 @@ slice_params(*args)
 self.all_associations
 # returns all associations for a given model
 # call as: Environment.all_associations
+
+self.where_like(_hash)
+# runs .where with your string field made into a wildcard and case insensitive
+# call as: User.where_like(name: 'jurriaan')
+
+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')
 ```
 
 
@@ -177,7 +199,7 @@ decorate(dec_item, dec_method: nil, dec_class: nil, **dec_kwargs)
 # initializers/eitil.rb
 
 Eitil.set_config do |config|
-  config.get_controller_ivars_method = 'API::VerlofVerzoekenController.controller_ivars' # => [:user, :env]
+  config.get_controller_ivars_method = 'API::BaseController.controller_ivars' # => [:user, :env]
 end
 ```
 
@@ -227,14 +249,18 @@ The router wrapper is a single module which is automatically included into your
 
 ### Info
 
-The Eitil jobs wrapper enables you to create perform_later jobs on the fly, without the need to create a new class and file. The macro new_job accepts a :method as argument and defines a new method :method_job. The newly defined :method_job, when called, performs the orginal :method in the background. The new_job macro accepts both instance methods and singleton methods, which are defined within there own method scope.
+The Eitil jobs wrapper enables you to create perform_now and perform_later jobs on the fly, without the need to create a new class and file. The macro new_job accepts a :method as argument and defines a new method :method_job. The newly defined :method_job, when called, performs the orginal :method in the background. The new_job macro accepts both instance methods and singleton methods, which are defined within there own method scope. In contrast, the new_job_debugger macro defines a new :method_job_debugger method, which performs in the foreground.
 
 ### Job Macro
 
 ```ruby
-new_job(_method)
-# assuming a method :print_hello_world, call as: new_job :hello_world
-# => method :hello_world_job
+new_job(_method, *args, **kwargs)
+# assuming a method :hello_world, call as: new_job :hello_world
+# => defines :hello_world_job
+
+new_job_debugger(_method, *args, **kwargs)
+# assuming a method :hello_world, call as: new_job_debugger :hello_world
+# => defines :hello_world_job_debugger
 ```
 
 - method is 
@@ -304,3 +330,50 @@ Scopes are generated through the columns of your model's database table. Which s
 Your models should inherit the module Eitil::DefaultScopes through inclusion in a superclass, such as ApplicationRecord.
 
 
+
+# Modules & Classes
+
+
+
+## Eitil::Dir
+
+### Info
+
+The Eitil::Dir module provides methods which help you introspect your Rails project.
+
+### Methods
+
+```ruby
+Eitil::Dir.contents(directory='app')
+# returns all files and subdirectories of a given directory
+
+Eitil::Dir.files(directory='app')
+# returns all files of a given directory
+
+Eitil::Dir.subdirs(directory='app')
+# returns all subdirectories of a given directory
+
+Eitil::Dir.lines(directory='app')
+# returns the total amount of lines of all files of a given directory
+```
+
+
+
+## Eitil::StackTrace
+
+### Info
+
+The two classes Eitil::StackTrace::Stack and Eitil::StackTrace::Call, and the single module Eitil::StackTrace::Audit, provide the utility of easily viewing and storing the current stacktrace anywhere in your code. By initializing stack = Eitil::StackTrace::Stack.new, you can call methods as stack.report (returns the stacktrace as array), stack.show (pretty prints the stacktrace) and stack.find (accepts a block to find a call).
+
+You can also store the stacktrace of a record's update action into its audit. In order to do so, you need 1) to include Eitil::StackTrace::Audit into your model, and 2) add a :stacktrace column to your audits through the following migration.
+
+### Migration
+
+```ruby
+def change
+	add_column :audits, :stacktrace, :text, array: true, default: [] 
+end
+```
+
+
+

data/app/models/eitil/stack_trace/audit.rb

@@ -0,0 +1,15 @@
+module Eitil::StackTrace::Audit
+  extend ActiveSupport::Concern
+  included do
+
+    private
+    
+    after_update :add_stacktrace_to_audit
+
+    def add_stacktrace_to_audit
+      stacktrace = Eitil::StackTrace::Stack.new.report
+      self.audits.last.update(stacktrace: stacktrace)
+    end
+
+  end
+end

data/app/models/eitil/stack_trace/call.rb

@@ -0,0 +1,17 @@
+module Eitil::StackTrace
+  class Call
+
+    attr_reader :program, :line, :meth
+
+    CALL_RE = /(.*):(\d+):in `(.*)'/
+
+    def initialize(string)
+      @program, @line, @meth = CALL_RE.match(string).captures
+    end
+
+    def to_s
+      "#{"#{meth}".ljust(50)} #{"(#{line})".ljust(6)} #{program}"
+    end
+
+  end
+end

data/app/models/eitil/stack_trace/stack.rb

@@ -0,0 +1,28 @@
+module Eitil::StackTrace
+  class Stack
+
+  attr_reader :stack, :backtrace
+
+  def initialize
+    @stack     = caller[1..]
+    @backtrace = stack.map { |call| Eitil::StackTrace::Call.new(call) }
+  end
+
+  def report
+    backtrace.map(&:to_s)
+  end
+
+  def show
+    ap report
+  end
+
+  def find(&block)
+    backtrace.find(&block)
+  end
+
+  def self.parse(array_as_string)
+    array_as_string.sub('[', ' ').reverse.sub(']','').reverse.split(',').flatten
+  end
+
+  end
+end

data/config/initializers/modules/dir.rb

@@ -0,0 +1,21 @@
+module Eitil::Dir
+  class << self
+
+    def contents(directory='app')
+      Dir[File.join(directory, '**', '*')]
+    end
+
+    def files(directory='app')
+      contents(directory).select { |file| File.file?(file) }
+    end
+
+    def subdirs(directory='app')
+      contents(directory).select { |file| File.directory?(file) }
+    end
+
+    def lines(directory='app')
+      files(directory).map { |file| File.open(file).count }.sum
+    end
+
+  end
+end

data/config/initializers/monkeys/application_record.rb

@@ -4,10 +4,24 @@ module ApplicationRecordMonkey
   extend ActiveSupport::Concern 
   included do
 
-    def self.all_associations
-      reflect_on_all_associations.map do |assoc|
-        { assoc.name => assoc.association_class.to_s.demodulize }
-      end.inject &:merge
+    class << self
+
+      def all_associations
+        reflect_on_all_associations.map do |assoc|
+          { assoc.name => assoc.association_class.to_s.demodulize }
+        end.inject &:merge
+      end
+
+      def where_like(_hash)
+        column, like = _hash.first
+        where("LOWER(#{column}) LIKE ?", "%#{like.downcase}%")
+      end
+
+      def find_by_like(_hash)
+        column, like = _hash.first
+        find_by("LOWER(#{column}) LIKE ?", "%#{like.downcase}%")
+      end
+
     end
 
   end

data/config/initializers/monkeys/hash.rb

@@ -8,7 +8,7 @@ class Hash
       return answer if answer
     end
 
-    false
+    nil
   end
 
 end

data/config/initializers/monkeys/string.rb

@@ -0,0 +1,16 @@
+class String
+
+  # The NumberRegex belows comes from the Rubinius source code and 
+  # identifies both integers and floats correctly.
+
+  NumberRegex = /^\s*[+-]?((\d+_?)*\d+(\.(\d+_?)*\d+)?|\.(\d+_?)*\d+)(\s*|([eE][+-]?(\d+_?)*\d+)\s*)$/
+
+  def is_nan?
+    self !~ NumberRegex
+  end
+
+  def is_num?
+    !is_nan?
+  end
+
+end

data/config/initializers/wrappers/jobs/active_job_macros.rb

@@ -1,18 +1,52 @@
 Kernel.module_eval do
 
-  def new_job(_method)
+  # BEWARE: _self is currently not accepted in perform_later jobs due to serialization errors
+
+  # The cases of 'id' and '_self' both handle instances, with the difference 
+  # being that 'id' works for objects that have a database record, while '_self'
+  # works for non database supported instanes, such as an Exporter instance.
+
+  def new_job(_method, *args, **kwargs)
 
     if instance_methods(false).include? _method
-      define_method "#{_method}_job" do
-        Eitil::SingleMethodJob.perform_later(_class: self.class.to_s, _method: _method.to_s, id: id)
+      define_method "#{_method}_job" do |_self = nil, *args, **kwargs|
+        
+        Eitil::SingleMethodJob.perform_later(
+          *args, _class: self.class.to_s, _method: _method.to_s, id: safe_send(:id), _self: self.to_json, **kwargs
+        )
       end
 
-    elsif singleton_methods(false).include? _method
-      define_singleton_method "#{_method}_job" do
-        Eitil::SingleMethodJob.perform_later(_class: to_s, _method: _method.to_s)
+    elsif singleton_methods(false).include? _method      
+      define_singleton_method "#{_method}_job" do |*args, **kwargs|
+       
+        Eitil::SingleMethodJob.perform_later(
+          *args, _class: to_s, _method: _method.to_s, **kwargs
+        )
       end
-    end  
+    end 
+  end
+
+  # BEWARE: This is an exact copy of the above method, except for .perform_now instead of .perform_later and the method's name.
+  # The reason for not using helper methods is to not unnecessarily fill and potentially fuck up the Kernel environment.
+
+  def new_job_debugger(_method, *args, **kwargs)
 
+    if instance_methods(false).include? _method
+      define_method "#{_method}_job_debugger" do |_self = nil, *args, **kwargs|
+        
+        Eitil::SingleMethodJob.perform_now(
+          *args, _class: self.class.to_s, _method: _method.to_s, id: safe_send(:id), _self: self.to_json, **kwargs
+        )
+      end
+
+    elsif singleton_methods(false).include? _method      
+      define_singleton_method "#{_method}_job_debugger" do |*args, **kwargs|
+       
+        Eitil::SingleMethodJob.perform_now(
+          *args, _class: to_s, _method: _method.to_s, **kwargs
+        )
+      end
+    end 
   end
 
 end

data/config/initializers/wrappers/jobs/single_method_job.rb

@@ -2,9 +2,23 @@ module Eitil
   class SingleMethodJob < ApplicationJob
     queue_as :default
 
-    def perform(_class:, _method:, id: nil)
-      object = id ? _class.constantize.find(id) : _class.constantize
-      object.send _method
+    # BEWARE: _self is currently not accepted in perform_later jobs due to serialization errors
+
+    # The cases of 'id' and '_self' both handle instances, with the difference 
+    # being that 'id' works for objects that have a database record, while '_self'
+    # works for non database supported instanes, such as an Exporter instance.
+
+    def perform(*args, _class:, _method:, id: nil, _self: nil, **kwargs)      
+      object = 
+        if id
+          _class.constantize.find(id)
+        elsif _self
+          _self
+        else
+          _class.constantize
+        end
+
+      object.send _method, *args, **kwargs
     end
   end
 end

data/config/initializers/wrappers/scopes/default_scopes.rb

@@ -2,86 +2,82 @@ module Eitil
   module DefaultScopes
     extend ActiveSupport::Concern
     included do
-      
-      SharableDateScopes = -> (column) {
-        eitil_scope :"#{column}_today",         -> { where("#{column} = ?", Date.today) }
-        eitil_scope :"#{column}_past",          -> { where("#{column} < ?", Date.today) }
-        eitil_scope :"#{column}_future",        -> { where("#{column} > ?", Date.today) }
-        
-        eitil_scope :"#{column}_on_date",       -> (date) { where("#{column} = ?", date) }
-        eitil_scope :"#{column}_before_date",   -> (date) { where("#{column} = ?", date) }
-        eitil_scope :"#{column}_after_date",    -> (date) { where("#{column} = ?", date) }
-        eitil_scope :"#{column}_between_dates", -> (from, till) { where("#{column} >= ? and #{column} <= ?", from, till) }
+      class << self
 
-        eitil_scope :"#{column}_oldest_first",  -> { order("#{column} ASC") }
-        eitil_scope :"#{column}_newest_first",  -> { order("#{column} DESC") }
-      }
+          SharableDateScopes = -> (_class, column) {
+            _class.eitil_scope :"#{column}_today",          -> { where("#{column} = ?", Date.today) }
+            _class.eitil_scope :"#{column}_past",           -> { where("#{column} < ?", Date.today) }
+            _class.eitil_scope :"#{column}_future",         -> { where("#{column} > ?", Date.today) }
+            
+            _class.eitil_scope :"#{column}_on_date",        -> (date) { where("#{column} = ?", date) }
+            _class.eitil_scope :"#{column}_before_date",    -> (date) { where("#{column} = ?", date) }
+            _class.eitil_scope :"#{column}_after_date",     -> (date) { where("#{column} = ?", date) }
+            _class.eitil_scope :"#{column}_between_dates",  -> (from, till) { where("#{column} >= ? and #{column} <= ?", from, till) }
 
-      SharableNumScopes = -> (column) {
-       eitil_scope :"#{column}_equal_to",       -> (number) { where("#{column} = ?", number) }
-       eitil_scope :"#{column}_lower_than",     -> (number) { where("#{column} = <", number) }
-       eitil_scope :"#{column}_higher_than",    -> (number) { where("#{column} = >", number) }
-       eitil_scope :"#{column}_between",        -> (min, max) { where("#{column} >= ? and #{column} <= ?", min, max) }
+            _class.eitil_scope :"#{column}_oldest_first",   -> { order("#{column} ASC") }
+            _class.eitil_scope :"#{column}_newest_first",   -> { order("#{column} DESC") }
+          }
 
-       eitil_scope :"#{column}_ascending",      -> { order("#{column} ASC") }
-       eitil_scope :"#{column}_descending",     -> { order("#{column} DESC") }
-      }
+          SharableNumScopes = -> (_class, column) {
+            _class.eitil_scope :"#{column}_equal_to",       -> (number) { where("#{column} = ?", number) }
+            _class.eitil_scope :"#{column}_lower_than",     -> (number) { where("#{column} = <", number) }
+            _class.eitil_scope :"#{column}_higher_than",    -> (number) { where("#{column} = >", number) }
+            _class.eitil_scope :"#{column}_between",        -> (min, max) { where("#{column} >= ? and #{column} <= ?", min, max) }
 
-      class << self
+            _class.eitil_scope :"#{column}_ascending",      -> { order("#{column} ASC") }
+            _class.eitil_scope :"#{column}_descending",     -> { order("#{column} DESC") }
+          }
 
-        private
-
-        def self.inherited(subclass)
-          use_eitil_scopes
-          super
-        end
+          def inherited(subclass)
+            super
+            subclass.use_eitil_scopes
+          end
 
-        def use_eitil_scopes  
-          return if abstract_class?
-          %i[boolean datetime date integer float].each { |_type| send :"create_eitil_#{_type}_scopes" }
-        end
+          def use_eitil_scopes  
+            return if abstract_class?
+            %i[boolean datetime date integer float].each { |_type| send :"create_eitil_#{_type}_scopes" }
+          end
 
-        def eitil_scope(_name, _proc)
-          scope _name, _proc unless respond_to? _name
-        end
-      
-        def columns_of_type(data_type)
-          columns_hash.select { |column,v| v.sql_type_metadata.type == data_type }
-        end
+          def eitil_scope(_name, _proc)
+            scope _name, _proc unless respond_to? _name
+          end
+        
+          def columns_of_type(data_type)
+            columns_hash.select { |column,v| v.sql_type_metadata.type == data_type }
+          end
 
-        def create_eitil_boolean_scopes
-          columns_of_type(:boolean)&.map do |column, object|      
-            eitil_scope :"#{column}_true",  -> { where(column => true) }
-            eitil_scope :"#{column}_false", -> { where(column => [false, nil]) }
+          def create_eitil_boolean_scopes
+            columns_of_type(:boolean)&.map do |column, object|      
+              eitil_scope :"#{column}_true",     -> { where(column => true) }
+              eitil_scope :"#{column}_false", -> { where(column => [false, nil]) }
+            end
           end
-        end
 
-        def create_eitil_datetime_scopes
-          columns_of_type(:datetime)&.map do |column, object|
-            SharableDateScopes.call column
+          def create_eitil_datetime_scopes
+            columns_of_type(:datetime)&.map do |column, object|
+              SharableDateScopes.call self, column
+            end
           end
-        end
 
-        def create_eitil_date_scopes
-          columns_of_type(:date)&.map do |column, object|
-            SharableDateScopes.call column
+          def create_eitil_date_scopes
+            columns_of_type(:date)&.map do |column, object|
+              SharableDateScopes.call self, column
+            end
           end
-        end
 
-        def create_eitil_integer_scopes
-          columns_of_type(:integer)&.map do |column, object|
-            SharableNumScopes.call column
+          def create_eitil_integer_scopes
+            columns_of_type(:integer)&.map do |column, object|
+              SharableNumScopes.call self, column
+            end
           end
-        end
 
-        def create_eitil_float_scopes
-          columns_of_type(:float)&.map do |column, object|
-            SharableNumScopes.call column
+          def create_eitil_float_scopes
+            columns_of_type(:float)&.map do |column, object|
+              SharableNumScopes.call self, column
+            end
           end
-        end
 
       end
-
     end
   end
 end

data/lib/eitil/version.rb

@@ -1,3 +1,3 @@
 module Eitil
-  VERSION = '0.3.3'
+  VERSION = '0.3.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eitil
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.8
 platform: ruby
 authors:
 - Jurriaan Schrofer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-18 00:00:00.000000000 Z
+date: 2021-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -52,6 +52,10 @@ files:
 - app/jobs/eitil/application_job.rb
 - app/mailers/eitil/application_mailer.rb
 - app/models/eitil/application_record.rb
+- app/models/eitil/stack_trace/audit.rb
+- app/models/eitil/stack_trace/call.rb
+- app/models/eitil/stack_trace/stack.rb
+- config/initializers/modules/dir.rb
 - config/initializers/monkeys/application_controller.rb
 - config/initializers/monkeys/application_record.rb
 - config/initializers/monkeys/date_time.rb
@@ -59,6 +63,7 @@ files:
 - config/initializers/monkeys/kernel.rb
 - config/initializers/monkeys/module.rb
 - config/initializers/monkeys/object.rb
+- config/initializers/monkeys/string.rb
 - config/initializers/wrappers/decorators/application_decorator.rb
 - config/initializers/wrappers/decorators/controller_decorator.rb
 - config/initializers/wrappers/jobs/active_job_macros.rb