notification-settings 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5972f18fd90453803b464904b668bd3f908ed01e51acd07d3a20e498dcc8e956
-  data.tar.gz: fbaeced3b28d810bd5b9ff449eb6a021e61402f5223f5c1c372ecaa94f5d99ff
+  metadata.gz: 5f50994ef8bb3ce66b26f1b4a84ccdd4805a53988895f0b22f78ce29bf467740
+  data.tar.gz: ce5b76bed74ddde7ab136bfc691a915fc71d03c7e74b1bc06eefcd829b9e88f1
 SHA512:
-  metadata.gz: 579f407fb64d82aa9401a23a591003a5016fbdbdaf0aa66e1967c6b6167adb09513d66d2cd46696ff1463ce65eb7b900c41c78963a4f7f8a8d1b61e284e927d8
-  data.tar.gz: ea64460d759b552f28977a566d1048d38524ee57b6f749dd6cb5c6526277436cb61a54b5fb70c62c40853cf040b0daac7d9bfa1b3c3eaed1f36f92760b3b1316
+  metadata.gz: 32208d0bde61260f3451de68d9030f412d9c96988ac6a7d2c679e96d6a4ff6649ccf01f79eea016344cfc6baadd5dc2b2a11ac928a7a9b1af957b05a7b70bc7a
+  data.tar.gz: 83740047beef8a0eb660f970daa45b64f0d4f5bee16213d7c7b3687e5b9636f57d35222bc59363db7963fc60cd6d4c912a59216cac0f2d62010c27b575657bfc

data/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 * nothing yet
 
+### 1.2.0 - 2018-01-02
+
+* features
+    * added dependents functionality to subscribers feature
+* bugfixes
+    * fixed `uninitialized constant NotificationSettings::Object`
+
 ### 1.1.2 - 2018-01-01
 
 * bugfixes

data/README.md

@@ -136,6 +136,29 @@ Now you can easily notify all subscribers from the subscribable object:
 Recipe.first.notify_subscribers push: :ActionMailer
 ```
 
+Let's assume that we have a group which has multiple chats. When sending notifications to subscribers of a given chat, we only want them to get notified. But when sending notifications about the group, we want to have everyone notified, that is either subscribed to the group or subscribed to one of its chats. To do that you have to add the `private` method `notification_dependents` to your model (in this case `Group`) and return an array of ActiveRecord objects whose subscribers should receive notifications for objects of this class.
+
+```ruby
+has_many :chats
+has_many :talks
+
+private
+
+def notification_dependents
+    self.chats
+end
+```
+
+It is possible to override that behavior when notifying subscribers:
+
+```ruby
+# Disable notification dependents
+Group.first.notify_subscribers dependents: nil
+
+# Override notification dependents
+Group.first.notify_subscribers dependents: Group.first.chats + Group.first.talks
+```
+
 You can customize settings for a single subscription just as you would for a notification target:
 
 ```ruby

data/lib/notification_settings/subscribable.rb

@@ -16,11 +16,26 @@ module NotificationSettings
 
             def notify_subscribers options = {}
                 options[:object] = self
-                self.notification_subscribers.each do |subscriber|
+                subscribers = notify_dependents options.delete(:dependents)
+                self.notification_subscribers&.each { |subscriber| subscribers << subscriber }
+                subscribers.to_a.uniq&.each do |subscriber|
                     subscriber.notify options
                 end
             end
 
+            def notify_dependents dependents
+                subscribers = []
+                dependents ||= self.notification_dependents
+                dependents&.each { |dependent| dependent.notification_subscribers&.each { |subscriber| subscribers << subscriber } }
+                subscribers
+            end
+
+            private
+
+            def notification_dependents
+                []
+            end
+
         end
 
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: notification-settings
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Jonas Hübotter
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement