active_record-associated_object 0.8.2 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5816013890fc0f6868149661030643f47028edbb6a188d5014e7fd699e0138bd
-  data.tar.gz: ef0c4be8afb96727e5f379c988632ec44f0f77d105b8aadde944ac48362b7385
+  metadata.gz: 4212b6fcecceb21ae133688c2a3332d29b8c0f5760f5a22a8ba3450037a95b20
+  data.tar.gz: 4b96fde3db82d00a3c94153cb9b212f1091bd0040d7d9771d300f2a0a0147d6f
 SHA512:
-  metadata.gz: 5f80f20322bf4661515fb6235c9d034e7ac68a22bc17e269971c8b2a1f5782affb28471316b65402bab66deedc9f63f322032fa216100c6966cd514c7421a100
-  data.tar.gz: 9def815025bf60d33b06ba6f7c9c185a59fca016f3e88a72d65fb64408dd0b4e7a34aea63c5a75de61004a64a80b86bd26e368ed021d105ed32bf6cca3a3f037
+  metadata.gz: 262b75fdf718925e7772b7c1dd4e49ab6b73f6706be97081433712a4f3efef524b1677194ff5376415fe32e770bfa080afd5b347c2ccf78786517dfe5a21a9fb
+  data.tar.gz: 47c40f2a351cd49fe9bc5e0488d37ce79bcb3d30332b3aabbaff681ef7ac7f937d81d01c60d6b7f8393d3fc28f7fa92fb9b4d5eb99ae607d95d0389deea12764

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    active_record-associated_object (0.8.2)
+    active_record-associated_object (0.8.3)
       activerecord (>= 6.1)
 
 GEM

data/README.md

@@ -60,7 +60,7 @@ We've fixed this so you don't need to care, but this is what's happening.
 > `has_object` only requires a namespace and an initializer that takes a single argument. The above `Post::Publisher` is perfectly valid as an Associated Object — same goes for `class Post::Publisher < Data.define(:post); end`.
 
 > [!TIP]
-> You can pass multiple names too: `has_object :publisher, :classified, :fortification`. I recommend `-[i]er`, `-[i]ed` and `-ion` as the general naming conventions for your Associated Objects.
+> You can pass multiple names too: `has_object :seats, :entitlements, :publisher, :classified, :fortification`. I recommend `-s`, `-[i]er`, `-[i]ed` and `-ion` as the general naming conventions for your Associated Objects.
 
 > [!TIP]
 > Plural Associated Object names are also supported: `Account.has_object :seats` will look up `Account::Seats`.
@@ -87,6 +87,17 @@ end
 
 ### See Associated Objects in action
 
+#### RubyVideo.dev
+
+The team at https://www.rubyvideo.dev has been using Associated Objects to clarify the boundaries of their Active Records and collaborator Associated Objects.
+
+See the usage in the source here:
+
+- [`ActiveRecord::AssociatedObject` instances](https://github.com/search?q=repo%3Aadrienpoly%2Frubyvideo%20ActiveRecord%3A%3AAssociatedObject&type=code)
+- [`has_object` calls](https://github.com/search?q=repo%3Aadrienpoly%2Frubyvideo+has_object&type=code)
+
+#### Flipper
+
 The team at [Flipper](https://www.flippercloud.io) used Associated Objects to help keep their new billing structure clean.
 
 You can see real life examples in these blog posts:
@@ -240,6 +251,68 @@ class Post::PublisherTest < ActiveSupport::TestCase
 end
 ```
 
+### Polymorphic Associated Objects
+
+If you want to share logic between associated objects, you can do so via standard Ruby modules:
+
+```ruby
+# app/models/pricing.rb
+module Pricing
+  # If you need to share an `extension` across associated objects you can override `Module::included` like this:
+  def self.included(object) = object.extension do
+    # Add common integration methods onto `Account`/`User` when the module is included.
+    # See the `extension` block in the `Extending` section above for an example.
+  end
+
+  def price_set?
+    # Instead of referring to `account` or `user`, use the `record` method to target either.
+    record.price_cents.positive?
+  end
+end
+
+# app/models/account/pricing.rb
+class Account::Pricing < ActiveRecord::AssociatedObject
+  include ::Pricing
+end
+
+# app/models/user/pricing.rb
+class User::Pricing < ActiveRecord::AssociatedObject
+  include ::Pricing
+end
+```
+
+Now we can call `account.pricing.price_set?` & `user.pricing.price_set?`.
+
+> [!NOTE]
+> Polymorphic Associated Objects are definitely a more advanced topic,
+> so you need to know your Ruby module hierarchy and how to track what `self` changes to fairly well.
+
+#### Using `ActiveSupport::Concern` as an alternative
+
+If you prefer the look of Active Support concerns, here's the equivalent to the above Ruby module:
+
+```ruby
+# app/models/pricing.rb
+module Pricing
+  extend ActiveSupport::Concern
+
+  included do
+    extension do
+      # Add common integration methods onto `Account`/`User` when the concern is included.
+    end
+  end
+
+  def price_set?
+    # Instead of referring to `account` or `user`, use the `record` method to target either.
+    record.price_cents.positive?
+  end
+end
+```
+
+Active Support concerns have some extra features that standard Ruby modules don't, like support for deeply-nested concerns and `class_methods do`.
+
+In this case, if you're reaching for those, you're probably building something too intricate and potentially brittle.
+
 ### Active Job integration via GlobalID
 
 Associated Objects include `GlobalID::Identification` and have automatic Active Job serialization support that looks like this:

data/lib/active_record/associated_object/railtie.rb

@@ -6,14 +6,14 @@ class ActiveRecord::AssociatedObject::Railtie < Rails::Railtie
     end
   end
 
-  initializer "object_association.setup" do
-    ActiveSupport.on_load :active_job do
-      require "active_job/performs"
-      ActiveRecord::AssociatedObject.extend ActiveJob::Performs
-    rescue LoadError
-      # We haven't bundled active_job-performs, so we're continuing without it.
-    end
+  initializer "active_job.performs" do
+    require "active_job/performs"
+    ActiveRecord::AssociatedObject.extend ActiveJob::Performs if defined?(ActiveJob::Performs)
+  rescue LoadError
+    # We haven't bundled active_job-performs, so we're continuing without it.
+  end
 
+  initializer "object_association.setup" do
     ActiveSupport.on_load :active_record do
       require "active_record/associated_object/object_association"
       include ActiveRecord::AssociatedObject::ObjectAssociation

data/lib/active_record/associated_object/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveRecord
   class AssociatedObject
-    VERSION = "0.8.2"
+    VERSION = "0.8.3"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_record-associated_object
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.3
 platform: ruby
 authors:
 - Kasper Timm Hansen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-11 00:00:00.000000000 Z
+date: 2024-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord