eitil 1.1.39 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8baf9893cc66d802a9cfa257b9f7e9d9773454837b397684e2b30c188400d2b
-  data.tar.gz: c0f9b000df38b13078bfdc5b348f5e6e5f4732bfabfa96c0d972bd764134e069
+  metadata.gz: 252b7b936a8660cdb93a57240420fcdc07daef6dde073234b24876b2e7561ff7
+  data.tar.gz: 493bf9edf78fcbadedce713da8a1e950fd29fe6435749ce7290d93ff106e6083
 SHA512:
-  metadata.gz: 3207e89a489f0f5fca78f2647ef1624b476e2b410a0c7fd5a8b67aa13f4db8bc9f7985a54622af6039bd92ba3b713195d8f218af7fe6d8a35dc48dc5844e5e88
-  data.tar.gz: 68368b42bd8a8cf2b9b93c19d070dbefa378d73377012959d189d57a45c03c99b85f608bbfd0dc680cee9fee8e7ed090a8b51301500b666651da8e3851fa9d4f
+  metadata.gz: f5df34c162f68e7678e8a28fce0b2eb69e4c2a8abed637f80dd6db3bf614738166f3216e4db524e55daddd8c0c0b966748306c6438a3cb4c9cf1f087b951537b
+  data.tar.gz: 1f7f4a60c35e4040b3e0299f76fedc3130f96f9eb76abddc894837d20339c05e67ea4dfff02bcd80ea2f3eec945b982e323d8712307d219fcf7988096339b45b

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/eitil_core/lib/eitil_core/argument_helpers/args_to_h.rb

@@ -6,7 +6,7 @@ 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?('_') }
+              .reject { |lvar| lvar.to_s.start_with?('_') }
               .map    { |lvar| { "#{lvar}": local_binding.local_variable_get(lvar) } }
               .inject &:merge
 

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

@@ -8,7 +8,7 @@ Kernel.module_eval do
 
   def args_to_h!(*local_vars)
 
-    local_vars.reject { |lvar| lvar.to_s.starts_with?('_') }
+    local_vars.reject { |lvar| lvar.to_s.start_with?('_') }
               .map    { |lvar| { "#{lvar}": binding.of_caller(2).local_variable_get(lvar) } }
               .inject &:merge
 

data/lib/eitil/railtie.rb

@@ -5,7 +5,7 @@
 
 module Eitil
   
-  Root   = Gem.loaded_specs['eitil'].full_gem_path
+  Root   = Gem.loaded_specs['eitil']&.full_gem_path
   Layers = %w( eitil_core eitil_support eitil_wrapper eitil_store eitil_integrate )
   ApplicationRecordModules = []
 

data/lib/eitil/version.rb

@@ -1,5 +1,5 @@
 module Eitil
   
-  VERSION = '1.1.39'
+  VERSION = '1.2.3'
   
 end

data/spec/eitil_core/argument_helpers/all_args_to_ivars_bang_spec.rb

@@ -0,0 +1,19 @@
+
+RSpec.describe "Kernel#all_args_to_ivars!" do
+
+  it "should set all positional arguments as instance variables" do
+    
+    def test_method(a, b, c)
+      all_args_to_ivars!
+    end
+
+    test_method(1, "two", :three)
+
+    expect(@a).to eq 1
+    expect(@b).to eq "two"
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+  
+end

data/spec/eitil_core/argument_helpers/all_args_to_ivars_spec.rb

@@ -0,0 +1,19 @@
+
+RSpec.describe "Kernel#all_args_to_ivars" do
+
+  it "should set all positional arguments as instance variables" do
+    
+    def test_method(a, b, c)
+      all_args_to_ivars binding
+    end
+
+    test_method(1, "two", :three)
+
+    expect(@a).to eq 1
+    expect(@b).to eq "two"
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+  
+end

data/spec/eitil_core/argument_helpers/all_kwargs_to_ivars_bang_spec.rb

@@ -0,0 +1,34 @@
+
+RSpec.describe "Kernel#all_kwargs_to_ivars!" do
+
+  it "should set all hash keys, nested within a positional hash, to instance variables" do
+  
+    def test_method(a, b, c, kwargs)
+      all_kwargs_to_ivars! :kwargs
+    end
+
+    test_method(1, "two", :three, {a: 0, b: "not_two", c: :not_three})
+
+    expect(@a).to eq 0
+    expect(@b).to eq "not_two"
+    expect(@c).to eq :not_three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set all hash keys, nested within a keyword hash, to instance variables" do
+  
+    def test_method(a, b, c, kwargs:)
+      all_kwargs_to_ivars! :kwargs
+    end
+
+    test_method(1, "two", :three, kwargs: {a: 0, b: "not_two", c: :not_three})
+
+    expect(@a).to eq 0
+    expect(@b).to eq "not_two"
+    expect(@c).to eq :not_three
+    expect(@d).to be_nil
+
+  end
+  
+end

data/spec/eitil_core/argument_helpers/all_kwargs_to_ivars_spec.rb

@@ -0,0 +1,34 @@
+
+RSpec.describe "Kernel#all_kwargs_to_ivars" do
+
+  it "should set all hash keys, nested within a positional hash, to instance variables" do
+  
+    def test_method(a, b, c, kwargs)
+      all_kwargs_to_ivars binding, :kwargs
+    end
+
+    test_method(1, "two", :three, {a: 0, b: "not_two", c: :not_three})
+
+    expect(@a).to eq 0
+    expect(@b).to eq "not_two"
+    expect(@c).to eq :not_three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set all hash keys, nested within a keyword hash, to instance variables" do
+  
+    def test_method(a, b, c, kwargs:)
+      all_kwargs_to_ivars binding, :kwargs
+    end
+
+    test_method(1, "two", :three, kwargs: {a: 0, b: "not_two", c: :not_three})
+
+    expect(@a).to eq 0
+    expect(@b).to eq "not_two"
+    expect(@c).to eq :not_three
+    expect(@d).to be_nil
+
+  end
+  
+end

data/spec/eitil_core/argument_helpers/args_to_h_bang_spec.rb

@@ -0,0 +1,16 @@
+
+RSpec.describe "Kernel#args_to_h!" do
+
+  it "should create an hash, with the local variables as key / value pairs" do
+
+    a = 1
+    b = "two"
+    c = :three
+
+    created_hash  = args_to_h! :a, :c
+    expected_hash = {a: 1, c: :three}    
+
+    expect(created_hash).to eq expected_hash
+
+  end
+end

data/spec/eitil_core/argument_helpers/args_to_h_spec.rb

@@ -0,0 +1,16 @@
+
+RSpec.describe "Kernel#args_to_h" do
+
+  it "should create an hash, with the local variables as key / value pairs" do
+
+    a = 1
+    b = "two"
+    c = :three
+
+    created_hash  = args_to_h(binding, :a, :c)
+    expected_hash = {a: 1, c: :three}    
+
+    expect(created_hash).to eq expected_hash
+
+  end
+end

data/spec/eitil_core/argument_helpers/args_to_ivars_bang_spec.rb

@@ -0,0 +1,49 @@
+
+RSpec.describe "Kernel#args_to_ivars!" do
+
+  it "should set the given positional arguments to instance variables" do
+
+    def test_method(a, b, c)
+      args_to_ivars! :a, :c
+    end
+
+    test_method(1, "two", :three)
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set the given keyword arguments to instance variables" do
+
+    def test_method(a:, b:, c:)
+      args_to_ivars! :a, :c
+    end
+
+    test_method(a: 1, b: "two", c: :three)
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set the given local variables to instance variables" do
+
+    a = 1
+    b = "two"
+    c = :three
+
+    args_to_ivars! :a, :c
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+end

data/spec/eitil_core/argument_helpers/args_to_ivars_spec.rb

@@ -0,0 +1,49 @@
+
+RSpec.describe "Kernel#args_to_ivars" do
+
+  it "should set the given positional arguments to instance variables" do
+
+    def test_method(a, b, c)
+      args_to_ivars binding, :a, :c
+    end
+
+    test_method(1, "two", :three)
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set the given keyword arguments to instance variables" do
+
+    def test_method(a:, b:, c:)
+      args_to_ivars binding, :a, :c
+    end
+
+    test_method(a: 1, b: "two", c: :three)
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+  it "should set the given local variables to instance variables" do
+
+    a = 1
+    b = "two"
+    c = :three
+
+    args_to_ivars binding, :a, :c
+
+    expect(@a).to eq 1
+    expect(@b).to be_nil
+    expect(@c).to eq :three
+    expect(@d).to be_nil
+
+  end
+
+end

data/spec/eitil_core/array/map_strings_spec.rb

@@ -0,0 +1,24 @@
+
+RSpec.describe "Array#map_strings" do
+
+  it "should transforms all strings in infinite recursion" do
+
+    array  = ["hey", ["hi", {a: "ho", b: {d: "he"}}]]
+    result = array.map_strings { |str| str.upcase }
+
+    expect(result).to eq ["HEY", ["HI", {a: "HO", b: {d: "HE"}}]]
+
+  end
+end
+
+RSpec.describe "Array#map_strings!" do
+
+  it "should transforms all strings in infinite recursion" do
+
+    array  = ["hey", ["hi", {a: "ho", b: {d: "he"}}]]
+    array.map_strings! { |str| str.upcase }
+
+    expect(array).to eq ["HEY", ["HI", {a: "HO", b: {d: "HE"}}]]
+
+  end
+end

data/spec/eitil_core/array/slice_hashes_spec.rb

@@ -0,0 +1,13 @@
+
+RSpec.describe "Array#slice_hashes" do
+
+  it "should slice each hash in an array of hashes with the given keys" do
+
+    array    = [{"a"=>1, "b"=>2, "c"=>3}, {"a"=>1, "b"=>2, "c"=>3}]
+    result   = array.slice_hashes("a", "b")
+    expected = [{"a"=>1, "b"=>2}, {"a"=>1, "b"=>2}]
+
+    expect(result).to eq expected
+
+  end
+end

data/spec/eitil_core/datetime/prettify_spec.rb

@@ -0,0 +1,11 @@
+
+RSpec.describe "DateTime#prettify" do
+
+  it "should represent a DateTime instance in the '%Y-%m-%d.%H:%M:%S' format" do
+
+    datetime = DateTime.parse("01-01-2020, 10:00:00, +0200")
+    
+    expect(datetime.prettify).to eq "2020-01-01.10:00:00"
+
+  end
+end

data/spec/eitil_core/errors/raise_error_spec.rb

@@ -0,0 +1,33 @@
+
+RSpec.describe "Kernel#raise_error" do
+
+  # Call specs directly on Kernel, which you would usually do implicit
+  # instead of explicit, in order to escape the RSpec namespace, which has
+  # it's own effects for raised errors
+
+  it "should define a new constant, if the error class does not yet exist" do
+    
+    begin
+      Kernel.raise_error "ThisErrorWillProbablyNotExistError"
+    rescue
+    end
+
+    expect(Kernel.const_defined?('ThisErrorWillProbablyNotExistError')).to eq true
+
+  end
+
+  it "should call an existing constant, if the error class already exists" do
+    
+    expect(Kernel.const_defined?('StandardError'))
+    initial_const_count = Module.constants.count
+
+    begin
+      Kernel.raise_error "StandardError"
+    rescue
+    end
+
+    expect(Module.constants.count).to eq initial_const_count
+
+  end
+
+end

data/spec/eitil_core/float/safe_to_i_spec.rb

@@ -0,0 +1,24 @@
+
+RSpec.describe "Float#safe_to_i" do
+
+  it "should convert a float to an integer, if the float is rounded (e.g. 7.0)" do
+
+    float  = 7.0
+    result = float.safe_to_i
+
+    expect(result).to eq 7
+    expect(result).to be_a Integer
+
+  end
+
+    it "should not convert a float to an integer, if the float is not rounded (e.g. 7.1)" do
+
+    float  = 7.1
+    result = float.safe_to_i
+
+    expect(result).to eq 7.1
+    expect(result).to be_a Float
+
+  end
+
+end

data/spec/eitil_core/formatters/duck_set_spec.rb

@@ -0,0 +1,139 @@
+
+RSpec.describe "Date.duck_set(object)" do
+
+  let(:date) { Date.duck_set(@object) }
+
+  it "should return the object, if the object is a Date instance" do
+    @object = Date.today
+    expect(date).to eq @object
+    expect(date).to be_a Date
+  end
+
+  it "should return a Date instance, if the object is a String instance" do
+    @object = "2020-01-01"
+    expect(@object).to be_a String 
+    expect(date).to    be_a Date
+  end
+
+
+  it "should return a Date instance, if the object is a DateTime instance" do
+    @object = DateTime.now
+    expect(@object).to be_a DateTime 
+    expect(date).to    be_a Date
+  end
+
+
+  it "should return a Date instance, if the object is a Time instance" do
+    @object = Time.now
+    expect(@object).to be_a Time 
+    expect(date).to    be_a Date
+  end
+
+
+  it "should raise an error, if the object's class is not one of: String, Date, DateTime, Time" do
+    @object = 2020
+    expect(@object).to be_a Integer   
+    begin
+      error_raised = false
+      date
+    rescue
+      error_raised = true
+    end
+    expect(error_raised).to eq true
+  end
+
+end
+
+
+RSpec.describe "DateTime.duck_set(object)" do
+
+  let(:datetime) { DateTime.duck_set(@object) }
+
+  it "should return the object, if the object is a DateTime instance" do
+    @object = DateTime.now
+    expect(datetime).to eq @object
+    expect(datetime).to be_a DateTime
+  end
+
+  it "should return a DateTime instance, if the object is a String instance" do
+    @object = "2020-01-01"
+    expect(@object).to  be_a String 
+    expect(datetime).to be_a DateTime
+  end
+
+
+  it "should return a DateTime instance, if the object is a Date instance" do
+    @object = Date.today
+    expect(@object).to  be_a Date 
+    expect(datetime).to be_a DateTime
+  end
+
+
+  it "should return a DateTime instance, if the object is a Time instance" do
+    @object = Time.now
+    expect(@object).to  be_a Time 
+    expect(datetime).to be_a DateTime
+  end
+
+
+  it "should raise an error, if the object's class is not one of: String, DateTime, Date, Time" do
+    @object = 2020
+    expect(@object).to be_a Integer   
+    begin
+      error_raised = false
+      datetime
+    rescue
+      error_raised = true
+    end
+    expect(error_raised).to eq true
+  end
+
+end
+
+
+
+RSpec.describe "Time.duck_set(object)" do
+
+  let(:time) { Time.duck_set(@object) }
+
+  it "should return the object, if the object is a Time instance" do
+    @object = Time.now
+    expect(time).to eq @object
+    expect(time).to be_a Time
+  end
+
+  it "should return a Time instance, if the object is a String instance" do
+    @object = "20:00"
+    expect(@object).to be_a String 
+    expect(time).to    be_a Time
+  end
+
+
+  it "should return a Time instance, if the object is a Date instance" do
+    @object = Date.today
+    expect(@object).to be_a Date 
+    expect(time).to    be_a Time
+  end
+
+
+  it "should return a Time instance, if the object is a DateTime instance" do
+    @object = DateTime.now
+    expect(@object).to be_a DateTime 
+    expect(time).to    be_a Time
+  end
+
+
+  it "should raise an error, if the object's class is not one of: String, DateTime, Date, Time" do
+    @object = 2020
+    expect(@object).to be_a Integer   
+    begin
+      error_raised = false
+      time
+    rescue
+      error_raised = true
+    end
+    expect(error_raised).to eq true
+  end
+
+end
+

