eitil 1.0.2 → 1.0.3.e.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f00d6cb9618a2ac3b44228369fbf6c0dc1a7c4e4f7b8f458fb74ab49d842d93
-  data.tar.gz: c9b52d358edd18661a02c7961d30706b123f24708b48f864c842c8d6d5554d51
+  metadata.gz: 1872b8eec9fde6e3cc707f5d66eb6c595000b3d4bb1d57d100b5759b39167cc2
+  data.tar.gz: d4cc20f05567ae72bfd693efe75e559584308a16fdf3322f6de6f2bd13ab448d
 SHA512:
-  metadata.gz: 013e9004bbc5bb836c43c008ad749d55c05f9088268247d8519be72e28636735604cc8af8a3405848f88bc92cb902cad3bdd3af72d4907cb33fc2a9ec87dcde1
-  data.tar.gz: af236edfe30a37449bbe255d18deffa75e196a7825eed2da9fc81d542f4e694c05931e139a4f40999ba63df1f25574a142d553669d7c2bde6c2b50d5ac8574f6
+  metadata.gz: 747044b67ccab759ecd85c6e58e03607fff0038bfe98aad4f66e6fa8680fd06ac4fbc59922339c4f25ff7e38bdd7dac6feccb00bc0abb806626c1ccdb1a54300
+  data.tar.gz: 165cb9650bbfe9639da5ac493d01ea728001df63515854a5483149a9ff182a0f40796385ec089bf39e72cfb844423d0fa06d94cf1e52e4d0b5addec33f102b64

data/Rakefile

@@ -1,7 +1,6 @@
 require "bundler/setup"
 
 APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
-load "rails/tasks/engine.rake"
 
 load "rails/tasks/statistics.rake"
 

data/eitil_core/README.md

@@ -76,11 +76,11 @@ all_args_to_ivars(binding)
 
 
 ```ruby
-# require "eitil_core/argument_helpers/args_to_ivars"
+# require "eitil_core/argument_helpers/all_args_to_ivars_bang"
 
-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
+all_args_to_ivars!
+# works the same as .all_args_to_ivars, except that passing the binding is no longer required
+# production usage is discouraged by the creator of the supporting gem
 ```
 
 
@@ -94,6 +94,52 @@ all_kwargs_to_ivars(local_binding, namespace= :kwargs)
 ```
 
 
+```ruby
+# require "eitil_core/argument_helpers/all_kwargs_to_ivars_bang"
+
+all_kwargs_to_ivars!(namespace= :kwargs)
+# works the same as .all_kwargs_to_ivars, except that passing the binding is no longer required
+# production usage is discouraged by the creator of the supporting gem
+```
+
+
+```ruby
+# require "eitil_core/argument_helpers/args_to_h"
+
+args_to_h(binding, *local_vars)
+# creates a hash, with a given local_var as keys and its value as value
+# call as: args_to_h(binding, :username, :password)
+# => { username: 'jurriaan', password: 'matz_is_nice' }
+```
+
+
+```ruby
+# require "eitil_core/argument_helpers/args_to_h_bang"
+
+args_to_h!(*local_vars)
+# works the same as .args_to_h, except that passing the binding is no longer required
+# production usage is discouraged by the creator of the supporting gem
+```
+
+
+```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/args_to_ivars_bang"
+
+args_to_ivars!(*local_vars)
+# works the same as .args_to_ivars, except that passing the binding is no longer required
+# production usage is discouraged by the creator of the supporting gem
+```
+
+
 ## Concerns
 
 ```ruby
@@ -203,6 +249,16 @@ all_methods(include_ancestors = true, grep: nil)
 ```
 
 
+```ruby
+# require "eitil_core/lookups/gem_path"
+
+Find.gem_path(gem_name)
+# finds the root of an installed gem, allowing you to traverse its paths from there.
+# call as: Find.gem_path("rails")
+# => "/Users/jurriaanschrofer/.rvm/gems/ruby-2.6.5/gems/rails-5.2.3"
+```
+
+
 ## SafeExecutions
 
 ```ruby

data/eitil_core/lib/eitil_core/argument_helpers.rb

@@ -1,5 +1,13 @@
 # require "eitil_core/arugment_helpers"
 
 require "eitil_core/argument_helpers/all_args_to_ivars"
+require "eitil_core/argument_helpers/all_args_to_ivars_bang"
+
 require "eitil_core/argument_helpers/args_to_ivars"
+require "eitil_core/argument_helpers/args_to_ivars_bang"
+
+require "eitil_core/argument_helpers/args_to_h"
+require "eitil_core/argument_helpers/args_to_h_bang"
+
 require "eitil_core/argument_helpers/all_kwargs_to_ivars"
+require "eitil_core/argument_helpers/all_kwargs_to_ivars_bang"

