API / naming: special rules for actor-like models

A long forgotten feature to be ported from Rails Dynamic Associations.
It was even mentioned in README as already implemented.

Author: Alexander-Senko

README.md

@@ -73,6 +73,15 @@ book.editors
 The list of models to be handled this way can be set with `actor_model_names` configuration parameter.
 It includes `User` by default.
 
+``` ruby
+AdjustableSchema::Engine.configure do
+  config.actor_model_names << 'Person'
+end
+```
+
+> [!CAUTION]
+> Names are passed instead of model classes not to mess the loading up.
+
 ##### Self-referencing models
 
 You may want to set up recursive relationships:

app/models/concerns/adjustable_schema/actors.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AdjustableSchema # :nodoc:
+	concern :Actors do
+		class_methods do
+			def actor?
+				Config.actor_models.any? { self <= it }
+			end
+		end
+	end
+end

lib/adjustable_schema/active_record.rb

@@ -7,6 +7,7 @@ module ActiveRecord # :nodoc:
 		ActiveSupport.on_load :active_record do
 			include Associations
 			include Relationships
+			include Actors
 		end
 	end
 end

lib/adjustable_schema/active_record/association/naming.rb

@@ -37,10 +37,20 @@ def name_without_role
 					end
 				end
 
+				module Actors # :nodoc:
+					include Memery
+
+					memoize def name_with_role = {
+							source: role.name,
+							target: "#{role.name.passivize}_#{target_name}",
+					}[direction]
+				end
+
 				def initialize(...)
 					super
 
 					extend Recursive if recursive?
+					extend Actors    if target.actor?
 				end
 
 				memoize def name name = object_name

lib/adjustable_schema/config.rb

@@ -66,6 +66,11 @@ def find_direction(...)
 			module_function method
 		end
 
+		memoize def actor_models
+			Engine.config.actor_model_names
+					.filter_map &:safe_constantize
+		end
+
 		def association_names = Engine.config.names[:associations]
 
 		def normalize **options

lib/adjustable_schema/engine.rb

@@ -20,5 +20,9 @@ class Engine < ::Rails::Engine # :nodoc:
 						},
 				},
 		}
+
+		config.actor_model_names = %w[
+				User
+		]
 	end
 end

test/dummy/app/models/user.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+class User < ApplicationRecord
+end

test/dummy/db/migrate/20250423093008_create_users.rb

@@ -0,0 +1,7 @@
+class CreateUsers < ActiveRecord::Migration[8.0]
+	def change
+		create_table :users do |t|
+			t.timestamps
+		end
+	end
+end

test/dummy/db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.1].define(version: 2023_12_24_105254) do
+ActiveRecord::Schema[8.0].define(version: 2025_04_23_093008) do
   create_table "adjustable_schema_relationship_roles", force: :cascade do |t|
     t.string "name"
     t.datetime "created_at", null: false
@@ -42,5 +42,10 @@
     t.datetime "updated_at", null: false
   end
 
+  create_table "users", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+
   add_foreign_key "adjustable_schema_relationships", "adjustable_schema_relationship_roles", column: "role_id"
 end

test/lib/active_record/association/naming_test.rb

@@ -37,6 +37,18 @@
 					_(target_association.name).must_equal :dummy_roled_model1s
 				end
 			end
+
+			describe 'when target acts as an actor' do
+				let(:target) { User }
+
+				it 'names sources' do
+					_(source_association.name).must_equal :dummy_roles
+				end
+
+				it 'names targets' do
+					_(target_association.name).must_equal :dummy_roled_users
+				end
+			end
 		end
 
 		describe 'without a role' do
@@ -61,6 +73,18 @@
 					_(target_association.name).must_equal :to_selves
 				end
 			end
+
+			describe 'when target acts as an actor' do
+				let(:target) { User }
+
+				it 'names sources' do
+					_(source_association.name).must_equal :users
+				end
+
+				it 'names targets' do
+					_(target_association.name).must_equal :users
+				end
+			end
 		end
 	end
 
@@ -85,6 +109,18 @@
 					_(target_association.relationships_name).must_equal :dummy_roled_model1_relationships
 				end
 			end
+
+			describe 'when target acts as an actor' do
+				let(:target) { User }
+
+				it 'names sources' do
+					_(source_association.relationships_name).must_equal :dummy_role_relationships
+				end
+
+				it 'names targets' do
+					_(target_association.relationships_name).must_equal :dummy_roled_user_relationships
+				end
+			end
 		end
 
 		describe 'without a role' do