eitil 1.3.4 → 1.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2249e8b19220f03df98daad2d625c434b46c3eb54982afce5b71098eb2ec7561
-  data.tar.gz: f651112c073d1263919418904359cbdb03c39f232a216754c78da910b610e7d0
+  metadata.gz: 62c186ffdd14894a3ed5ce9d6a635030821ab1bdc86aa5ad7f35c7d1a3592dca
+  data.tar.gz: b53791e40cd28e1f6435e9cbc2888c57e26ca6f5d05b3cb3518f7285a6311618
 SHA512:
-  metadata.gz: 851e8992abcf099c7cb23e2fed760a37278d606b6d328b4a20d0444b93986a4fef3760ea5cad242d9e6bedc15b7e71620070ec2d80ec6c32b6a44bc253cf789f
-  data.tar.gz: 1918147e3399a9a3e6fd363fb509bc55880f1dde592ef88cc072e2943ebb7f046db2ac312120cf48823338352a1cbe7bab06cdf5fed751419efba0581ddc5b75
+  metadata.gz: 869d88f962e7a688b203d0f5e89132ce5f343975d6ce1a0c926691454027c5935073086766c5d0febb28be0108ca8a183f106cfb32b8314f50046dbffd6d68c7
+  data.tar.gz: 3ebe01d21f32cc00c3e9c84b9937b71d9e1aa46590f5b0384c18d28e0a1d6706a161cab34c58bdb2a0b59c2a8883dcf1371bcd928f645b8c6fadcdd6057143c4

data/eitil_core/README.md

@@ -385,6 +385,35 @@ transform_string_values!(&block)
 # bang variant of .transform_string_values, which recursively modifies all objects it is called on.
 ```
 
+
+## Kernel
+
+```ruby
+
+require "eitil_core/kernel"
+
+```
+
+```ruby
+# require "eitil_core/kernel/loadquire"
+
+loadquire(current_path, *relative_paths, ext: '.rb')
+# use .loadquire to pickup code changes on reload in development environment, while not creating overhead in production through 'load' usage
+# call as: loadquire __dir__, 'user'
+# => loads '../user.rb' in development environment, requires '../user.rb' in all other environments
+```
+
+```ruby
+# require "eitil_core/kernel/loadquire_bang"
+
+loadquire!(*relative_paths, ext: '.rb')
+# use .loadquire! to pickup code changes on reload in development environment, while not creating overhead in production through 'load' usage
+# call as: loadquire! 'user'
+# => loads '../user.rb' in development environment, requires '../user.rb' in all other environments
+
+```
+
+
 ## Lookups
 
 ```ruby

data/eitil_core/lib/eitil_core/kernel/loadquire.rb

@@ -0,0 +1,25 @@
+
+# require "eitil_core/kernel/loadquire"
+
+Kernel.module_eval do
+
+  def loadquire(current_path, *relative_paths, ext: '.rb')
+    
+    file_paths = relative_paths.map do |relative_path| 
+      File.expand_path(relative_path, current_path).concat(ext)
+    end
+
+    if Object.const_defined?('Rails') && Rails.env.development?
+      file_paths.each do |path|
+        load(path)
+      end
+
+    else      
+      file_paths.each do |path|
+        require(path)
+      end      
+    end
+
+  end
+
+end

data/eitil_core/lib/eitil_core/kernel/loadquire_bang.rb

@@ -0,0 +1,26 @@
+
+# require "eitil_core/kernel/loadquire_bang"
+
+Kernel.module_eval do
+
+  def loadquire!(*relative_paths, ext: '.rb')
+    
+    current_path = caller.first.split('/')[0..-2].join('/')
+    file_paths   = relative_paths.map do |relative_path| 
+      File.expand_path(relative_path, current_path).concat(ext)
+    end
+
+    if Object.const_defined?('Rails') && Rails.env.development?
+      file_paths.each do |path|
+        load(path)
+      end
+
+    else      
+      file_paths.each do |path|
+        require(path)
+      end      
+    end
+
+  end
+
+end

data/eitil_core/lib/eitil_core/kernel.rb

@@ -1,2 +1,3 @@
 
-require "eitil_core/kernel/always_require_relative"
+require "eitil_core/kernel/loadquire"
+require "eitil_core/kernel/loadquire_bang"

data/eitil_wrapper/README.md

@@ -150,11 +150,20 @@ extended_resources(controller, **kwargs)
 
 
 
-## EitilWrapper::Scopes
+## EitilWrapper::Records
 
 ```ruby
 
-require "eitil_wrapper/scopes"
+# include all below EitilWrapper::Records helpers through:
+require "eitil_wrapper/records"
+
+```
+
+### Scopes
+
+```ruby
+
+require "eitil_wrapper/records/scopes"
 
 ```
 
@@ -175,8 +184,6 @@ Scopes are generated through the columns of your model's database table. Which s
 .{column_name}_before_date(date)
 .{column_name}_after_date(date) 
 .{column_name}_between_dates(start_date, end_date)
-.{column_name}_oldest_first
-.{column_name}_newest_first
 
 # columns of datatype: date
 .{column_name}_today      
@@ -186,27 +193,93 @@ Scopes are generated through the columns of your model's database table. Which s
 .{column_name}_before_date(date)
 .{column_name}_after_date(date) 
 .{column_name}_between_dates(start_date, end_date)
-.{column_name}_oldest_first
-.{column_name}_newest_first
 
 # columns of datatype: integer
 .{column_name}_equal_to(number)      
 .{column_name}_lower_than(number)
 .{column_name}_higher_than(number)
 .{column_name}_between(min, max)
-.{column_name}_ascending
-.{column_name}_descending
 
 # columns of datatype: float
 .{column_name}_equal_to(number)      
 .{column_name}_lower_than(number)
 .{column_name}_higher_than(number)
 .{column_name}_between(min, max)
