delegate_if_nil 0.2.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 118a0a92d00e61a386046d6dad0be907cb13be59926b4d52947986f646db59e6
-  data.tar.gz: 7d7079f3786f35f538aa2ed9636ed9dd2942162d823ce017116fcb41133c5c58
+  metadata.gz: '0974b95301d59910e8fee453a67dbad18c8ae91444558952d51764a8a58ef338'
+  data.tar.gz: 6a431e935d57e06b902eb5e4944e8a5aa2310f9d717e1a9c5528a78600a5ca26
 SHA512:
-  metadata.gz: 6b5af1ff90239141a6618bd541718c4834340eb9414dd71d6ae50948251eced69e78ee2da93cf5208d9a19f448e62b76de3b52683e4ee56a35a663148921b611
-  data.tar.gz: 01ebe27e99234b2a26af27169639b6d62d43506f0d7ffafa8427ff2f66820efb260210eaff7849228174d304b646c82bda8e23d6121736b1e5529807b9fe1832
+  metadata.gz: fa21eb61e75dccf9eb2470b1abdadd43e9f3bb5bc89cd1079adf47c5187f8ba3319facc440f12d9563cc05600e08e5ec6d6a96547c0fad30210a8557248a5e13
+  data.tar.gz: 7c542e65f901c3bdf7fe1f4a3a51096ba928d01453ed539a8f5cb505751a3b0117ef95489e19ff402930019a0e634ceaca7c4d904bcf96645e02f9efeced0ad6

data/README.md

@@ -17,6 +17,19 @@ end
 
 `animal` will now delegate to `owning_model` if it's `nil` on an instance of `SomeModel`.
 
+`delegate_if_nil` is available as an alias:
+
+```ruby
+class SomeModel < ApplicationRecord
+    extend DelegateIfNil
+    belongs_to :owning_model
+
+    nil_delegate :animal, to: :owning_model
+    delegate_if_nil :animal, to: :owning_model # Exact same as the line above
+    
+end
+```
+
 You also get `_source` methods, which will tell you where the `animal` value comes from. If it's not set on either one, it will return `"unset"`
 
 You'll get the following results:
@@ -24,19 +37,21 @@ You'll get the following results:
 ```ruby
 om = OwningModel.create(animal: "Cat")
 
-some_model = SomeModel.create(animal: nil, owning_model = om)
+some_model = SomeModel.create(animal: nil, owning_model: om)
 some_model.animal # "Cat"
 some_model.animal_source # "owning_model"
+some_model.animal_delegated? # true
 
-some_model = SomeModel.create(animal: "Dog", owning_model = om)
+some_model = SomeModel.create(animal: "Dog", owning_model: om)
 some_model.animal # Dog
 some_model.animal_source # "self"
+some_model.animal_delegated? # false
 
 om = OwningModel.create(animal: nil)
-some_model = SomeModel.create(animal: nil, owning_model = om)
+some_model = SomeModel.create(animal: nil, owning_model: om)
 some_model.animal # nil
 some_model.animal_source # "unset"
-
+some_model.animal_delegated? # true
 ```
 
 It also works for multiple attributes. EG:
@@ -52,11 +67,36 @@ end
 
 It also resolves correctly for recursive delegations. IE: if `owning_model` delgates an attribute if `nil`, it will correctly report the source all the way down the chain, terminating either in `self`, `unset`, or the association name.
 
+## Example
+
+This is an example based off a real-world project.
+
+A `User` has many `notification_channels`. Each `user` and `notification_channel` has a `notifications_enabled` boolean flag.
+
+With this setup, a `user` can set a default value for `notifications_enabled`, and each channel can override the default.
+
+eg:
+
+```ruby
+class User < ActiveRecord::Base
+    # notifications_enabled is a boolean attribute on the user model
+    has_many :notification_channels
+end
+
+class NotificationChannel < ActiveRecord::Base
+    # notifications_enabled is a boolean attribute on the notification_channel model
+    belongs_to :user
+    nil_delegate :notifications_enabled, to: :user
+end
+```
+
+Now, to see if a specific channel should be enabled, simple call `notification_channel.notifications_enabled`, and it will resolve the correct value for that channel. 
+
 ## Installation
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'delegate_if_nil', git: 'https://github.com/stevenallen05/delegate_if_nil.git'
+gem 'delegate_if_nil'
 ```
 
 And then execute:

data/lib/delegate_if_nil/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DelegateIfNil
-  VERSION = "0.2.0"
+  VERSION = "0.6.0"
 end

data/lib/delegate_if_nil.rb

@@ -4,12 +4,26 @@ require "delegate_if_nil/railtie"
 
 module DelegateIfNil
   extend ActiveSupport::Concern
-
+  
   def nil_delegate(*attrs, to:)
     attrs.each do |attr|
       define_method attr do
         self[attr].nil? ? send(to)&.send(attr) : self[attr]
       end
+      
+      source_object_method = "#{attr}_source_object".to_sym
+      define_method source_object_method do
+        return self unless self[attr].nil?
+
+        if send(to)&.respond_to?(source_object_method)
+          to_source = send(to).send(source_object_method)
+          return to if to_source == self
+
+          return to_source
+        else
+          return send(to)&.send(attr).nil? ? nil : to
+        end
+      end
 
       source_method = "#{attr}_source".to_sym
       define_method source_method do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: delegate_if_nil
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Steven Allen
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-08-25 00:00:00.000000000 Z
+date: 2022-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '6.0'
 description: Add to a model to simply delegate attributes to an associated record
 email:
 - sallen@amberstyle.ca
@@ -42,7 +42,7 @@ homepage: https://github.com/stevenallen05/delegate_if_nil
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -57,8 +57,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 3.3.3
+signing_key:
 specification_version: 4
 summary: Simple delegation of nil attributes to an association
 test_files: []