data/spec/eitil_core/formatters/sql_spec.rb

@@ -0,0 +1,90 @@
+
+RSpec.describe "Date#strfsql(type)" do
+
+  let(:date) { Date.parse('01-01-2020').strfsql(@type) }
+
+  it "should by default format a Date instance to '%Y-%m-%d'" do   
+    date = Date.parse('01-01-2020').strfsql 
+    expect(date).to eq '2020-01-01'
+  end
+
+  it "should format a Date instance to '%Y-%m-%d', if :date is given as type" do   
+    @type = :date
+    expect(date).to eq '2020-01-01'
+  end
+
+  it "should simply return nil if an invalid type is given" do
+    @type = 666
+    expect(date).to be_nil
+  end
+
+end
+
+
+RSpec.describe "DateTime#strfsql(type)" do
+
+  let(:datetime) { DateTime.parse('01-01-2020').strfsql(@type) }
+
+  it "should by default format a DateTime instance to '%Y-%m-%d %H:%M:%S.%6N'" do   
+    datetime = DateTime.parse('01-01-2020').strfsql
+    expect(datetime).to eq "2020-01-01 00:00:00.000000"
+  end
+
+  it "should format a DateTime instance to '%Y-%m-%d %H:%M:%S.%6N', if :datetime is given as type" do   
+    @type = :datetime
+    expect(datetime).to eq "2020-01-01 00:00:00.000000"
+  end
+
+
+  it "should format a DateTime instance to '%Y-%m-%d', if :date is given as type" do   
+    @type = :date
+    expect(datetime).to eq "2020-01-01"
+  end
+
+
+  it "should format a DateTime instance to '%H:%M:%S', if :time is given as type" do   
+    @type = :time
+    expect(datetime).to eq "00:00:00"
+  end
+
+  it "should simply return nil if an invalid type is given" do
+    @type = 666
+    expect(datetime).to be_nil
+  end
+
+end
+
+
+
+RSpec.describe "Time#strfsql(type)" do
+
+  let(:time) { Time.parse('01-01-2020 20:00:00 +0200').strfsql(@type) }
+
+  it "should by default format a Time instance to '%Y-%m-%d %H:%M:%S.%6N'" do   
+    time = Time.parse('01-01-2020 20:00:00 +0200').strfsql
+    expect(time).to eq "20:00:00"
+  end
+
+  it "should format a Time instance to '%Y-%m-%d %H:%M:%S.%6N', if :datetime is given as type" do   
+    @type = :datetime
+    expect(time).to eq "2020-01-01 20:00:00.000000"
+  end
+
+
+  it "should format a Time instance to '%Y-%m-%d', if :date is given as type" do   
+    @type = :date
+    expect(time).to eq "2020-01-01"
+  end
+
+
+  it "should format a Time instance to '%H:%M:%S', if :time is given as type" do   
+    @type = :time
+    expect(time).to eq "20:00:00"
+  end
+
+  it "should simply return nil if an invalid type is given" do
+    @type = 666
+    expect(time).to be_nil
+  end
+
+end

data/spec/eitil_core/hash/auto_dig_spec.rb

@@ -0,0 +1,17 @@
+
+RSpec.describe "Hash#auto_dig" do
+
+  it "should recursively find the value for the given hash key" do
+    hash   = {a: 1, b: {c: 2, d: {e: 3}}}
+    result = hash.auto_dig :e
+    expect(result).to eq 3
+  end
+
+
+  it "should return nil if the given hash key is not present" do
+    hash   = {a: 1, b: {c: 2, d: {e: 3}}}
+    result = hash.auto_dig :f
+    expect(result).to be_nil
+  end
+  
+end

data/spec/eitil_core/hash/transform_string_values_spec.rb

@@ -0,0 +1,25 @@
+
+RSpec.describe "Hash#transform_string_values" do
+
+  it "should transforms all strings in infinite recursion" do
+    hash     = {a: "hey", b: {c: "hi", d: ["ho"]}}
+    expected = {a: "HEY", b: {c: "HI", d: ["HO"]}}
+    result   = hash.transform_string_values { |str| str.upcase }
+
+    expect(result).to eq expected
+  end
+
+end
+
+
+RSpec.describe "Hash#transform_string_values!" do
+
+  it "should transforms all strings in infinite recursion" do
+    hash     = {a: "hey", b: {c: "hi", d: ["ho"]}}
+    expected = {a: "HEY", b: {c: "HI", d: ["HO"]}}
+
+    hash.transform_string_values! { |str| str.upcase }
+    expect(hash).to eq expected
+  end
+  
+end

data/spec/eitil_core/safe_executions/safe_call.rb

@@ -0,0 +1,23 @@
+
+# For some reason, the Kernel patches – which ruby mixes into Object – are not
+# available to the tests, therefore load the file manually.
+load (Eitil::Root + "/eitil_core/lib/eitil_core/safe_executions/safe_call.rb")
+
+RSpec.describe "Object#safe_call" do
+
+  it "should return the block's yield value, if no error is raised" do
+    result = Object.new.safe_call { 1 + 1 }
+    expect(result).to eq 2
+  end
+
+  it "should by default return nil, if an error is raised" do
+    result = Object.new.safe_call { raise(StandardError) }
+    expect(result).to be_nil
+  end
+
+  it "should return the specified :return_value, if an error is raised" do
+    result = Object.new.safe_call(return_value: :something_else) { raise(StandardError) }
+    expect(result).to eq :something_else
+  end
+
+end

data/spec/eitil_core/safe_executions/safe_send.rb

@@ -0,0 +1,25 @@
+
+# For some reason, the Kernel patches – which ruby mixes into string – are not
+# available to the tests, therefore load the file manually.
+load (Eitil::Root + "/eitil_core/lib/eitil_core/safe_executions/safe_send.rb")
+
+RSpec.describe "Object#safe_send" do
+
+  let(:string) { "Hiya, Cowboy!" }
+
+  it "should return the method's return value, if no error is raised" do 
+    result = string.safe_send(:upcase)
+    expect(result).to eq "HIYA, COWBOY!"
+  end
+
+  it "should by default return nil, if an error is raised" do
+    result = string.safe_send(:this_method_does_probably_not_exist)
+    expect(result).to be_nil
+  end
+
+  it "should return the specified :return_value, if an error is raised" do
+    result = string.safe_send(:this_method_does_probably_not_exist, return_value: :something_else)
+    expect(result).to eq :something_else
+  end
+
+end

data/spec/eitil_core/setters/set_ivars_spec.rb

