delegate_if_nil 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 118a0a92d00e61a386046d6dad0be907cb13be59926b4d52947986f646db59e6
+  data.tar.gz: 7d7079f3786f35f538aa2ed9636ed9dd2942162d823ce017116fcb41133c5c58
+SHA512:
+  metadata.gz: 6b5af1ff90239141a6618bd541718c4834340eb9414dd71d6ae50948251eced69e78ee2da93cf5208d9a19f448e62b76de3b52683e4ee56a35a663148921b611
+  data.tar.gz: 01ebe27e99234b2a26af27169639b6d62d43506f0d7ffafa8427ff2f66820efb260210eaff7849228174d304b646c82bda8e23d6121736b1e5529807b9fe1832

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2019 Steven Allen
+
+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,73 @@
+# DelegateIfNil
+
+A simple gem to add nil delegation to an associated model if an attribute is `nil`.
+
+## Usage
+
+Add this to your model:
+
+```ruby
+class SomeModel < ApplicationRecord
+    extend DelegateIfNil
+    belongs_to :owning_model
+
+    nil_delegate :animal, to: :owning_model
+end
+```
+
+`animal` will now delegate to `owning_model` if it's `nil` on an instance of `SomeModel`.
+
+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:
+
+```ruby
+om = OwningModel.create(animal: "Cat")
+
+some_model = SomeModel.create(animal: nil, owning_model = om)
+some_model.animal # "Cat"
+some_model.animal_source # "owning_model"
+
+some_model = SomeModel.create(animal: "Dog", owning_model = om)
+some_model.animal # Dog
+some_model.animal_source # "self"
+
+om = OwningModel.create(animal: nil)
+some_model = SomeModel.create(animal: nil, owning_model = om)
+some_model.animal # nil
+some_model.animal_source # "unset"
+
+```
+
+It also works for multiple attributes. EG:
+
+```ruby
+class SomeModel < ApplicationRecord
+    extend DelegateIfNil
+    belongs_to :owning_model
+
+    nil_delegate :animal, :phone_number, :name, to: :owning_model
+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.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'delegate_if_nil', git: 'https://github.com/stevenallen05/delegate_if_nil.git'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install delegate_if_nil
+```
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+begin
+  require "bundler/setup"
+rescue LoadError
+  puts "You must `gem install bundler` and `bundle install` to run rake tasks"
+end
+
+require "rdoc/task"
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title    = "DelegateIfNil"
+  rdoc.options << "--line-numbers"
+  rdoc.rdoc_files.include("README.md")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+end
+
+require "bundler/gem_tasks"
+
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = false
+end
+
+task default: :test

data/lib/delegate_if_nil.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+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_method = "#{attr}_source".to_sym
+      define_method source_method do
+        return "self" unless self[attr].nil?
+
+        if send(to)&.respond_to?(source_method)
+          to_source = send(to).send(source_method)
+          return to.to_s if to_source == "self"
+
+          return to_source
+        else
+          return send(to)&.send(attr).nil? ? "unset" : to.to_s
+        end
+      end
+
+      delegted_bool_method = "#{attr}_delegated?".to_sym
+      define_method delegted_bool_method do
+        self[attr].nil?
+      end
+    end
+  end
+end

data/lib/delegate_if_nil/railtie.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module DelegateIfNil
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/delegate_if_nil/version.rb

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

data/lib/tasks/delegate_if_nil_tasks.rake

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# desc "Explaining what the task does"
+# task :delegate_if_nil do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: delegate_if_nil
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Steven Allen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+description: Add to a model to simply delegate attributes to an associated record
+email:
+- sallen@amberstyle.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/delegate_if_nil.rb
+- lib/delegate_if_nil/railtie.rb
+- lib/delegate_if_nil/version.rb
+- lib/tasks/delegate_if_nil_tasks.rake
+homepage: https://github.com/stevenallen05/delegate_if_nil
+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: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Simple delegation of nil attributes to an association
+test_files: []