data/eitil_core/lib/eitil_core/argument_helpers/all_args_to_ivars_bang.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/argument_helpers/all_args_to_ivars_bang"
+
+require "eitil_core/lookups/gem_path"
+require "#{Find.gem_path('binding_of_caller')}/lib/binding_of_caller/mri.rb"
+
+Kernel.module_eval do
+
+  def all_args_to_ivars!
+    binding.of_caller(1).local_variables.each do |lvar|
+      instance_variable_set("@#{lvar}", binding.of_caller(2).local_variable_get(lvar))
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers/all_kwargs_to_ivars_bang.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/argument_helpers/all_kwargs_to_ivars_bang"
+
+require "eitil_core/lookups/gem_path"
+require "#{Find.gem_path('binding_of_caller')}/lib/binding_of_caller/mri.rb"
+
+Kernel.module_eval do
+
+  def all_kwargs_to_ivars!(namespace=:kwargs)
+    binding.of_caller(1).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_h.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/argument_helpers/args_to_h"
+
+Kernel.module_eval do
+
+  def args_to_h(local_binding, *local_vars)
+
+    local_vars.reject { |lvar| lvar == local_binding }
+              .reject { |lvar| lvar.to_s.starts_with?('_') }
+              .map    { |lvar| { "#{lvar}": local_binding.local_variable_get(lvar) } }
+              .inject &:merge
+
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers/args_to_h_bang.rb

@@ -0,0 +1,17 @@
+
+# require "eitil_core/argument_helpers/args_to_h_bang"
+
+require "eitil_core/lookups/gem_path"
+require "#{Find.gem_path('binding_of_caller')}/lib/binding_of_caller/mri.rb"
+
+Kernel.module_eval do
+
+  def args_to_h!(*local_vars)
+
+    local_vars.reject { |lvar| lvar.to_s.starts_with?('_') }
+              .map    { |lvar| { "#{lvar}": binding.of_caller(2).local_variable_get(lvar) } }
+              .inject &:merge
+
+  end
+
+end

data/eitil_core/lib/eitil_core/argument_helpers/args_to_ivars_bang.rb

@@ -0,0 +1,15 @@
+
+# require "eitil_core/argument_helpers/args_to_ivars_bang"
+
+require "eitil_core/lookups/gem_path"
+require "#{Find.gem_path('binding_of_caller')}/lib/binding_of_caller/mri.rb"
+
+Kernel.module_eval do
+
+  def args_to_ivars!(*local_vars)
+    local_vars.each do |lvar|
+      instance_variable_set("@#{lvar}", binding.of_caller(2).local_variable_get(lvar))
+    end
+  end
+
+end

data/eitil_core/lib/eitil_core/float/safe_to_i.rb

@@ -1,3 +1,6 @@
+
+# require "eitil_core/float/safe_to_i"
+
 class Float
 
   # converts a float to an integer, only when no decimal values are lost.

data/eitil_core/lib/eitil_core/lookups.rb

@@ -1,2 +1,3 @@
 
-require "eitil_core/lookups/all_methods"
+require "eitil_core/lookups/all_methods"
+require "eitil_core/lookups/gem_path"

data/eitil_core/lib/eitil_core/lookups/gem_path.rb

@@ -0,0 +1,10 @@
+
+# require "eitil_core/lookups/gem_path"
+
+module Find
+
+  def self.gem_path(gem_name)
+    Gem.loaded_specs[gem_name].full_gem_path
+  end
+
+end

data/eitil_integrate/README.md

@@ -6,3 +6,14 @@
 EitilIntegrate provides seamless integrations with select gems and API's, through helper methods stored in PORO's. 
 
 
+## EitilIntegrate::RubyXL::ApplicationExporter
+
+```ruby
+
+require "eitil_integrate/application_exporter"
+
+```
+
+EitilIntegrate::RubyXL::ApplicationExporter provides an extensive wrapper around the RubyXL gem, and can be used by setting it as the superclass of your application's exporter classes.
+
+Since the functionality is diverse and changing, you can best look at the source code files for the options and methods.

data/eitil_integrate/lib/eitil_integrate.rb

@@ -0,0 +1,4 @@
+
+# require "eitil_integrate"
+
+require "eitil_integrate/application_exporter"

data/eitil_integrate/lib/eitil_integrate/application_exporter.rb

@@ -0,0 +1,22 @@
+# require "eitil_integrate/application_exporter"
+
+# base file, which is required by all others
+require_relative "application_exporter/initialize"
+
+# temp file, with methods that should, at some point, moved elsewhere
+require_relative "application_exporter/helpers"
+
+# files split by theme and purpose, feel free to cherry-pick
+require_relative "application_exporter/default_export"
+require_relative "application_exporter/validations"
+require_relative "application_exporter/write_cells"
+require_relative "application_exporter/write_messages"
+require_relative "application_exporter/style_cells"
+require_relative "application_exporter/store_file"
+require_relative "application_exporter/setters"
+require_relative "application_exporter/selectors"
+require_relative "application_exporter/lookups"
+require_relative "application_exporter/infos"
+
+# the AutoSum module, which is a seperately functioning module (service)
+require_relative "application_exporter/auto_sum"

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum.rb