@@ -0,0 +1,28 @@
+
+RSpec.describe "Object#set_ivars" do
+
+  def set_ivar_one
+    :one
+  end
+
+  def set_ivar_two
+    2
+  end
+
+  it 'should call a method .set_#{ivar_name}, for every :ivar_name passed' do 
+    set_ivars :ivar_one, :ivar_two
+    expect(@ivar_one).to eq :one
+    expect(@ivar_two).to eq 2
+  end
+
+  it "should return an array of symbols, which the names of all ivars being set" do 
+    return_value = set_ivars :ivar_one, :ivar_two
+    expect(return_value).to eq [:ivar_one, :ivar_two]
+  end
+
+  it "should return an empty array, if no arguments are passed" do 
+    expect(set_ivars).to eq []
+  end
+
+
+end

data/spec/eitil_core/string/strip_base64_header_spec.rb

@@ -0,0 +1,22 @@
+
+RSpec.describe "String#strip_base64_header" do
+
+  let(:regex)         { EitilStore::Regex::LeadingBase64Data }
+  let(:b64_string)    { "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAADICAYAAAAeGRPoAAAgAElEQVR4Xu2dC8w0VXnH/8dLrfWKFbxHUYIGNICKVRuDWmxtWgumQoqXAKmIoSoUi6JNhS8mVnvhUm8VtYKp1UJbQIz3RDCNxIgCVrxQyk1Co2gBxVYRPc3/vGeGmX333Z3dnZmd3f2d5M33vbsz5/I7833/ec55zvMEzV3ie7ZuDcfNXQU3QgACEIAABCDQCoEwXy3xlZLen+89RgofmK8e7oIABCAAAQhAoA0C8wr6gyXdmjuwmxRua6Mz1AEBCEAAAhCAwHwE5hT0+RrjLghAAAIQgAAEuiGAoHfDlVohMCcBfFPmBMdtENh4Agj6xj8CABgOAXxThjMX9AQCq0cAQV+9OaPHa0sg4puytnPLwCDQPQEEvXvGtAABCEAAAhDonACC3jliGoAABCAAAQh0TwBB754xLUAAAhCAAAQ6J4Cgd46YBiAAAQhAAALdE0DQu2dMCxCAAAQgAIHOCSDonSOmAQhAAAIQgED3BBD07hnTAgQgAAEIQKBzAgh654hpAAIQgAAEINA9AQS9e8a0AAEIQAACEOicAILeOWIagAAEIAABCHRPAEHvnjEtQAACEIAABDongKB3jpgGlkcgHinpYincsLw+0DIEIACBfggg6P1wppVeCaQkJ1dL2l3StVJ4Qq/N0xgEIACBJRBA0JcAnSa7JhCvk/S43Mp3pPCkrlukfghAAALLJoCgL3sGaL9lAvFcSYflSn8m6UlSuL7lRqgOAhCAwOAIIOiDmxI6ND+B+HZJb8z33yXpt6Xwhfnr404IQAACq0MAQV+duaKnEwnEkyT9VeWSF0vhAqBBAAIQ2BQCCPqmzPRajzM+R9IXK0PcJYVT13rIDA4CEIDACAEEnUdixQnEp0r6kqT75IH8kxRetuKDovsQgAAEZiaAoM+MjBuGRSD+SNIDcp8uk8KBw+ofvYEABCDQDwEEvR/OtNI6gXTW/PLK8bQfSuGhrTdDhRCAAARWhACCviITRTdHCcTPS/qt/Okdkp7C8TSeEghAYJMJIOibPPsrO/Zoh7dTKt0/QApXrOxw6DgEIACBFggg6C1ApIo+CcS/lHRypcUjpPCxPntAWxCAAASGSABBH+Ks0KcdCMTnSqoGinmHFKriDjkIQAACG0sAQd/YqV+1gUfHZr9U0sNzz6+Uwv6rNgr6CwEIQKArAgh6V2Spt0UCyaP9K5L2ypVeL4U9W2yAqiAAAQisPAEEfeWncBMGEL3M7uV2lzu3rPRw6yaMnDFCAAIQaEoAQW9KiuuWRCCeLumESuN/IoX3LKkzNAsBCEBgsAQQ9MFODR2T4lGSPlQhcYUUDoAMBCAAAQhsJ4Cg81QMlEA8VNL5lc7dJskZ1C4eaIfpFgQgAIGlEkDQl4qfxscTSB7t3jf3n0V5sxR8Bp0CAQhAAAJjCCDoPBYDI5A82i3m1SNpF0l6HaFdBzZVdAcCEBgUAQR9UNNBZ6SaR3sBxEvtF0AHAhCAAAR2JoCg83QMiEDNo/0Xku4p6RIpFEfWBtRXugIBCEBgWAQQ9GHNxwb3pubR/lNJv5phHC2FszcYDEOHAAQg0IgAgt4IExd1SyB6v9y5zUcL4V27BU/tEIDAGhFA0NdoMldzKMmj3WJuZziX70l6WP778zimtpqzSq8hAIH+CSDo/TOnxZJA8mi3mBfH0xyv/cD8NXvnPCkQgAAEZiCAoM8Ai0vbJhAdOMYBZFyulrR3pYUDpHBF2y1SHwQgAIF1JYCgr+vMDn5c8VRJp+Ru3iDpx5KenH8/RwoO+0qBAAQgAIGGBBD0hqC4rE0C28K6vk/SsbmF27eW4INDvVIgAAEIQKAhAQS9ISgua4tA8mh3JLjCCe5ESadVaueYWluoqQcCENgoAgj6Rk33sge7zaN9V85zflDuGcfUlj1FtA8BCKwsAQR9ZaduFTse7dFexGg/R5IDxthaLwrH1FZxWukzBCAwCAII+iCmYRM6UYvRfqEkO705Fep+efQcU9uEx4AxQgACnRFA0DtDS8V3E4gnSDo9/26PdsdmL86gY53zqEAAAhBogQCC3gJEqphEoBaj3R7s+2+lQY1ebj8S65ynBwIQgEA7BBD0djhSy1gC0Za4g8cUHu2VYDHRx9IelG/Ds50nCAIQgMCCBBD0BQFy+04Ekke7Hd6KsK6VnOZJ6KvOcLtx7pwnCQIQgMBiBBD0xfhx93jL3Ba5BbvwaP9TKZxx96XRfz8+/36hFIrwr/CEAAQgAIE5CSDoc4LjtkkEah7tZ0rBTnGVEh2jvfBuZ7mdhwkCEIBACwQQ9BYgUkVNrKdY3ynD2q2VO/bccpKjQAACEIDAIgQQ9EXoce8IgdrxtB2ivtXiuN8ghWKPHZoQgAAEILAAAQR9AXjcWrPMvQ9uj3aXK7fOmo9LsBL/QdLR+boxy/FQhQAEIACBeQgg6PNQ455Ry7yacCUHjtlpGT3eKOkxuYKTpPA34IQABCAAgcUJIOiLM9zwGlL2NFvmXjp34Bhb5nZ626HEWPmici59wzEyfAhAAAILEkDQFwS42bcnBzcnXCnE/FApOD77TmI+cv489Pz8xQsk3SGFl2/2vDF6CEBgHQn0/B/qOiLc1DElMbdlbpF2aZApreY013MylvglSc/KfX2LFN66qTPHuCEAgfUkgKCv57z2MKpoMS8CwjQ8S76MgDIpYt0HJT2/AoWjcj08ITQBAQj0SwBB75f3mrQWT5V0Sh5MQzH31dHL8Qfl+3ZJwfV0XOInJf1upZHTpXBix41SPQQgAIHeCSDovSNf9QZr2dNmFOXoADKPzQRGwsF2wSW+T9KrKjX7heL5Uqg65nXR8EidcXdJ+0i6Kn+xh6TdpXBJD43TBAQgsCEEEPQNmeh2hlkT8znOkNcyrDXYc1+k1/Htkt5YqeFmSb/ZfVS6lHjGy/xODVv4F/xc0r13GM3FUnjeIiPlXghAAAImgKDzHDQkUMuQdo4Ujmp4Y+Wy2pG1DgU9vkLSh0f691IpfHT2Pje9I3oLwglndmt6R+W6GbYt5qidWyAAgY0ggKBvxDQvOsjaWfMFsqP1IejJk/5vJd2jMupjpXDWohTG3x/fIekNC9TtvPA+j088+wUgcisEIICFzjMwlUDyErdHuwPILCDmbqhLQY8PkORVg78bGdLrpPDOqcOc6YL4EEkvkfQXkh494da7JN0rf/8DSd/Ify/2zi+SwldnapqLIQABCOxAAAudR2MKgejAMVnMLZjj4rM3hVjbQ5/RoW5SG2kF4c2SDhu56l1SeG3T3jW7Lj5D0gckPWXK9c4Hf5mk/5X0Hil8v1n9XAUBCEBgPgII+nzcNuSuMq/5hGQrs6CoHVubw6luXFvxhZLemx3RqhecLOksKVRTtc7S2cq16YXhkPzCsO+YSn4myQL+HUkXTI6WN2cXuA0CEIDAFAIIOo/IDgRKMW8xxWktsMz1UthzfvzRUd+8xF49llZUd7ikT0vhx/PVnwTc5+Xtpe4fR8UbVy6UdOrk2PXz9YC7IAABCMxKAEGfldhGXB8/lMWyJcu8gFbLhe4PZ4zYlvbzLbD2JrfojpY7Jf3O7BZyEvD98piLo2aTZvo8KfilgQIBCEBgMAQQ9MFMxVA6ko5fOYKbxdzJVlr0vk7x36tL4FP20ePTJL1I0n0l/Z+k47YCsuxYGh6FSy8GtsAt5LbyRy1wj91BaB4m6Y8qrd0k6XApXDqU2aIfEIAABAoCCDrPQoVAtOV7RjdiXlrpznjm/WiXMcvu6YXC+9QHTznTbQ9yO+w56pqjz004G18uoVvAi8Av1Zn30rlTvlrEr9hy/It2sDu3cpGjvDl/+6d4ZCAAAQgMkQCCPsRZWUqfyuVwW6f2Zp+Q03yRDm5bdndEtaslvWYrkluKsjapfE3SP0v6SHZSOz3nYX9c3QM/teMXh1EBv+Fu4U7iPSbday2IjvuyS9I/SuGaRUbOvRCAAAS6JICgd0l3ZeouBcxi52X2jsS8tNJ/KMlnuaeVOyTdX9InJN0o6bOSPiOFn0pp+f66vFye48KnoDKFiBd1+8y3Rds/XhGYsoWQXgReWjkC9xHyp0+bJr6HAASGQABBH8IsLLUPScwdOOb2LWt2muC10dnybPu4ymx9W7g/J4Xv7txamfHtW1siL4u5S2GB+/iYl/dnLNEvD793902BfyMzEuRyCEBgOQT4z2o53AfSahnS1c9BD5a5hx2rWceqHBya9f1ScDCWKSU+R9IX80U/keT9dO/9O9HJmCX0afUV39fSwv63pGdIwY5wFAhAAAKDJ4CgD36KuupgGdLVz0CHe+aj/Y9/L+nYyqfONPZ1KfzP5JGWwV28JF4cWfvPrTjq81ji2/o1mmp1t8Wi4nU1b9QLAQhAYDwBBH0jn4ylifnosTXTnyCcqZ/eE/dyuu/1jx3o9s7TNuM59p0mOzo8bDUGfMPjbxv58DBoCEBgoAQQ9IFOTHfdSs5kDlPas2XuEW3zcPeHL65b2Kl/FnFb4v5x8b6498P9Uzi+tRkLPlZ4k8q0u4ePmiEAgQ4JIOgdwh1m1SmeukWzx2X2gsRYQc/WcHLO8xE2i3gR6MVC7iA3dnDz2XBf45cRO/CNHFObl3b0WfMiqYtjv1e3A+atlPsgAAEI9E4AQe8d+TIbjLZwf03S2xZzHpt3DGMF/V2Sfr9y/txi7X46RnrliFm5suD985as6LiXJO/D54JH+7wzy30QgMDyCSDoy5+DnnqQxDyHOl3EE3yR7qZz4g4EM66MWOOjl0SHaHWM+Uuk0CTeeoOORu+bF+lVW1zCb9A0l0AAAhBomQCC3jLQYVZXivkJ7XiEzzPKZGF/VJLTnVaLz5CfPD2YTZlLvS1HOMeEL3KUOyubl/CneNrPM27ugQAEINAPAQS9H85LbCWencOfes98gTPa8w4heao7Rvy4JCiutIFHeRqD99dbyqHuZqMTvbw7j+rfpeCz7RQIQAACK0sAQV/ZqWvS8egIcAdkB7iexbx0crOQF8UhX399pOdTBD2dPy8c4fZv72x4me/d3WnJ6m8yJ1wDAQhAoBsCCHo3XAdQa2mZ97zMnoTc++TVfOWOp25vdS+7+yWjWqYJepGdbeR426KIoyPSOT2ry6OkcPOiNXI/BCAAgWUSQNCXSb+ztpOY+/iXl9nniGc+T8eS05qX1gshH+Otvi2LmRuaIOilV/yFUijOpM/TuZF7otOzfiN/eIsUnIKVAgEIQGClCSDoKz194zrft5hHW+PV/XELueOqn7F9eXwWQS+zqfkZ9VL7lCxps0xkrR+O/+7wsxQIQAACK00AQV/p6RvtfLSQ2pL1GW5b6R2VJLa2xr2MXpR87GxSu+m+W0c6tYOFXjrC5dSobQ4lOeo59arLRVL4gzZrpy4IQAACyyCAoC+DeidtlpnCWgq6Mq6TybItYqsXF+T98aYe9LEaZtV1jBH00oJu8cx5dTw1Qb9JCo/pZEqoFAIQgECPBBD0HmF311R0wBUve3cg5mWCFNdfdXQ7Jy+rXzHbuKKv369yzwHbz6CX13TkfV5L4cqS+2wTyNUQgMBACSDoA52Y5t1Ke9iOwNaimI9NkOIuXbu1RJ2W9G9r3seadezjcwfd/clouNUymlyHkdvixyW9KPcBQZ9vIrkLAhAYGAEEfWATMlt34il5H7ulfebkVV4kSBntyi5JZy/unFbujef6q4KeXiQu38oEF7zP3VGJdrB7bK78CCl8rKOGqBYCEIBAbwQQ9N5Qt91QaZkvKOZJxIt0pUWWs2pnz1zMIh8dd7nX7y+ulEJlGb+0zls+c76tD7bOXyHpw1L4RNszQ30QgAAElkEAQV8G9YXbXNQyT9HX7KVeTVVa7dWEo2eLdr5MsuKKzpFCjiRXWuc3tJd8ZdG+cj8EIACB1SGAoK/OXOWelhbuHJZ5ElMvqe+UrWxKxrM2YNUEvbJP3pd13sYYqAMCEIDA8Agg6MObkwk9KsV8RoexJJa2yHfal/bRM++Pd3h2vRhWfL2kv8m/vUUKb936e/Js9/Z51ZN+pWaHzkIAAhBYJgEEfZn0Z2p7nmX2tD9uL/idhNxHz+yx3mIUtmmDqkVpe7oUviqVn3W8dz6tb3wPAQhAYHUJIOgrMXelA1xDyzydHbeQj4t/PibGep8Q4sGSPpdb3EMKt0gxZ4ILO20F9NlB2oIABCCwkgQQ9MFP26zL7GmP2mLeg8f6PPBqecidJGVvSadJersUzpqnRu6BAAQgAIF03pcyXAKzWObJKnfEuHFWrvfInXmtx6X1najWjq05KYrjwXvfvOUELMOdVXoGAQhAoAsCCHoXVFupc5Zz5mkP2mI+ulfeIGFKK52doZL4hcpLx545SUrL6VFn6A6XQgACEFgTAgj6ICdylmX2+CpJ7xszjAuzVT5niNauwJRx578n6ds5DOyEnOhd9YN6IQABCKwXAQR9UPOZgqsU+cUbnDNPSUYuk3TfyjAGaJVXIUfvkx8j6WZJj9weLW5QE0JnIAABCKwMAQR9UFM1yzK7O14eZStG4b3yE7ZnLxvSIKPzkHtrwN72D5LU4MVlSP2nLxCAAASGSQBBH8y8lEvRMwhcGV3No/DRL5/jHtgS+yjgbfnQO0qROpiJpSMQgAAEeiGAoPeCeVoj8fx8ZnzGFKjxBZI+m2u/WgpPnNbS8r+vCfolxG1f/ozQAwhAYD0IIOhLnce0Z27vdAeAmcEyLzodHyHJ2dAOy58cLoXzljqkiY3Xgsr4SiLDDXey6BkEILBiBBD0pU5YaZkvIGzRYn5uHsZ5Ujh8qUOaLOjVFYXbpTAu+M1wu0/PIAABCAyYAIK+lMmpWeYzLrOP63B0UhVnUXN5pxRet5RhTW00fkrSC/Nl75DCyVNv4QIIQAACEGhEAEFvhKnti+LlOTraApZ5tU/xUZJuyp84a5mX73N89Lb7vkh98ceS7p9rwBluEZTcCwEIQGCEAILe6yORLHNHSnOENIdivaC95uNfS/qzXN9JUihSlLbXxEI1pcxvdv5zuVEKj12oOm6GAAQgAIEaAQS9tweiFmu9o8hopQe5Y7a/ZCs16VBKvEbSE3Jv3iqFtwylZ/QDAhCAwDoQQNB7mcUk5rZObZk/t7vAL7Vc4/Z2P1YKt/YyxImN1KxzX7nb8M/LL58aPYAABCAwCwEEfRZac10bnUnMYm7Wh3Yn5kXnal7vZ0vh6Lm63epNKd/5QbnKW6XwkFarpzIIQAACECB9arfPQLLMvWe+W7eW+egoopO1OGmLy5K9ybdZ5x+Vwku75U7tEIAABDaPABZ6Z3Nes8y9zN5zLvJa3vHTpPD6zoY6seKade4rWzimt5yR0CoEIACBIRNA0DuZnSTmtsyd+czL7D2LeTGoMj68P2jpiNwswGp7+sWNHFebBSHXQgACEGhIAEFvCKr5ZaWIWcyXYJlXe5pCwzov+oH5046863eiE30s75DKt0SHa/4gcSUEIACBmQgg6DPhmnZxuV9sEfU58wFkPktBZz4jaV9Jt0hhj2mjaOf7dOZ+1MP+Qin4PDoFAhCAAARaJoCgtwY0HpUTrQxIzGvW+jeyqF8lhSe3NuwdK6rt4RdXzZGApvue0gIEIACBdSCAoLcyi/F4SWdIGng60HidJHveO5nLq7s9ox7tNzAaDe6A7o/ttTKhVAIBCEBg5Qgg6AtPWTxF0qlbe9WrsJwcr5K0j6RLJb1JCpcsjGBbBduOqvkK9s/bB02NEIAABEoCCPpCD0M8XdIJknZJwaK+AiUFnvFLiPfUL5XCs9vvdC37212S7iXpHCl4W4ICAQhAAAIdEEDQ54JaS3+6gvvCyRP/bZKeJcnZ2V7ZXtz3sc5wpsz587meNW6CAAQg0IwAgt6MU+Wqmpgv4Wz3zB2ecEPtnPozpfDlxWsvnQNHq+L8+eJwqQECEIDAjgQQ9JkejjL9qQPH9Hyme6aOznBxPG3LetbPJR0jBXvpL1BqZ8/vyPnPb5CCnfEoEIAABCDQEQEEvTHYWi7zDjOmNe5QixcmS/0ISffZ8gkIZ85X+Y7L7WdKwb4GFAhAAAIQ6IgAgt4IbF/pTxt1pqOLogXXTn4uc2Zp23G5neNqHc0a1UIAAhAoCCDoU5+FMmOaWS05lOvUzi54QU2QnfLUPgIzRLurLbf/QNJDOa624JRwOwQgAIGGBBD0iaDKJCu3r7+YFyBqZ8gdHMaibk/4KWXbcrvDvjptLMfVpqHjewhAAAItEEDQd4RYJllx4BVnTJvBUm1hZpZaRRL1syU9SJLH7SNnTrQyoYwNJuPrV/wkwFIngsYhAAEINCaAoI9FNcQkK43ntKUL0wuNRb0I33qqFHbtXHktmExhnRMdrqXZoBoIQAAC0wgg6NsIlfvILBUr+Q94L70QdVvpttbHrFZEf2aL3uVaSY9nuX3aPz++hwAEINAeAQS9xrKMy46Yl1ySqNtSPyh/5H11n8H3n7mU2xOjTybR4dr7t0pNEIAABCYSQNDvFqUiycoKxWXv6+lODm/OJndkbnFkX72WKvUnku6Xr9tts3wP+poP2oEABCCwnQCCnpiUgoQD18R/JdtynGcLPNoLfr9865X57yuSfY7/FiAAAQisBwEEXfH8rSVkHTXdk3s9Jn2xUWwLHvMvkl5SqfM7kp4oaQWT1ixGhrshAAEILJPABgt6WkZ2ZLQXI+azPoLbPODHVUAyllmxcj0EIACBBQhssqB/QdIBOWBMg8ApC1Bey1vTC5G93gtnOY/yJkmPlkQylrWccwYFAQgMmcAGCnoSIi+z77k50d+6fASjz5ybqYsztt1bEo6FXSKnbghAAAJjCGyYoKcjWM4sZjHfHw/sNv5NRK90OAhNtbxLCq9to3bqgAAEIACBZgQ2SNDL9KdFkpUNCuXa7GGY/apt589/KekeuZ6PSzq+fl599ha4AwIQgAAEmhHYEEEvM6Z5b3fUmmxGiqvGEIj7SLoqf+Fz6kdL8jP1wPyZg8/Y231KHHjgQgACEIDAogQ2QNBLMff5aB9NwzJf9Kkp748HS/pc/vWcHHjGou7kLodUmpkzv3prHaUiCEAAAmtPYM0FPaU/tQPclVKwyFBaJRAPk3RurvLTkl64dXLA6VZrudF9iU8SOBANJwpanQMqgwAEILBFYI0FvbTMHbHsBCa8CwK1IDPXSbpVCk+7u6VtkeX81ZSsbV30kzohAAEIrD+BNRX00lnrTMS8y4c4Hifp3bmF2yUdI4Xz6i2mufAeepGJzV87g5v31rHWu5we6oYABDaKwBoKehIQL7NbzE/dqNnsfbDbvNx3yK6Wtj4s6kUaVvd0JMFL752nQQhAAAJrRWDNBD16n9znzG39OeUnpVMC2wTdaVVtfY8pYyPL+TqW4DudIyqHAAQ2hcAaCXoSc1vmJAXp9emNsdLcBEEvrhq7r27r3dY9JxB6nTsagwAE1onAmgh6EnOfgz6BM899P57RznCOwOeyrxS+Ob0HO+6rW9R9dp0CAQhAAAIzElgDQU9i7uV10p/OOPntXB4dEe5Fua4GFnppqfslwJZ5kUfdX1jMXQei3s7kUAsEILBBBFZc0Ms93BmEZINmt5eh1pbQj5DCx5o3O3Zf/buSTpSC86xTIAABCECgIYEVFvRkmft8uZfZOf7UcMLbvyy+WtJ7c71z+C8kUfdphOMrfbtT0sslfV4KzuZGgQAEIACBKQRWVNBTQBP/2EN6B69q5r4fAvEheancSVmeLoVvz9du9MvZ6SP3Hr79XPt8tXMXBCAAgXUnsIKCnpbZ7QDnPXMs87V6QuOfS3qTpPtVhuUXNgesuWathspgIAABCLRMYMUEPR4paddW/m0cp1p+FgZSXXphcyyBwnPe/XL0uTcw5wOZIroBAQgMksAKCXr6j95L7KQ/HeSj1GanaklfiopPl8KJbbZCXRCAAATWicCKCHraM/ce66FYaev0+E0ay7YodM4ltCLP66bMEeOEAASGRGAF/oNMzlJefj0DMR/So9NHX+JpW5H/ynKsFM7qo2XagAAEILBqBAYu6MkyL5baCTayak9XK/2NX5f0lFzVj6RQzdrWSgtUAgEIQGAdCAxY0JOY2zI/G8t8HR61eccQHU3ukMrde0nhv+atjfsgAAEIrCuBgQo6Yr6uD9zs44pPk3RZ5b49ecGbnSJ3QAAC609ggIKenKEcBc4e7WTfWv9ncMoIo1dpnACmKAj6xj8TAIAABMYRGJigp3CuxZ45Ys4zK6kWK/5rkp4thZ+BBgIQgAAE6gQGJOiFZR7s1U6BgMX8BZI+Imn3jGOXFBz3nQIBCEAAAiMEBiLoiDlP5jgC8YuSnpO/+bIUngknCEAAAhAYT2AAgp7E3KFcsbx4SisEosO/+qRDUV4uBVvrFAhAAAIQGENgyYKexHx/KTjZCgUCXmb/DUkflLRvBccfSuHfwAMBCEAAAjsTWKKgJzF/nBTOZoIgIKXjac6t/soRGuyb83hAAAIQaEBgSYKezpk7Njdi3mCS1v+S+AFJfzwyzqskvYZ89+s/+4wQAhBoh8ASBL0Qc13AOfN2JnF1a0mrNBdKemBlDDdtLbnjU7G680rPIQCBZRDoWdCTmPt8+cWrI+YpsMmTJD1c0q/kSTpY0i8l/TD/fkv+8yIpfFVKQuXi+PN3SfqJpP3GW5uuf9NyuyemJ0k6rvLQ+7l4I8lXlvHfAG1CAALrQKBHQU9iboG7YjhiHh+c48U74cf+korfLTj+uz/7gaSHLjjZt0rarSL+xblq83BbRfGLQfGdl5y/kr/3dRa8arAd//2KfGNYjaXp9KJz0FYUwLLcLOlfJb1JCn7xoUAAAhCAwBwEehL0FO3L4rMEyzyJtoX5sVkcC+Eu/hyH7YaKhf0tSd/LLyMWXwuQk4UcKOlGSXbmGlKpin+Roc5/xjwHT81jKfrsMfn74uWiGKO/v5ekPSQ9XtLlkvzi8y6Tr+0AAALTSURBVP38mV84ipUJ33uHFPzy46aKFYp9JD1K0s8lnTIG0nk5xO83hwSQvkAAAhBYRQI9CHoh5sFZszousRDufByutLpH2729ImJ+0Sis3dukUFi9DfsaHy1prxyy1vf4xaF6frphPdsu+4Wke85788DvszPkJ6VgQadAAAIQgEALBDoW9OgwrtdLbYt5srr9Y0vZIu6fYpm8wFKItgU6L/Wnvswo2PNSTlaq2312tlB9rtrLzYUlfEm29t3AI7dWL0rr1ycA/Lut3eq4inH7i+rnxbJ9dfl+tOO20P9D0mslXSvpHvmCcRZ6Ydl7Cdz99u/XSLLvgLcPzHZSW9W2bcXbmnfxmL1Kk8c2L1vugwAEIACBUQIdCnqyzG3xthA0JlneFhALohO43Clp78pgrszLyRXx3jRHs74f7vhESY8YeSkoltr9sUXbL1DFy0HfHaQ9CEAAAhtFoCNBjxZx/2e+gJiXDlQ5NGyaF1uGFm0fdXJKTb8wYO1t1CPLYCEAAQhAYByBDgQ9WeY+ijXjPnJaRi8s8OLeQsC9/+4fCzhpVXmWIQABCEAAAiMEWhb0lM/cVrnjszcU3nSP98L9p0Xd5cy8ZLsEr3ieEQhAAAIQgMDqEWhR0JOF7WXwo6c7waXldIu4LXHfZ0s8W+FtO9Ct3qTQYwhAAAIQgMCsBNoUdFvY528FUBm1zmvL6VVL/Jws5Fjis84c10MAAhCAAAQqBNoUdHuiO/jIHZIuqxzPKgK7uFlb4nZiK6zxhsvyzBkEIAABCEAAApMItCjobia+TNJh+Vx40a6PLVnE/TOgsK88GBCAAAQgAIH1IdCyoK8PGEYCAQhAAAIQWCUCCPoqzRZ9hQAEIAABCOxAAEHn0YAABCAAAQisAQEEfQ0mkSFAAAIQgAAEEHSeAQhAAAIQgMAaEEDQ12ASGQIEIAABCEAAQecZgAAEIAABCKwBgf8HUo6dI5/5V1kAAAAASUVORK5CYII=" }
+  let(:normal_string) { "IAmJustANormalStringDoingNormalThings" }
+  
+  it "should retrieve the Regexp LeadingBase64Data" do 
+    expect(regex).to be_a Regexp
+  end
+
+  it "should detect a base_64 string" do 
+    result = b64_string =~ regex
+    expect(result).to be_a Integer
+  end
+
+  it "should leave a normal string untouched" do 
+    result = normal_string =~ regex
+    expect(result).to be_nil
+  end
+
+end

