quickery 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20c5125563b48a48ba73907330199cf2b7d330e0e78bc3449db1ba92f29783aa
-  data.tar.gz: 047cc01e20747481b825ca1d4f26dfe34ba4ab31429a005be4b8767cf51b6e12
+  metadata.gz: 06ee53003d29d3dfa2bf9cd981c5d6f154bb49a8a07538d846acff0b30adb52d
+  data.tar.gz: 2bf0d7a7e35f9d46ec2fabeacd11f36479f4165c1110b8e75d3336e91329d5f9
 SHA512:
-  metadata.gz: 7cdc80db27ccdbe249a2592bc0e537cd0cf4a8c2146afcc0a306ffadd01cb7a76e1181492d6e44795bd94862c23d7e1aadbaf42e19962f99f1ee4b2985ebdb21
-  data.tar.gz: 72f951760cd8737b117d1f11865cb2cc4c6b4ba5c427d86dcdffa704a2025d51432d45c69b0226eb0b2c42c20dd241ab93909dc8a83d8b4d51e8113db4eaeed8
+  metadata.gz: 290d4b4ba0ee7b2f239619231c07ceb848a79d3b858b0b03287644459a67ed5ae826e426b6b291debee23afecaca4221434df1c21fda53bb8d662791f8afda0e
+  data.tar.gz: 1c3b3f6b7817550bf272e342b88c70964ff8955f9bc73fe81e6c234f0036c19d4ed8278cf6b0ec45346d8dee010842060b51d3e17c8593a753ffb6943dc1fc35

data/README.md

@@ -185,7 +185,7 @@ end
 ```
 
 ## Gotchas
-* Quickery makes use of Rails model callbacks such as `before_save`. This meant that data-integrity holds unless `update_columns` or `update_column` is used which bypasses model callbacks, or unless any manual SQL update is performed.
+* Quickery makes use of Rails model callbacks such as `before_update`. This meant that data-integrity holds unless `update_columns` or `update_column` is used which bypasses model callbacks, or unless any manual SQL update is performed.
 * Quickery does not automatically update old records existing in the database that were created before you integrate Quickery, or before you add new/more Quickery-attributes for that model. One solution is [`recreate_quickery_cache!`](#recreate_quickery_cache) below.
 
 ## DSL
@@ -203,7 +203,6 @@ end
     * `{ branch: { name: :branch_name, id: :branch_id }` will create two `Quickery::QuickeryBuilder`
         * In this particular example, you are required to specify `belongs_to :branch` in this model
         * Similarly, you are required to specify `belongs_to :company` inside `Branch` model, `belongs_to :country` inside `Company` model; etc...
-* defines a set of "hidden" Quickery `before_save`, `before_update`, `before_destroy`, and `before_create` callbacks across all models specified in the quickery-defined attribute association chain.
 * quickery-defined attributes such as say `:branch_company_country_category_name` are updated by Quickery automatically whenever any of it's dependent records across models have been changed. Note that updates in this way do not trigger model callbacks, as I wanted to isolate logic and scope of Quickery by not triggering model callbacks that you already have.
 * quickery-defined attributes such as say `:branch_company_country_category_name` are READ-only! Do not update these attributes manually. You can, but it will not automatically update the other end, and thus will break data integrity. If you want to re-update these attributes to match the other end, see `recreate_quickery_cache!` below.
 
@@ -235,6 +234,16 @@ end
     # => 'Ireland'
     ```
 
+##### `determine_quickery_values`
+* returns a Hash of all quickery-defined attributes mapped to the current "actual" supposed values
+* i.e. you can do something like the following:
+
+    ```ruby
+    employee = Employee.first
+    puts employee.determine_quickery_values
+    # => { branch_company_country_id: 1, branch_compnay_country_name: 'Ireland' }
+    ```
+
 ## TODOs
 * Possibly support two-way mapping of attributes? So that you can do, say... `employee.update!(branch_company_name: 'somenewcompanyname')`
 * Support `has_many` as currently only `belongs_to` is supported. This would then allow us to cache Array of values.
@@ -264,6 +273,9 @@ See [my detailed comparisons](other_similar_gems_comparison.md)
 5. Create new Pull Request
 
 ## Changelog
+* 1.1.0
+  * added helper method [`determine_quickery_values`](#determine_quickery_values)
+  * fixed `recreate_quickery_cache!` raising `NilClass` error when the immediate association is nil
 * 1.0.0
   * Done (TODO): DSL changed from quickery (block) into quickery (hash). Thanks to @xire28 and @sshaw_ in my [reddit post](https://www.reddit.com/r/ruby/comments/9dlcc5/i_just_published_a_new_gem_quickery_an/) for the suggestion.
   * Done (TODO): Now updates in one go, instead of updating record per quickery-attribute, thereby greatly improving speed.

data/lib/quickery/active_record_extensions/dsl.rb

@@ -12,6 +12,7 @@ module Quickery
         attr_accessor :quickery_association_chain_dependers
         attr_accessor :quickery_association_chain_dependees
         attr_accessor :quickery_association_chain_intermediaries
+        attr_accessor :quickery_builders
 
         def quickery(mappings)
           mappings_builder = MappingsBuilder.new(model: self, mappings: mappings.with_indifferent_access)
@@ -33,7 +34,15 @@ module Quickery
           raise ArgumentError, "No defined quickery builder for #{depender_column_name}. Defined values are #{self.class.quickery_builders.keys}" unless quickery_builder
 
           dependee_record = quickery_builder.association_chains.first.dependee_record(self)
-          dependee_record.send(quickery_builder.dependee_column_name)
+          dependee_record.public_send(quickery_builder.dependee_column_name) if dependee_record
+        end
+
+        def determine_quickery_values
+          quickery_values = {}
+          self.class.quickery_builders.each do |depender_column_name, quickery_builder|
+            quickery_values[depender_column_name] = determine_quickery_value(depender_column_name)
+          end
+          quickery_values
         end
       end
     end

data/lib/quickery/association_chain.rb

@@ -79,7 +79,7 @@ module Quickery
 
       child_association_chains(include_self: true).inject(from_record) do |from_record, association_chain|
         if association_chain.belongs_to
-          from_record.send(association_chain.belongs_to.name)
+          from_record.send(association_chain.belongs_to.name) if from_record
         else
           from_record
         end

data/lib/quickery/quickery_builder.rb

@@ -13,8 +13,7 @@ module Quickery
     end
 
     def add_to_model
-      define_quickery_builders_in_model_class unless @model.respond_to? :quickery_builders
-      # include this to the list of quickery builders defined for this model
+      @model.quickery_builders ||= {}
       @model.quickery_builders[depender_column_name] = self
     end
 
@@ -28,18 +27,5 @@ module Quickery
       @callbacks_builder = CallbacksBuilder.new(quickery_builder: self)
       @callbacks_builder.build_callbacks
     end
-
-    private
-
-    def define_quickery_builders_in_model_class
-      # set default empty Hash if first time setting quickery_builders
-      @model.class_eval do
-        @quickery_builders = {}
-
-        class << self
-          attr_reader :quickery_builders
-        end
-      end
-    end
   end
 end

data/lib/quickery/version.rb

@@ -1,3 +1,3 @@
 module Quickery
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quickery
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Jules Roman Polidario
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-10-31 00:00:00.000000000 Z
+date: 2018-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties