quickery 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3bb77d2c32c2ce80c651fd671701fd561c4ba37d8920827804bf5d092cd5085e
+  data.tar.gz: 84388c8df61f76837adfd630b9c8a0421d818d5098b4d3966a547ee8408efd04
+SHA512:
+  metadata.gz: 3f8f3efade73d92df662b8f43aaaab39af3b22390c83f3f2ff82ce292cdae737e451dbd83c1b5981d7272c5effbbb294288d823a6ea07002be3deb12277ff738
+  data.tar.gz: 1229a87bf58a64bcc2f2fe1e014bc4c96b28f07ebc537b0e73164a30c4775e515db4730c927957c133263a58097471a429bbc48d5399faed2bf546c689a4e2fa

data/.gitignore

@@ -0,0 +1,22 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+/spec/internal/log/*
+/spec/internal/tmp/*
+*.sqlite
+*.sqlite-journal
+
+# rspec failure tracking
+.rspec_status
+
+*.gem
+.byebug_history
+
+Gemfile.lock
+gemfiles/*.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,9 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5.1
+before_install:
+  - gem install bundler -v 1.16.1
+  - bundle exec appraisal install
+script:
+  - bundle exec appraisal rake

data/Appraisals

@@ -0,0 +1,7 @@
+appraise 'rails-4' do
+  gem 'rails', '4.2.10'
+end
+
+appraise 'rails-5' do
+  gem 'rails', '5.2.1'
+end

data/Gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+group :development, :test do
+  gem 'factory_bot_rails', require: false
+end
+
+# Specify your gem's dependencies in quickery.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,163 @@
+PATH
+  remote: .
+  specs:
+    quickery (0.1.0)
+      activerecord
+      activesupport
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (5.2.0)
+      actionview (= 5.2.0)
+      activesupport (= 5.2.0)
+      rack (~> 2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.2.0)
+      activesupport (= 5.2.0)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activemodel (5.2.0)
+      activesupport (= 5.2.0)
+    activerecord (5.2.0)
+      activemodel (= 5.2.0)
+      activesupport (= 5.2.0)
+      arel (>= 9.0)
+    activesupport (5.2.0)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    appraisal (2.2.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    arel (9.0.0)
+    builder (3.2.3)
+    byebug (9.1.0)
+    coderay (1.1.2)
+    combustion (0.9.1)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+      thor (>= 0.14.6)
+    concurrent-ruby (1.0.5)
+    crass (1.0.4)
+    database_cleaner (1.7.0)
+    diff-lcs (1.3)
+    erubi (1.7.1)
+    factory_bot (4.10.0)
+      activesupport (>= 3.0.0)
+    factory_bot_rails (4.10.0)
+      factory_bot (~> 4.10.0)
+      railties (>= 3.0.0)
+    faker (1.9.1)
+      i18n (>= 0.7)
+    ffi (1.9.25)
+    formatador (0.2.5)
+    guard (2.14.2)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    i18n (1.0.1)
+      concurrent-ruby (~> 1.0)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    loofah (2.2.2)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    lumberjack (1.0.13)
+    method_source (0.9.0)
+    mini_portile2 (2.3.0)
+    minitest (5.11.3)
+    nenv (0.3.0)
+    nokogiri (1.8.4)
+      mini_portile2 (~> 2.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rack (2.0.5)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.0.4)
+      loofah (~> 2.2, >= 2.2.2)
+    railties (5.2.0)
+      actionpack (= 5.2.0)
+      activesupport (= 5.2.0)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.5.0)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-rails (3.7.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    ruby_dep (1.5.0)
+    shellany (0.0.1)
+    sqlite3 (1.3.13)
+    thor (0.20.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal (~> 2.2.0)
+  bundler (~> 1.16)
+  byebug (~> 9.0)
+  combustion (~> 0.9.1)
+  database_cleaner (~> 1.7.0)
+  factory_bot_rails
+  faker (~> 1.9.1)
+  guard-rspec (~> 4.7.3)
+  quickery!
+  rake (~> 10.0)
+  rspec (~> 3.7.0)
+  rspec-rails (~> 3.7.2)
+  sqlite3 (~> 1.3.13)
+
+BUNDLED WITH
+   1.16.1

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec, cmd: 'bundle exec appraisal rails-5 rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Jules Roman Polidario
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,209 @@
+# Quickery
+
+## About
+
+* Implements Law of Demeter by mapping associated record attributes as own attributes (one-way read-only)
+* Consequently, speeds up SQL queries by removing joins queries between intermediary models, at the cost of slower writes.
+* This is an anti-normalization pattern in favour of actual data-redundancy and faster queries. Use this only as necessary.
+
+## Dependencies
+
+* **Rails 4 or 5**
+* **(Rails 3 still untested)**
+
+## Setup
+1. Add the following to your `Gemfile`:
+
+    ```ruby
+    gem 'quickery', '~> 0.1'
+    ```
+
+2. Run:
+
+    ```bash
+    bundle install
+    ```
+
+## Usage Example 1
+
+```ruby
+# app/models/employee.rb
+class Employee < ApplicationRecord
+  # say we have the following attributes:
+  #   branch_id:integer
+  #   branch_company_name:string
+  belongs_to :branch
+
+  quickery do
+    # TL;RD: the following line means:
+    #   make sure that this record's `branch_company_name` attribute will always have
+    #   the same value as branch.company.name and updates the value accordingly if it changes
+    branch.company.name == :branch_company_name
+
+    # feel free to rename :branch_company_name as you wish; it's just like any other attribute anyway
+    # the == is a custom overloaded operator; it does not mean "is equal" but means "should equal to"
+    # branch.company.name is a fluid expression that defines the attribute dependency
+    #   `branch` and `company` does not mean `branch` and `company` record
+
+    # you may add more inside this quickery-block: i.e:
+    #   branch.name == :branch_name
+    #   branch.id == :branch_id
+    #   branch.company.country.name == :branch_company_country_name
+  end
+end
+
+# app/models/branch.rb
+class Branch < ApplicationRecord
+  # say we have the following attributes:
+  #   company_id:integer
+  belongs_to :company
+end
+
+# app/models/company.rb
+class Company < ApplicationRecord
+  # say we have the following attributes:
+  #   name:string
+end
+```
+
+```bash
+# bash
+rails generate migration add_branch_company_name_to_employees branch_company_name:string
+bundle exec rake db:migrate
+```
+
+```ruby
+# rails console
+company = Company.create!(name: 'Jollibee')
+branch = Branch.create!(company: company)
+employee = Employee.create!(branch: branch)
+
+puts employee.branch_company_name
+# => 'Jollibee'
+
+# As you can see the `branch_company_name` attribute above has the same value as the associated record's attribute
+# Now, let's try updating company, and you will see below that `branch_company_name` automatically gets updated as well
+
+company.update!(name: 'Mang Inasal')
+
+puts employee.branch_company_name
+# => 'Jollibee'
+
+# You need to reload the object, if you expect that it's been changed:
+employee.reload
+
+puts employee.branch_company_name
+# => 'Mang Inasal'
+
+# Now, let's try updating the intermediary association, and you will see below that `branch_company_name` would be updated accordingly
+other_company = Company.create!(name: 'McDonalds')
+branch.update!(company: other_company)
+
+employee.reload
+
+puts employee.branch_company_name
+# => 'McDonalds'
+```
+
+## Usage Example 2
+
+* let `Branch` and `Company` model be the same as the Usage Example 1 above
+
+```ruby
+# app/models/employee.rb
+class Employee < ApplicationRecord
+  belongs_to :branch
+  belongs_to :country, foreign_key: :branch_company_id
+
+  quickery do
+    branch.company.id == :branch_company_id
+  end
+end
+```
+
+```bash
+# bash
+rails generate migration add_branch_company_id_to_employees branch_company_id:bigint
+bundle exec rake db:migrate
+```
+
+```ruby
+# rails console
+company = Company.create!(name: 'Jollibee')
+branch = Branch.create!(company: company)
+employee = Employee.create!(branch: branch)
+
+puts employee.branch_company_id
+# => 1
+
+puts Employee.where(company: company)
+# => [#<Employee id: 1>]
+
+# as you may notice, the query above is a lot simpler and faster instead of doing it normally like below (if not using Quickery)
+# you may however still using belongs_to `:through` to achieve the simplified query like above, but it's still a lot slower because of JOINS
+puts Employee.joins(branch: :company).where(companies: { id: company.id })
+# => [#<Employee id: 1>]
+```
+
+## DSL
+
+### For any subclass of `ActiveRecord::Base`:
+
+#### Class Methods:
+
+##### `quickery(&block)`
+* returns a `Quickery::AssociationBuilder` object
+* block is executed in the context of the `Quickery::AssociationBuilder` object,
+  which means that you cannot access the model instance inside the block, as you are not supposed to.
+* inside the block you may define "quickery-defined attribute mappings";
+  each mapping will create a `Quickery::QuickeryBuilder` object. i.e:
+    * `branch.company.country.category.name == :branch_company_country_category_name`
+        * You are required to specify `belongs_to :branch` association in this model.
+        * Similarly, you are required to specify `belongs_to :company` inside `Branch` model, `belongs_to :country` inside `Company` model; etc...
+* each `Quickery::AssociationBuilder` defines a set of "hidden" `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.
+
+##### `quickery_builders`
+* returns an `Array` of `Quickery::QuickeryBuilder` objects that have already been defined
+* for more info, see `quickery(&block)` above
+* you normally do not need to use this method
+
+#### Instance Methods:
+
+##### `recreate_quickery_cache!`
+* force-updates the quickery-defined attributes
+* useful if you already have records, and you want these old records to be updated immediately
+* i.e. you can do so something like the following:
+    ```ruby
+    Employee.each do |employee|
+      employee.recreate_quickery_cache!
+    end
+    ```
+
+##### `determine_quickery_value(depender_column_name)`
+* returns the current "actual" supposed value of the "original" dependee column
+* useful for debugging to check if the quickery-defined attributes do not have correct mapped values
+* i.e. you can do something like the following:
+
+    ```ruby
+    employee = Employee.first
+    puts employee.determine_quickery_value(:branch_company_country_name)
+    # => 'Ireland'
+    ```
+
+## TODOs
+* Possibly support two-way mapping of attributes? So that you can do, say... `employee.update!(branch_company_name: 'somenewcompanyname')`
+
+## Contributing
+* pull requests and forks are very much welcomed! :) Let me know if you find any bug! Thanks
+
+## License
+* MIT
+
+## Developer Guide
+* see [developer_guide.md](developer_guide.md)
+
+## Changelog
+* 0.1.0
+  * initial beta release

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quickery"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/config.ru

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "rubygems"
+require "bundler"
+
+Bundler.require :default, :development
+
+Combustion.initialize! :all
+run Combustion::Application

data/developer_guide.md

@@ -0,0 +1,26 @@
+## Development
+
+### Publishing as Ruby Gem
+
+```bash
+# [increment gem VERSION]
+gem build quickery
+gem push quickery-X.X.X.gem
+```
+
+## Test
+
+* Test suite makes use of the following gems worth mentioning (in addition to some others):
+  * [rspec-rails](https://github.com/rspec/rspec-rails)
+  * [combustion](https://github.com/pat/combustion)
+  * [appraisal](https://github.com/thoughtbot/appraisal)
+
+```bash
+# to auto-test specs whenever a spec file has been modified:
+bundle exec guard
+
+# to manually run specs for a particular rails version (for more info: see Appraisals file):
+bundle exec appraisal rails-5 rspec
+# or
+bundle exec appraisal rails-4 rspec
+```

data/gemfiles/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_RETRY: "1"

data/gemfiles/rails_3.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "3.2.22.5"
+
+gemspec path: "../"

data/gemfiles/rails_4.gemfile

@@ -0,0 +1,11 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "4.2.10"
+
+group :development, :test do
+  gem "factory_bot_rails", require: false
+end
+
+gemspec path: "../"

data/gemfiles/rails_5.gemfile

@@ -0,0 +1,11 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "5.2.1"
+
+group :development, :test do
+  gem "factory_bot_rails", require: false
+end
+
+gemspec path: "../"

data/lib/quickery/active_record_extensions/dsl.rb

@@ -0,0 +1,44 @@
+require 'byebug'
+require 'active_support'
+
+module Quickery
+  module ActiveRecordExtensions
+    module DSL
+      def self.included(base)
+        base.extend ClassMethods
+        base.include InstanceMethods
+      end
+
+      module ClassMethods
+        def quickery(&block)
+          association_builder = AssociationBuilder.new(model: self)
+          association_builder.instance_exec(&block)
+        end
+      end
+
+      module InstanceMethods
+        def recreate_quickery_cache!
+          self.class.quickery_builders.each do |depender_column_name, quickery_builder|
+            new_value = determine_quickery_value(depender_column_name)
+            update_columns(depender_column_name => new_value)
+          end
+
+          true
+        end
+
+        def determine_quickery_value(depender_column_name)
+          quickery_builder = self.class.quickery_builders[depender_column_name]
+
+          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.first_association_builder._quickery_dependee_record(self)
+          dependee_record.send(quickery_builder.dependee_column_name)
+        end
+      end
+    end
+  end
+end
+
+ActiveSupport.on_load(:active_record) do
+  include Quickery::ActiveRecordExtensions::DSL
+end

data/lib/quickery/association_builder.rb

@@ -0,0 +1,108 @@
+module Quickery
+  class AssociationBuilder
+    attr_reader :model
+    attr_reader :parent_builder
+    attr_reader :child_builder
+    attr_reader :inverse_association_name
+    attr_reader :belongs_to
+
+    def initialize(model:, parent_builder: nil, inverse_association_name: nil)
+      @model = model
+      @parent_builder = parent_builder
+      @inverse_association_name = inverse_association_name
+      @reflections = model.reflections
+      @belongs_to_association_names = @reflections.map{ |key, value| value.macro == :belongs_to ? key : nil }.compact
+      @column_names = model.column_names
+    end
+
+    # we need to prepend _quickery to all methods, to make sure no conflicts with association names that are dynamically invoked through `method_missing` below
+
+    def _quickery_get_child_builders(include_self: false, builders: [])
+      builders << self if include_self
+
+      if @child_builder.nil?
+        builders
+      else
+        builders << @child_builder
+        return @child_builder._quickery_get_child_builders(builders: builders)
+      end
+    end
+
+    def _quickery_get_parent_builders(include_self: false, builders: [])
+      builders << self if include_self
+
+      if @parent_builder.nil?
+        builders
+      else
+        builders << @parent_builder
+        @parent_builder._quickery_get_parent_builders(builders: builders)
+      end
+    end
+
+    def _quickery_get_joins_arg(current_joins_arg = nil)
+      if @parent_builder.nil?
+        current_joins_arg
+      else
+        if current_joins_arg.nil?
+          @parent_builder._quickery_get_joins_arg(@inverse_association_name.to_sym)
+        else
+          @parent_builder._quickery_get_joins_arg({ @inverse_association_name.to_sym => current_joins_arg })
+        end
+      end
+    end
+
+    def _quickery_dependent_records(record_to_be_saved)
+      primary_key_value = record_to_be_saved.send(record_to_be_saved.class.primary_key)
+      most_parent_model = _quickery_get_parent_builders.last.model
+
+      records = most_parent_model.all
+
+      unless (joins_arg = _quickery_get_joins_arg).nil?
+        records = records.joins(joins_arg)
+      end
+
+      records = records.where(
+        model.table_name => {
+          model.primary_key => primary_key_value
+        }
+      )
+    end
+
+    def _quickery_dependee_record(record_to_be_saved)
+      raise ArgumentError, 'argument should be an instance of @model' unless record_to_be_saved.is_a? model
+
+      _quickery_get_child_builders(include_self: true).inject(record_to_be_saved) do |record, association_builder|
+        if association_builder.belongs_to
+          record.send(association_builder.belongs_to.name)
+        else
+          record
+        end
+      end
+    end
+
+    private
+
+    def method_missing(method_name, *args, &block)
+      method_name_str = method_name.to_s
+      if @belongs_to_association_names.include? method_name_str
+        @belongs_to = @reflections[method_name_str]
+        @child_builder = AssociationBuilder.new(model: belongs_to.class_name.constantize, parent_builder: self, inverse_association_name: method_name_str)
+      elsif @column_names.include? method_name_str
+        QuickeryBuilder.new(dependee_column_name: method_name_str, last_association_builder: self)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing(method_name, include_private = false)
+      method_name_str = method_name.to_s
+      if @belongs_to_association_names.include? method_name_str
+        true
+      elsif @column_names.include? method_name_str
+        true
+      else
+        super
+      end
+    end
+  end
+end

data/lib/quickery/callbacks_builder.rb

@@ -0,0 +1,107 @@
+module Quickery
+  class CallbacksBuilder
+    attr_reader :quickery_builder
+
+    def initialize(quickery_builder:, should_add_callbacks: true)
+      @quickery_builder = quickery_builder
+      add_callbacks if should_add_callbacks
+    end
+
+    private
+
+    def add_callbacks
+      add_callback_to_depender_model
+      add_callback_to_dependee_model
+      add_callback_to_each_intermediate_model
+    end
+
+    # add callback to immediately sync value after a record has been created / updated
+    def add_callback_to_depender_model
+      first_association_builder = @quickery_builder.first_association_builder
+      depender_column_name = @quickery_builder.depender_column_name
+      dependee_column_name = @quickery_builder.dependee_column_name
+
+      first_association_builder.model.class_exec do
+
+        # before create or update
+        before_save do
+          if changes.keys.include? first_association_builder.belongs_to.foreign_key
+            if send(first_association_builder.belongs_to.foreign_key).nil?
+              new_value = nil
+            else
+              dependee_record = first_association_builder._quickery_dependee_record(self)
+              new_value = dependee_record.send(dependee_column_name)
+            end
+
+            assign_attributes(depender_column_name => new_value)
+          end
+        end
+      end
+    end
+
+    # add callback to sync changes when dependee_column has been updated
+    def add_callback_to_dependee_model
+      last_association_builder = @quickery_builder.last_association_builder
+      depender_column_name = @quickery_builder.depender_column_name
+      dependee_column_name = @quickery_builder.dependee_column_name
+
+      last_association_builder.model.class_exec do
+
+        before_update do
+          if changes.keys.include? dependee_column_name
+            new_value = send(dependee_column_name)
+
+            dependent_records = last_association_builder._quickery_dependent_records(self)
+            dependent_records.update_all(depender_column_name => new_value)
+          end
+        end
+
+        before_destroy do
+          if attributes.keys.include? dependee_column_name
+            new_value = nil
+
+            dependent_records = last_association_builder._quickery_dependent_records(self)
+            dependent_records.update_all(depender_column_name => new_value)
+          end
+        end
+      end
+    end
+
+    # also add callbacks to sync changes when intermediary associations have been changed (this does not include first and last builder)
+    def add_callback_to_each_intermediate_model
+      last_association_builder = @quickery_builder.last_association_builder
+      depender_column_name = @quickery_builder.depender_column_name
+      dependee_column_name = @quickery_builder.dependee_column_name
+
+      last_association_builder._quickery_get_parent_builders(include_self: true)[1..-2].each do |association_builder|
+        intermediate_model = association_builder.model
+
+        intermediate_model.class_exec do
+
+          before_update do
+            if changes.keys.include? association_builder.belongs_to.foreign_key
+              if send(association_builder.belongs_to.foreign_key).nil?
+                new_value = nil
+              else
+                dependee_record = association_builder._quickery_dependee_record(self)
+                new_value = dependee_record.send(dependee_column_name)
+              end
+
+              dependent_records = association_builder._quickery_dependent_records(self)
+              dependent_records.update_all(depender_column_name => new_value)
+            end
+          end
+
+          before_destroy do
+            if attributes.keys.include? association_builder.belongs_to.foreign_key
+              new_value = nil
+
+              dependent_records = last_association_builder._quickery_dependent_records(self)
+              dependent_records.update_all(depender_column_name => new_value)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/quickery/quickery_builder.rb

@@ -0,0 +1,41 @@
+module Quickery
+  class QuickeryBuilder
+    attr_reader :model
+    attr_reader :depender_column_name
+    attr_reader :dependee_column_name
+    attr_reader :first_association_builder
+    attr_reader :last_association_builder
+    attr_reader :callbacks_builder
+
+    def initialize(dependee_column_name:, last_association_builder:)
+      @dependee_column_name = dependee_column_name
+      @last_association_builder = last_association_builder
+      @first_association_builder = last_association_builder._quickery_get_parent_builders.last
+      @model = @first_association_builder.model
+    end
+
+    def ==(depender_column_name)
+      @depender_column_name = depender_column_name
+
+      @callbacks_builder = CallbacksBuilder.new(quickery_builder: self)
+
+      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[depender_column_name] = self
+    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

@@ -0,0 +1,3 @@
+module Quickery
+  VERSION = '0.1.0'
+end

data/lib/quickery.rb

@@ -0,0 +1,6 @@
+Dir[__dir__ + '/quickery/*.rb'].each {|file| require file }
+Dir[__dir__ + '/quickery/active_record_extensions/*.rb'].each {|file| require file }
+
+module Quickery
+  # Your code goes here...
+end

data/quickery.gemspec

@@ -0,0 +1,38 @@
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'quickery/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'quickery'
+  spec.version       = Quickery::VERSION
+  spec.authors       = ['Jules Roman Polidario']
+  spec.email         = ['jrpolidario@gmail.com']
+
+  spec.summary       = 'Database Anti-normalization pattern implementing Law of Demeter by mapping associated record attributes as own attributes (one-way read-only), and therefore improves query speeds at the cost of slower writes.'
+  spec.description   = 'Implements Law of Demeter by mapping associated record attributes as own attributes (one-way read-only). Consequently, speeds up SQL queries by removing joins queries between intermediary models, at the cost of slower writes. This is an anti-normalization pattern in favour of actual data-redundancy and faster queries. Use this only as necessary.'
+  spec.homepage      = 'https://github.com/jrpolidario/quickery'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activerecord', '~> 4.0'
+  spec.add_dependency 'activesupport', '~> 4.0'
+
+  spec.add_development_dependency 'byebug', '~> 9.0'
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.7.0'
+  spec.add_development_dependency 'rspec-rails', '~> 3.7.2'
+  spec.add_development_dependency 'sqlite3', '~> 1.3.13'
+  spec.add_development_dependency 'database_cleaner', '~> 1.7.0'
+  spec.add_development_dependency 'faker', '~> 1.9.1'
+  spec.add_development_dependency 'combustion', '~> 0.9.1'
+  spec.add_development_dependency 'guard-rspec', '~> 4.7.3'
+  spec.add_development_dependency 'appraisal', '~> 2.2.0'
+end

metadata

@@ -0,0 +1,257 @@
+--- !ruby/object:Gem::Specification
+name: quickery
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jules Roman Polidario
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-09-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.0
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.2
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.13
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.13
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.1
+- !ruby/object:Gem::Dependency
+  name: combustion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+description: Implements Law of Demeter by mapping associated record attributes as
+  own attributes (one-way read-only). Consequently, speeds up SQL queries by removing
+  joins queries between intermediary models, at the cost of slower writes. This is
+  an anti-normalization pattern in favour of actual data-redundancy and faster queries.
+  Use this only as necessary.
+email:
+- jrpolidario@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Appraisals
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- config.ru
+- developer_guide.md
+- gemfiles/.bundle/config
+- gemfiles/rails_3.gemfile
+- gemfiles/rails_4.gemfile
+- gemfiles/rails_5.gemfile
+- lib/quickery.rb
+- lib/quickery/active_record_extensions/dsl.rb
+- lib/quickery/association_builder.rb
+- lib/quickery/callbacks_builder.rb
+- lib/quickery/quickery_builder.rb
+- lib/quickery/version.rb
+- quickery.gemspec
+homepage: https://github.com/jrpolidario/quickery
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Database Anti-normalization pattern implementing Law of Demeter by mapping
+  associated record attributes as own attributes (one-way read-only), and therefore
+  improves query speeds at the cost of slower writes.
+test_files: []