data/spec/eitil_core/string/to_filename_spec.rb

@@ -0,0 +1,34 @@
+
+RSpec.describe "String#to_filename(substitute='_')" do
+
+  it "should substitute all spaces with, by default, lowdashes" do 
+    string = "this is a filename"
+    expect(string.to_filename).to eq "this_is_a_filename"
+  end
+
+  it "should substitute all spaces with, if given, the substitute argument" do 
+    string = "this is a filename"
+    expect(string.to_filename('-')).to eq "this-is-a-filename"
+  end
+
+  it "should substitute all slashes with, by default, lowdashes" do 
+    string = "this/is/a/filename"
+    expect(string.to_filename).to eq "this_is_a_filename"
+  end
+
+  it "should substitute all slashes with, if given, the substitute argument" do 
+    string = "this/is/a/filename"
+    expect(string.to_filename('-')).to eq "this-is-a-filename"
+  end
+
+  it "should substitute all backslashes with, by default, lowdashes" do 
+    string = 'this\is\a\filename'
+    expect(string.to_filename).to eq "this_is_a_filename"
+  end
+
+  it "should substitute all backslashes with, if given, the substitute argument" do 
+    string = 'this\is\a\filename'
+    expect(string.to_filename('-')).to eq "this-is-a-filename"
+  end
+
+end

