active_record-associated_object 0.7.1 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b86335fcc0e7c367775d2f21fef7537a39c847022ef83feebc1bd68ed21baf1
-  data.tar.gz: b2031efb700cccd28eb7b4414ee4bb8a4e45c4bd0912658f4d54301188987cec
+  metadata.gz: 76dd7495e0e2e855e708737a875ff879a8ec840d68f5c80ad4733ece3b72dda6
+  data.tar.gz: '09b38711104836c6c222a1663ddf4e7248ae784b727b597ed61f6436ab2bf17b'
 SHA512:
-  metadata.gz: 664b086f82fcaa6c7029d7e3b44cc4fb8cbeaa581761927054cf80bfddad26cd63b12504a380f00109926e23310ef7bcef4970f99acb5c6b7397080d0410b64d
-  data.tar.gz: 0b3053a708426b83fcbe233394aed806347e8dc74d6305b2a19221de21b30f25e70a8c0e9918b62255639d6d6ac4e3f77a01a514efb98522bd1db78a5a217216
+  metadata.gz: 06fc0e959dedecab41a3c0d48d846eda454bd69c48fe8042cad1378c408fd919f688c2e07d5a26d675316556210ae25796585bc56438c8c66e3092c52fe3b1f6
+  data.tar.gz: bd35d99fc113f26d2b49e1fde335db7c28af90e7985ea0d2c60dc9dd8188e05cc2c4102bbe4edf5c45998d2b5cc96cd8f00bcd8974acf858450db479432c84f8

data/Gemfile.lock

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

data/README.md

@@ -62,6 +62,9 @@ We've fixed this so you don't need to care, but this is what's happening.
 > [!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.
 
+> [!TIP]
+> Plural Associated Object names are also supported: `Account.has_object :seats` will look up `Account::Seats`.
+
 See how we're always expecting a link to the model, here `post`?
 
 Because of that, you can rely on `post` from the associated object:
@@ -82,6 +85,12 @@ class Post::Publisher < ActiveRecord::AssociatedObject
 end
 ```
 
+### Use the generator to help write Associated Objects
+
+To set up the `Post::Publisher` from above, you can call `bin/rails generate associated Post::Publisher`.
+
+See `bin/rails generate associated --help` for more info.
+
 ### Forwarding callbacks onto the associated object
 
 To further help illustrate how your collaborator Associated Objects interact with your domain model, you can forward callbacks.

data/lib/active_record/associated_object/object_association.rb

@@ -14,7 +14,10 @@ module ActiveRecord::AssociatedObject::ObjectAssociation
   module ClassMethods
     def has_object(*names, **callbacks)
       extend_source_from(names) do |name|
-        "def #{name}; (@associated_objects ||= {})[:#{name}] ||= #{const_get(name.to_s.classify)}.new(self); end"
+        const_get object_name = name.to_s.camelize
+        "def #{name}; (@associated_objects ||= {})[:#{name}] ||= #{object_name}.new(self); end"
+      rescue NameError
+        raise "The #{self}::#{object_name} associated object referenced from #{self} doesn't exist"
       end
 
       extend_source_from(names) do |name|

data/lib/active_record/associated_object/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveRecord
   class AssociatedObject
-    VERSION = "0.7.1"
+    VERSION = "0.8.1"
   end
 end

data/lib/generators/associated/USAGE

@@ -0,0 +1,15 @@
+Description:
+    Create a PORO collaborator associated object inheriting from `ActiveRecord::AssociatedObject` that's associated with an Active Record record class.
+
+    It'll be associated on the record with `has_object`.
+
+    Note: associated object names support pluralized class names. So "Seats" remain "seats" in all cases, and "Seat" remains "seat" in all cases.
+Example:
+    bin/rails generate associated Organization::Seats
+
+    This will create:
+        app/models/organization/seats.rb
+        test/models/organization/seats_test.rb
+
+    And in Organization, this will insert:
+      has_object :seats

data/lib/generators/associated/associated_generator.rb

@@ -0,0 +1,27 @@
+class AssociatedGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path("templates", __dir__)
+
+  def generate_associated_object_files
+    template "associated.rb",      "app/models/#{name.underscore}.rb"
+    template "associated_test.rb", "test/models/#{name.underscore}_test.rb"
+  end
+
+  def connect_associated_object
+    record_file = "#{destination_root}/app/models/#{record_path}.rb"
+    raise "Record class '#{record_klass}' does not exist" unless File.exist?(record_file)
+
+    inject_into_class record_file, record_klass do
+      optimize_indentation "has_object :#{associated_object_path}", 2
+    end
+  end
+
+  private
+
+  # The `:name` argument can handle model names, but associated object class names aren't singularized.
+  # So these record and associated_object methods prevent that.
+  def record_path  = record_klass.downcase.underscore
+  def record_klass = name.deconstantize
+
+  def associated_object_path  = associated_object_class.downcase.underscore
+  def associated_object_class = name.demodulize
+end

data/lib/generators/associated/templates/associated.rb.tt

@@ -0,0 +1,5 @@
+class <%= name %> < ActiveRecord::AssociatedObject
+  extension do
+    # Extend <%= record_klass %> here
+  end
+end

data/lib/generators/associated/templates/associated_test.rb.tt

@@ -0,0 +1,8 @@
+require "test_helper"
+
+class <%= name %>Test < ActiveSupport::TestCase
+  setup do
+    # @<%= record_path %> = <%= record_path.pluralize %>(:TODO_fixture_name)
+    # @<%= associated_object_path %> = @<%= record_path %>.<%= associated_object_path %>
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_record-associated_object
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.1
 platform: ruby
 authors:
 - Kasper Timm Hansen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-24 00:00:00.000000000 Z
+date: 2024-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -43,6 +43,10 @@ files:
 - lib/active_record/associated_object/object_association.rb
 - lib/active_record/associated_object/railtie.rb
 - lib/active_record/associated_object/version.rb
+- lib/generators/associated/USAGE
+- lib/generators/associated/associated_generator.rb
+- lib/generators/associated/templates/associated.rb.tt
+- lib/generators/associated/templates/associated_test.rb.tt
 homepage: https://github.com/kaspth/active_record-associated_object
 licenses:
 - MIT
@@ -65,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.4
+rubygems_version: 3.5.6
 signing_key:
 specification_version: 4
 summary: Associate a Ruby PORO with an Active Record class and have it quack like