eitil 0.3.4 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f35510328554ac09ddfb48b697e0b7dd2b6a801b20954505b14849c2f1a3227a
-  data.tar.gz: 9d8edf28b695b3835d4dacaf46bd1dbe7dc1e9ebcd9ae2bce403b9a12ffe7529
+  metadata.gz: ac7bd5bff2af923e06936b0016f4f07f8d4eba225a68dc193bdf5f277bcdbb97
+  data.tar.gz: 193b41fa2a5fde545b189b79a2c94328c242bf45d71ff5802cfab3fb7b95c402
 SHA512:
-  metadata.gz: 2cec6226350e58696fb8d814d9cd7e57b768a39c5bc392d6686792d80ecc2dab328a64c131ce32bf05d49627f30b10606544e3c1a6170c4e6941054649dd931d
-  data.tar.gz: cbb2ad53d5727feffad6007bde83d34edaf4336f47330ad95f096348f423fc0d3fca02375a3d34c38f420f9df99d30ec0f713b2436b62488879594a5e4e9bee3
+  metadata.gz: 52c86de08e26441922852f3cd5563a36ac46c585a3ab50745e1f0fc2dacf9dc6187574f54c7c33ba415fdd3be006e0c45b7245076b209fd74a3782b07c1ace34
+  data.tar.gz: 0bf06bc0226924db17b2c9b7f9138eac75116cb4d351fe9818690f2745cfaa68d43eac837dbfb0825b6870eeeb0ab4b50cb091ed05243b533501498d8ca60eac

data/README.md

@@ -103,6 +103,22 @@ 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)
+# 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...
+```
+
+
+
 ## Hash
 
 ```ruby
@@ -131,6 +147,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 +201,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 +251,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 +332,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,96 @@
+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
+
+# Descending classes which are always numeric
+
+class Numeric
+
+  def is_nan?
+    false
+  end
+
+  def is_num?
+    true
+  end
+
+end
+
+# Classes which are never numeric
+
+class NilClass
+
+  def is_nan?
+    true
+  end
+
+  def is_num?
+    false
+  end
+
+end
+
+
+class TrueClass
+
+  def is_nan?
+    true
+  end
+
+  def is_num?
+    false
+  end
+
+end
+
+
+class FalseClass
+
+  def is_nan?
+    true
+  end
+
+  def is_num?
+    false
+  end
+
+end
+
+
+class Hash
+
+  def is_nan?
+    true
+  end
+
+  def is_num?
+    false
+  end
+
+end
+
+
+class Array
+
+  def is_nan?
+    true
+  end
+
+  def is_num?
+    false
+  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

@@ -48,7 +48,7 @@ module Eitil
 
           def create_eitil_boolean_scopes
             columns_of_type(:boolean)&.map do |column, object|      
-              eitil_scope :"#{column}_true",  -> { where(column => true) }
+              eitil_scope :"#{column}_true",     -> { where(column => true) }
               eitil_scope :"#{column}_false", -> { where(column => [false, nil]) }
             end
           end

data/lib/eitil/version.rb

@@ -1,3 +1,3 @@
 module Eitil
-  VERSION = '0.3.4'
+  VERSION = '0.3.9'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eitil
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.9
 platform: ruby
 authors:
 - Jurriaan Schrofer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-21 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