+```
+
+### Sorts
+
+
+```ruby
+
+require "eitil_wrapper/records/sorts"
+
+```
+
+Sorts are generated through the columns of your model's database table. Which sorts are generated depends on the datatype of a column. A sort method is defined only if it does not already responds to another method of the same name. The sorts generated are:
+
+```ruby
+# require "eitil_wrapper/scopes/default_scopes"
+
+# columns of datatype: datetime
+.{column_name}_oldest_first
+.{column_name}_newest_first
+
+# columns of datatype: date
+.{column_name}_oldest_first
+.{column_name}_newest_first
+
+# columns of datatype: integer
+.{column_name}_ascending
+.{column_name}_descending
+
+# columns of datatype: float
 .{column_name}_ascending
 .{column_name}_descending
 ```
 
 
+### Calculators
+
+
+```ruby
+
+require "eitil_wrapper/records/calculators"
+
+```
+
+Calculators are generated through the columns of your model's database table. Which calculators are generated depends on the datatype of a column. A calculator method is defined only if it does not already responds to another method of the same name. The calculators generated are:
+
+```ruby
+# require "eitil_wrapper/scopes/default_scopes"
+
+# columns of datatype: array (serialized)
+.{column_name}_sum # returns all uniq elements in a new, single array
+
+# columns of datatype: integer
+.{column_name}_max
+.{column_name}_min
+.{column_name}_sum
+.{column_name}_avg
+
+# columns of datatype: float
+.{column_name}_max
+.{column_name}_min
+.{column_name}_sum
+.{column_name}_avg
+
+# columns of datatype: decimal
+.{column_name}_max
+.{column_name}_min
+.{column_name}_sum
+.{column_name}_avg
+
+# columns of datatype: bigint
+.{column_name}_max
+.{column_name}_min
+.{column_name}_sum
+.{column_name}_avg
+```
 
 
 

data/eitil_wrapper/lib/eitil_wrapper/railtie.rb

@@ -7,9 +7,16 @@ module EitilWrapper
 
     initializer "my_railtie.configure_rails_initialization", options: :after do |app|
 
+      if Object.const_defined?('EitilWrapper::Records::DefaultCalculators')
+        ::ApplicationRecord.send(:extend, EitilWrapper::Records::DefaultCalculators)
+      end
+
+      if Object.const_defined?('EitilWrapper::Records::DefaultScopes')
+        ::ApplicationRecord.send(:extend, EitilWrapper::Records::DefaultScopes)
+      end
 
-      if Object.const_defined?('EitilWrapper::Scopes::DefaultScopes')
-        ::ApplicationRecord.send(:extend, EitilWrapper::Scopes::DefaultScopes)
+      if Object.const_defined?('EitilWrapper::Records::DefaultSorts')
+        ::ApplicationRecord.send(:extend, EitilWrapper::Records::DefaultSorts)
       end
 
       if Object.const_defined?('EitilWrapper::Callbacks::HelperMethods')

data/eitil_wrapper/lib/eitil_wrapper/records/default_calculators.rb

@@ -0,0 +1,101 @@
+
+# require "eitil_wrapper/records/default_calculators"
+
+# require "eitil_wrapper/railtie" to run the dynamic dispatch as an init hook during boot
+require "eitil_wrapper/railtie"
+
+module EitilWrapper
+  module Records
+    module DefaultCalculators
+
+      Eitil::ApplicationRecordModules << self
+
+      SharableNumberCalculators = -> (_class, column) {
+        _class.eitil_calculator :"#{column}_max", -> { _class.maximum(column) }
+        _class.eitil_calculator :"#{column}_min", -> { _class.minimum(column) }
+        _class.eitil_calculator :"#{column}_sum", -> { _class.sum(column) }
+        _class.eitil_calculator :"#{column}_avg", -> { _class.average(column) }
+      }
+
+      SharableIterableCalculators = -> (_class, column) {   
+        _class.eitil_calculator :"#{column}_sum", -> { _class.pluck(column).flatten!.uniq! }
+      }
+
+      def inherited(subclass)
+        super
+        return if Eitil.skip_default_calculators_for_models.include?(subclass.to_s.to_sym)
+        
+        # Set the proper table_names for namespaced models. Without setting this,
+        # Rails run into problems due to the fact that the first call to the model's
+        # constant triggers this initializer first, and only thereafter the model file 
+        # which sets the correct table_name through a macro.
+        
+        namespaced_class    = subclass.to_s.include?('::')
+        subclass.table_name = subclass.to_s.gsub('::', '_').downcase.pluralize if namespaced_class
+
+        subclass.use_eitil_calculators
+
+        rescue => e
+          puts "default calculators failed for class '#{subclass}' with expected table '#{subclass.table_name}' because of #{e.class} and '#{e.to_s.split(' ').first}'"
+      end
+
+      def use_eitil_calculators 
+        return if abstract_class?
+        
+        # text[]           is postgresql's datatype for serialized arrays
+        # numeric          is postgresql's datatype for decimals
+        # double precision is postgresql's datatype for floats
+
+
+        %w[integer bigint double\ precision numeric].each do |_type| 
+          send :"create_eitil_#{_type.gsub(' ','_')}_calculators"
+        end
+
+        create_array_calculators
+      end
+
+      def eitil_calculator(_name, _proc)
+        # skip calculator methods for primary and foreign key columns
+        return if _name.to_s =~ /^id_[a-z]{1,}$/ || _name.to_s =~ /_id_[a-z]{1,}$/
+        
+        define_singleton_method(_name) { _proc.call } unless respond_to? _name
+      end
+    
+      def calculator_columns_of_type(data_type)
+        columns_hash.select { |column,v| v.sql_type == data_type }
+      end
+
+      def create_eitil_integer_calculators
+        calculator_columns_of_type("integer")&.map do |column, object|
+          SharableNumberCalculators.call self, column
+        end
+      end
+
+      def create_eitil_bigint_calculators
+        calculator_columns_of_type("bigint")&.map do |column, object|
+          SharableNumberCalculators.call self, column
+        end
+      end
+
+      def create_eitil_double_precision_calculators
+        calculator_columns_of_type("double\ precision")&.map do |column, object|
+          SharableNumberCalculators.call self, column
+        end
+      end
+
+      def create_eitil_numeric_calculators
+        calculator_columns_of_type("numeric")&.map do |column, object|
+          SharableNumberCalculators.call self, column
+        end
+      end
+
+      def create_array_calculators
+        columns = columns_hash.select { |column,v| v.sql_type == "text" && v.default == "{}" }
+        columns&.map do |column, object|
+          SharableIterableCalculators.call self, column
+        end
+      end
+            
+    end
+  end
+end

data/eitil_wrapper/lib/eitil_wrapper/{scopes → records}/default_scopes.rb

@@ -1,11 +1,11 @@
 
-# require "eitil_wrapper/scopes/default_scopes"
+# require "eitil_wrapper/records/default_scopes"
 
 # require "eitil_wrapper/railtie" to run the dynamic dispatch as an init hook during boot
 require "eitil_wrapper/railtie"
 
 module EitilWrapper
-  module Scopes
+  module Records
     module DefaultScopes
 
       Eitil::ApplicationRecordModules << self
@@ -19,9 +19,6 @@ module EitilWrapper
         _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) }
-
-        _class.eitil_scope :"#{column}_oldest_first",   -> { order("#{column} ASC") }
-        _class.eitil_scope :"#{column}_newest_first",   -> { order("#{column} DESC") }
       }
 
       SharableNumScopes = -> (_class, column) {
@@ -29,9 +26,6 @@ module EitilWrapper
         _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.eitil_scope :"#{column}_ascending",      -> { order("#{column} ASC") }
-        _class.eitil_scope :"#{column}_descending",     -> { order("#{column} DESC") }
       }
 
       def inherited(subclass)
@@ -42,13 +36,14 @@ module EitilWrapper
         # Rails run into problems due to the fact that the first call to the model's
         # constant triggers this initializer first, and only thereafter the model file 
         # which sets the correct table_name through a macro.
+        
         namespaced_class    = subclass.to_s.include?('::')
         subclass.table_name = subclass.to_s.gsub('::', '_').downcase.pluralize if namespaced_class
 
         subclass.use_eitil_scopes
 
         rescue => e
-          puts "default scopes failed for #{subclass} because of #{e.class} and '#{e.to_s.split(' ').first}'"
+          puts "default scopes failed for class '#{subclass}' with expected table '#{subclass.table_name}' because of #{e.class} and '#{e.to_s.split(' ').first}'"
       end
 
       def use_eitil_scopes  
@@ -97,4 +92,4 @@ module EitilWrapper
             
     end
   end
-end
+end

data/eitil_wrapper/lib/eitil_wrapper/records/default_sorts.rb

@@ -0,0 +1,81 @@
+
+# require "eitil_wrapper/records/default_sorts"
+
+# require "eitil_wrapper/railtie" to run the dynamic dispatch as an init hook during boot
+require "eitil_wrapper/railtie"
+
+
+module EitilWrapper
+  module Records
+    module DefaultSorts
+
+      Eitil::ApplicationRecordModules << self
+
+      SharableDateSorts = -> (_class, column) {
+        _class.eitil_sort :"#{column}_oldest_first", -> { _class.order("#{column} ASC") }
+        _class.eitil_sort :"#{column}_newest_first", -> { _class.order("#{column} DESC") }
+      }
+
+      SharableNumSorts = -> (_class, column) {
+        _class.eitil_sort :"#{column}_ascending",    -> { _class.order("#{column} ASC") }
+        _class.eitil_sort :"#{column}_descending",   -> { _class.order("#{column} DESC") }
+      }
+
+      def inherited(subclass)
+        super
+        return if Eitil.skip_default_sorts_for_models.include?(subclass.to_s.to_sym)
+        
+        # Set the proper table_names for namespaced models. Without setting this,
+        # Rails run into problems due to the fact that the first call to the model's
+        # constant triggers this initializer first, and only thereafter the model file 
+        # which sets the correct table_name through a macro.
+        
+        namespaced_class    = subclass.to_s.include?('::')
+        subclass.table_name = subclass.to_s.gsub('::', '_').downcase.pluralize if namespaced_class
+
+        subclass.use_eitil_sorts
+
+        rescue => e
+          puts "default sorts failed for class '#{subclass}' with expected table '#{subclass.table_name}' because of #{e.class} and '#{e.to_s.split(' ').first}'"
+      end
+
+      def use_eitil_sorts  
+        return if abstract_class?
+        %i[datetime date integer float].each { |_type| send :"create_eitil_#{_type}_sorts" }
+      end
+
+      def eitil_sort(_name, _proc)
+        define_singleton_method(_name) { _proc.call } unless respond_to? _name 
+      end
+    
+      def sort_columns_of_type(data_type)
+        columns_hash.select { |column,v| v.sql_type_metadata.type == data_type }
+      end
+
+      def create_eitil_datetime_sorts
+        columns_of_type(:datetime)&.map do |column, object|
+          SharableDateSorts.call self, column
+        end
+      end
+
+      def create_eitil_date_sorts
+        columns_of_type(:date)&.map do |column, object|
+          SharableDateSorts.call self, column
+        end
+      end
+
+      def create_eitil_integer_sorts
+        columns_of_type(:integer)&.map do |column, object|
+          SharableNumSorts.call self, column
+        end
+      end
+
+      def create_eitil_float_sorts
+        columns_of_type(:float)&.map do |column, object|
+          SharableNumSorts.call self, column
+        end
+      end
+
+    end
+  end
+end

data/eitil_wrapper/lib/eitil_wrapper/records.rb

@@ -0,0 +1,4 @@
+
+require "eitil_wrapper/records/default_scopes"
+require "eitil_wrapper/records/default_calculators"
+require "eitil_wrapper/records/default_sorts"

data/eitil_wrapper/lib/eitil_wrapper.rb

@@ -2,7 +2,7 @@
 require "eitil_wrapper"
 
 require "eitil_wrapper/jobs"
-require "eitil_wrapper/scopes"
+require "eitil_wrapper/records"
 require "eitil_wrapper/routes"
 require "eitil_wrapper/callbacks"
 require "eitil_wrapper/decorators"

data/lib/eitil/railtie.rb

@@ -31,10 +31,14 @@ module Eitil
 
       Eitil.mattr_accessor :controller_ivars, 
                            :skip_default_scopes_for_models,
+                           :skip_default_calculators_for_models,
+                           :skip_default_sorts_for_models,
                            :skip_callback_helper_methods_for_models
 
-      Eitil.controller_ivars ||= []
-      Eitil.skip_default_scopes_for_models ||= []
+      Eitil.controller_ivars                        ||= []
+      Eitil.skip_default_scopes_for_models          ||= []
+      Eitil.skip_default_calculators_for_models     ||= []
+      Eitil.skip_default_sorts_for_models           ||= []
       Eitil.skip_callback_helper_methods_for_models ||= []
 
       def Eitil.set_config(&block)

data/lib/eitil/version.rb

@@ -1,5 +1,5 @@
 module Eitil
   
-  VERSION = '1.3.4'
+  VERSION = '1.3.8'
   
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eitil
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.3.8
 platform: ruby
 authors:
 - Jurriaan Schrofer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-17 00:00:00.000000000 Z
+date: 2021-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -207,7 +207,8 @@ files:
 - eitil_core/lib/eitil_core/hash/auto_dig.rb
 - eitil_core/lib/eitil_core/hash/transform_string_values.rb
 - eitil_core/lib/eitil_core/kernel.rb
-- eitil_core/lib/eitil_core/kernel/always_require_relative.rb
+- eitil_core/lib/eitil_core/kernel/loadquire.rb
+- eitil_core/lib/eitil_core/kernel/loadquire_bang.rb
 - eitil_core/lib/eitil_core/lookups.rb
 - eitil_core/lib/eitil_core/lookups/all_methods.rb
 - eitil_core/lib/eitil_core/lookups/gem_path.rb
@@ -282,13 +283,15 @@ files:
 - eitil_wrapper/lib/eitil_wrapper/jobs/new_job_now.rb
 - eitil_wrapper/lib/eitil_wrapper/jobs/single_method_job.rb
 - eitil_wrapper/lib/eitil_wrapper/railtie.rb
+- eitil_wrapper/lib/eitil_wrapper/records.rb
+- eitil_wrapper/lib/eitil_wrapper/records/default_calculators.rb
+- eitil_wrapper/lib/eitil_wrapper/records/default_scopes.rb
+- eitil_wrapper/lib/eitil_wrapper/records/default_sorts.rb
 - eitil_wrapper/lib/eitil_wrapper/request_logger.rb
 - eitil_wrapper/lib/eitil_wrapper/request_logger/controller_mixin.rb
 - eitil_wrapper/lib/eitil_wrapper/request_logger/logger_job.rb
 - eitil_wrapper/lib/eitil_wrapper/routes.rb
 - eitil_wrapper/lib/eitil_wrapper/routes/extended_resources.rb
-- eitil_wrapper/lib/eitil_wrapper/scopes.rb
-- eitil_wrapper/lib/eitil_wrapper/scopes/default_scopes.rb
 - lib/eitil.rb
 - lib/eitil/all.rb
 - lib/eitil/railtie.rb
@@ -468,7 +471,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.9
 signing_key:
 specification_version: 4
 summary: Eitil (eitje utility) never stops increasing your life's efficacy and productivity,

data/eitil_core/lib/eitil_core/kernel/always_require_relative.rb

@@ -1,21 +0,0 @@
-
-# require "eitil_core/kernel/always_require_relative"
-
-Kernel.module_eval do
-
-  def always_require_relative(current_path, relative_path, extension = '.rb')
-    
-    unless Object.const_defined?('Rails')
-      return require_relative(path)
-    end
-
-    absolute_path = File.expand_path(relative_path, current_path).concat(extension)
-
-    if Rails.env.development?
-      load(absolute_path)
-    else      
-      require(absolute_path)
-    end
-  end
-
-end

data/eitil_wrapper/lib/eitil_wrapper/scopes.rb

@@ -1,2 +0,0 @@
-
-require "eitil_wrapper/scopes/default_scopes"