eitil 0.3.5 → 0.3.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56e99cc29a813ae79db47620342f21059e0ee2fc6ac57d3d1555472908d671e1
-  data.tar.gz: 9391db6351b7f43230b64c7c7fa5a78fb5f7b95055ab2103ed68e28dd6673dc7
+  metadata.gz: 0a5f03357f8feee5c40fa17fdf11acc544229eb85e822578929d18bab25f5ec4
+  data.tar.gz: 32ecc96ed0088b7a447fac59505d76e1f5c0e4131b38a615b2ccdf6bdbdf4b13
 SHA512:
-  metadata.gz: 45540a3818ba26d7197ce4ed9cd2e7ab1061d7889445566f583a1fa5f1b218a324ae484f968c4291017bb12ea30c7e69cea3765135d2de2a703eee8ba02b8f9f
-  data.tar.gz: bec07d5c24641ce1e24dc31c450d01b98ca2a28b13ea799f8b285e59f701e946ae362e69e2e9c3ecc99dc805ce8bc6e48325acd5f8f19c04ccd2fd894b1cb786
+  metadata.gz: 706798e2c7e5e1f81cd413a5698fa030eedcc606dae5a2a6ade7fd74bc21cfa1e485cc3a7c782097aa7cac2271d879f91e8d0791627540df9acd03e8bc873273
+  data.tar.gz: c33996734e261cc3419ad9dfcec4dd271ecb40be39cc0dac2ae44156f750329a179a3988ba0a4d574a27fa8d411b1542f230c566544d9bb67ef4f6c60d93dc1a

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
@@ -114,6 +130,17 @@ auto_dig(_hash = self, _key)
 
 
 
+## Float
+
+```ruby
+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)
+```
+
+
+
 ## ApplicationController
 
 ```ruby
@@ -131,6 +158,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')
 ```
 
 
@@ -227,14 +262,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 
@@ -305,7 +344,7 @@ Your models should inherit the module Eitil::DefaultScopes through inclusion in
 
 
 
-# Modules
+# Modules & Classes
 
 
 
@@ -332,3 +371,22 @@ Eitil::Dir.lines(directory='app')
 ```
 
 
+
+## 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/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/float.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/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

@@ -6,19 +6,47 @@ Kernel.module_eval do
   # 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)
+  def new_job(_method, *args, **kwargs)
 
     if instance_methods(false).include? _method
-      define_method "#{_method}_job" do |_self = nil|
-        Eitil::SingleMethodJob.perform_later(_class: self.class.to_s, _method: _method.to_s, id: safe_send(:id), _self: self.to_json)
+      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

@@ -8,9 +8,7 @@ module Eitil
     # 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(_class:, _method:, id: nil, _self: nil)     
-      binding.pry
-
+    def perform(*args, _class:, _method:, id: nil, _self: nil, **kwargs)      
       object = 
         if id
           _class.constantize.find(id)
@@ -20,7 +18,7 @@ module Eitil
           _class.constantize
         end
 
-      object.send _method
+      object.send _method, *args, **kwargs
     end
   end
 end

data/lib/eitil/version.rb

@@ -1,3 +1,3 @@
 module Eitil
-  VERSION = '0.3.5'
+  VERSION = '0.3.10'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eitil
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.10
 platform: ruby
 authors:
 - Jurriaan Schrofer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-31 00:00:00.000000000 Z
+date: 2021-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -52,14 +52,19 @@ 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
+- config/initializers/monkeys/float.rb
 - config/initializers/monkeys/hash.rb
 - 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