data/spec/eitil_core/type_checkers/is_num_or_nan_spec.rb

@@ -0,0 +1,146 @@
+
+RSpec.describe "#is_num? and #is_nan?" do
+
+  context "for String" do
+
+    it "#is_num? should return true for '5' (integers)" do 
+      expect('5'.is_num?).to be_truthy
+    end
+
+    it "#is_num? should return true for '5.0' (floats) " do 
+      expect('5.0'.is_num?).to be_truthy
+    end
+
+    it "#is_num? should return true for '5,0' (floats, separated by comma) " do 
+      expect('5,0'.is_num?).to be_truthy
+    end
+
+    it "#is_num? should return false for valid values, '5a' (concatenated with additional letters)" do 
+      expect('5a'.is_num?).to   be_falsy
+      expect('5.0a'.is_num?).to be_falsy
+      expect('5,0a'.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should return the opposite" do 
+      expect('5'.is_nan?).to be_falsy
+      expect('5.0'.is_nan?).to be_falsy
+      expect('5,0'.is_nan?).to be_falsy
+      expect('5a'.is_nan?).to   be_truthy
+      expect('5.0a'.is_nan?).to be_truthy
+      expect('5,0a'.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for Numeric" do
+
+    it "#is_num? should always return true" do
+      expect(1.is_num?).to   be_truthy
+      expect(1.0.is_num?).to be_truthy
+    end
+
+    it "#is_nan? should always return false" do
+      expect(1.is_nan?).to   be_falsy
+      expect(1.0.is_nan?).to be_falsy
+    end
+
+  end
+
+  context "for NilClass" do
+
+    it "#is_num? should always return false" do
+      expect(nil.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(nil.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for TrueClass" do
+
+    it "#is_num? should always return false" do
+      expect(true.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(true.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for FalseClass" do
+
+    it "#is_num? should always return false" do
+      expect(false.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(false.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for Hash" do
+
+    it "#is_num? should always return false" do
+      expect({}.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect({}.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for Array" do
+
+    it "#is_num? should always return false" do
+      expect([].is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect([].is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for Date" do
+
+    it "#is_num? should always return false" do
+      expect(Date.today.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(Date.today.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for Time" do
+
+    it "#is_num? should always return false" do
+      expect(Time.now.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(Time.now.is_nan?).to be_truthy
+    end
+
+  end
+
+  context "for DateTime" do
+
+    it "#is_num? should always return false" do
+      expect(DateTime.now.is_num?).to be_falsy
+    end
+
+    it "#is_nan? should always return true" do
+      expect(DateTime.now.is_nan?).to be_truthy
+    end
+
+  end
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,55 @@
+
+require 'pry'
+require 'rails'
+
+require 'eitil'
+
+# Implement specs for other railties later on, start with eitil_core.
+
+require "eitil_core/railtie"
+# require "eitil_store/railtie"
+# require "eitil_integrate/railtie"
+# require "eitil_support/railtie"
+# require "eitil_wrapper/railtie"
+
+require "eitil_core"
+# require "eitil_store"
+# require "eitil_integrate"
+# require "eitil_support"
+# require "eitil_wrapper"
+
+RSpec.configure do |config|
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+end
+
+# This block is added by us: the new methods .pry_describe and .pry_it
+# automatically start a pry session after running the spec, allowing
+# you to inspect the application's post spec state.
+RSpec.configure do |config|
+
+  config.alias_example_group_to :pry_describe, pry: true
+  config.alias_example_group_to :pry_context, pry: true
+  config.alias_example_to :pry_it, pry: true
+  config.alias_example_to :pry_example, pry: true
+  config.alias_example_to :pry_specify, pry: true
+
+  config.after(:example, pry: true) do |example|
+    require 'pry'
+    binding.pry
+  end
+
+end
+
+# This is added by us, in order to set the :documentation formatter,
+# which gives quite a lot of information about the tests, as default
+RSpec.configure do |config|
+  config.formatter = :documentation
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eitil
 version: !ruby/object:Gem::Version
-  version: 1.1.39
+  version: 1.2.3
 platform: ruby
 authors:
 - Jurriaan Schrofer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-03 00:00:00.000000000 Z
+date: 2021-09-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -66,6 +66,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.0.2
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: "Eitil (eitje utility) never stops increasing your life's efficacy and
   productivity, yay!\n                      Our gem currently exists of five seperate
   layers (Railties), which can be integrated as standalone gems. \n                      This
@@ -77,6 +119,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rspec"
 - MIT-LICENSE
 - README.md
 - Rakefile
@@ -205,6 +248,30 @@ files:
 - lib/eitil/all.rb
 - lib/eitil/railtie.rb
 - lib/eitil/version.rb
+- spec/eitil_core/argument_helpers/all_args_to_ivars_bang_spec.rb
+- spec/eitil_core/argument_helpers/all_args_to_ivars_spec.rb
+- spec/eitil_core/argument_helpers/all_kwargs_to_ivars_bang_spec.rb
+- spec/eitil_core/argument_helpers/all_kwargs_to_ivars_spec.rb
+- spec/eitil_core/argument_helpers/args_to_h_bang_spec.rb
+- spec/eitil_core/argument_helpers/args_to_h_spec.rb
+- spec/eitil_core/argument_helpers/args_to_ivars_bang_spec.rb
+- spec/eitil_core/argument_helpers/args_to_ivars_spec.rb
+- spec/eitil_core/array/map_strings_spec.rb
+- spec/eitil_core/array/slice_hashes_spec.rb
+- spec/eitil_core/datetime/prettify_spec.rb
+- spec/eitil_core/errors/raise_error_spec.rb
+- spec/eitil_core/float/safe_to_i_spec.rb
+- spec/eitil_core/formatters/duck_set_spec.rb
+- spec/eitil_core/formatters/sql_spec.rb
+- spec/eitil_core/hash/auto_dig_spec.rb
+- spec/eitil_core/hash/transform_string_values_spec.rb
+- spec/eitil_core/safe_executions/safe_call.rb
+- spec/eitil_core/safe_executions/safe_send.rb
+- spec/eitil_core/setters/set_ivars_spec.rb
+- spec/eitil_core/string/strip_base64_header_spec.rb
+- spec/eitil_core/string/to_filename_spec.rb
+- spec/eitil_core/type_checkers/is_num_or_nan_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/eitje-app/eitil_engine
 licenses:
 - MIT