@@ -0,0 +1,10 @@
+
+# require "eitil_integrate/application_exporter/auto_sum"
+
+require_relative "auto_sum/initialize"
+
+require_relative "auto_sum/drop_data"
+require_relative "auto_sum/format_data"
+require_relative "auto_sum/reduce_data"
+require_relative "auto_sum/sum_data"
+require_relative "auto_sum/present_data"

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum/drop_data.rb

@@ -0,0 +1,54 @@
+
+# require "eitil_integrate/application_exporter/auto_sum/drop_data"
+
+module EitilIntegrate::RubyXL
+  module AutoSum
+    class << self
+    
+      def drop_data
+        # since excel layout consistency requires stringified values, we first need
+        # to convert strings back to floats.
+        try_float_conversion
+
+        # after the required conversions, drop all values that should not be accepted.
+        drop_nil_values
+        drop_empty_values
+        drop_non_accepted_values
+      end
+
+      def try_float_conversion
+        @hash.transform_values! { |array| array.map { |item| item.is_num? ? item.to_f : item } }
+      end
+
+      def drop_nil_values
+        @hash.transform_values! &:compact
+      end
+
+      def drop_empty_values
+        @hash.transform_values! { |array| array.reject { |item| item.safe_send :empty? } }
+      end
+
+      def drop_non_accepted_values
+        @hash.transform_values! { |array| array.reject { |item| !accepted_value? item } }
+      end
+
+      def accepted_value?(value)
+        @value = value
+        value_is_a_int || value_is_a_float || value_is_a_time_string
+      end
+
+      def value_is_a_int
+        @value.is_a? Integer
+      end
+
+      def value_is_a_float
+        @value.is_a? Float
+      end
+
+      def value_is_a_time_string
+        @value.scan(/\d{2}:\d{2}:\d{2}/).first || @value.scan(/\d{2}:\d{2}/).first
+      end
+
+    end
+  end
+end

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum/format_data.rb

@@ -0,0 +1,27 @@
+
+# require "eitil_integrate/application_exporter/auto_sum/format_data"
+
+module EitilIntegrate::RubyXL
+  module AutoSum
+    class << self
+
+      def format_data
+        format_time_strings
+        format_ints_to_floats
+      end
+
+      def format_time_strings
+        @hash.transform_values! { |array| array.map { |item| incomplete_time_string?(item) ? "#{item}:00" : item } }
+      end
+
+      def incomplete_time_string?(string)
+        string.is_a?(String) && string.length == 5 && string.scan(/\d{2}:\d{2}/)
+      end
+
+      def format_ints_to_floats
+        @hash.transform_values! { |array| array.map { |item| item.is_a?(Integer) ? item.to_f : item } }
+      end   
+
+    end
+  end
+end

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum/initialize.rb

@@ -0,0 +1,22 @@
+
+# require "eitil_integrate/application_exporter/auto_sum/initialize"
+
+module EitilIntegrate::RubyXL
+  module AutoSum
+    class << self
+
+      def perform(hashed_excel)
+        @hash = hashed_excel
+        
+        drop_data
+        format_data
+        reduce_data
+        sum_data
+        present_data
+
+        @hash
+      end
+
+    end
+  end
+end

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum/present_data.rb

@@ -0,0 +1,31 @@
+
+# require "eitil_integrate/application_exporter/auto_sum/present_data"
+
+module EitilIntegrate::RubyXL
+  module AutoSum
+    class << self
+
+      # As final step, prepare the data for the excel file, according to formatting requirements.
+
+      def present_data
+        transform_floats_to_integers
+        transform_values_to_strings
+        set_title
+      end
+
+      def transform_floats_to_integers
+        @hash.transform_values! { |value| value.is_a?(Float) ? value.safe_to_i.round(3) : value }
+      end
+
+      def transform_values_to_strings
+        @hash.transform_values! { |value| value&.to_s }
+      end
+
+      def set_title
+        # @hash[0] = 'Totaal' unless @hash[0]
+        @hash[0] = 'Totaal'
+      end
+
+    end
+  end
+end

data/eitil_integrate/lib/eitil_integrate/application_exporter/auto_sum/reduce_data.rb

@@ -0,0 +1,18 @@
+
+# require "eitil_integrate/application_exporter/auto_sum/reduce_data"
+
+module EitilIntegrate::RubyXL
+  module AutoSum
+    class << self
+
+      def reduce_data
+        drop_multi_class_arrays
+      end
+
+      def drop_multi_class_arrays
+        @hash.transform_values! { |array| array.map(&:class).uniq.length == 1 ? array : [] }
+      end
+
+    end
+  end
+end