anchormodel 0.1.4 → 0.2.0

data/doc/method_list.html

@@ -77,6 +77,14 @@
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#attribute-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#attribute (method)">#attribute</a></span>
+      <small>Anchormodel::ActiveModelTypeValueSingle</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/Attribute.html#attribute_name-instance_method" title="Anchormodel::Attribute#attribute_name (method)">#attribute_name</a></span>
       <small>Anchormodel::Attribute</small>
@@ -84,7 +92,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ModelMixin.html#belongs_to_anchormodel-class_method" title="Anchormodel::ModelMixin.belongs_to_anchormodel (method)">belongs_to_anchormodel</a></span>
       <small>Anchormodel::ModelMixin</small>
@@ -92,7 +100,23 @@
   </li>
   
 
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/ModelMixin.html#belongs_to_anchormodels-class_method" title="Anchormodel::ModelMixin.belongs_to_anchormodels (method)">belongs_to_anchormodels</a></span>
+      <small>Anchormodel::ModelMixin</small>
+    </div>
+  </li>
+  
+
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueMulti.html#cast-instance_method" title="Anchormodel::ActiveModelTypeValueMulti#cast (method)">#cast</a></span>
+      <small>Anchormodel::ActiveModelTypeValueMulti</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#cast-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#cast (method)">#cast</a></span>
       <small>Anchormodel::ActiveModelTypeValueSingle</small>
@@ -100,7 +124,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#changed_in_place%3F-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#changed_in_place? (method)">#changed_in_place?</a></span>
       <small>Anchormodel::ActiveModelTypeValueSingle</small>
@@ -108,7 +132,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#find-class_method" title="Anchormodel.find (method)">find</a></span>
       <small>Anchormodel</small>
@@ -116,6 +140,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel.html#form_collection-class_method" title="Anchormodel.form_collection (method)">form_collection</a></span>
+      <small>Anchormodel</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#index-instance_method" title="Anchormodel#index (method)">#index</a></span>
@@ -149,6 +181,14 @@
   
 
   <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/SimpleFormInputs/Helpers/AnchormodelInputsCommon.html#input-instance_method" title="Anchormodel::SimpleFormInputs::Helpers::AnchormodelInputsCommon#input (method)">#input</a></span>
+      <small>Anchormodel::SimpleFormInputs::Helpers::AnchormodelInputsCommon</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#inspect-instance_method" title="Anchormodel#inspect (method)">#inspect</a></span>
       <small>Anchormodel</small>
@@ -156,7 +196,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/Util.html#install_methods_in_model-class_method" title="Anchormodel::Util.install_methods_in_model (method)">install_methods_in_model</a></span>
       <small>Anchormodel::Util</small>
@@ -164,7 +204,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#key-instance_method" title="Anchormodel#key (method)">#key</a></span>
       <small>Anchormodel</small>
@@ -172,7 +212,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#label-instance_method" title="Anchormodel#label (method)">#label</a></span>
       <small>Anchormodel</small>
@@ -180,6 +220,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/Attribute.html#multiple%3F-instance_method" title="Anchormodel::Attribute#multiple? (method)">#multiple?</a></span>
+      <small>Anchormodel::Attribute</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/Attribute.html#optional-instance_method" title="Anchormodel::Attribute#optional (method)">#optional</a></span>
@@ -189,6 +237,14 @@
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueMulti.html#serializable%3F-instance_method" title="Anchormodel::ActiveModelTypeValueMulti#serializable? (method)">#serializable?</a></span>
+      <small>Anchormodel::ActiveModelTypeValueMulti</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#serializable%3F-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#serializable? (method)">#serializable?</a></span>
       <small>Anchormodel::ActiveModelTypeValueSingle</small>
@@ -196,6 +252,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueMulti.html#serialize-instance_method" title="Anchormodel::ActiveModelTypeValueMulti#serialize (method)">#serialize</a></span>
+      <small>Anchormodel::ActiveModelTypeValueMulti</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#serialize-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#serialize (method)">#serialize</a></span>

data/doc/top-level-namespace.html

@@ -6,7 +6,7 @@
 <title>
   Top Level Namespace
   
-    &mdash; Documentation by YARD 0.9.36
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -84,7 +84,7 @@
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Anchormodel.html" title="Anchormodel (class)">Anchormodel</a></span>, <span class='object_link'><a href="AnchormodelGenerator.html" title="AnchormodelGenerator (class)">AnchormodelGenerator</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Anchormodel.html" title="Anchormodel (class)">Anchormodel</a></span>, <span class='object_link'><a href="AnchormodelCheckBoxesInput.html" title="AnchormodelCheckBoxesInput (class)">AnchormodelCheckBoxesInput</a></span>, <span class='object_link'><a href="AnchormodelGenerator.html" title="AnchormodelGenerator (class)">AnchormodelGenerator</a></span>, <span class='object_link'><a href="AnchormodelInput.html" title="AnchormodelInput (class)">AnchormodelInput</a></span>, <span class='object_link'><a href="AnchormodelRadioButtonsInput.html" title="AnchormodelRadioButtonsInput (class)">AnchormodelRadioButtonsInput</a></span>
     
   
 </p>
@@ -100,9 +100,9 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Apr 23 17:20:43 2024 by
+  Generated on Sat Apr 27 10:18:33 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.36 (ruby-3.2.2).
+  0.9.34 (ruby-3.2.2).
 </div>
 
     </div>

data/lib/anchormodel/active_model_type_value_multi.rb

@@ -0,0 +1,31 @@
+class Anchormodel::ActiveModelTypeValueMulti < Anchormodel::ActiveModelTypeValueSingle
+  # This converts DB or input to an Anchormodel instance
+  def cast(values)
+    return values.split(',').map { |value| super(value) }.compact.to_set
+  end
+
+  # This converts an Anchormodel instance to string for DB
+  def serialize(values)
+    return case values
+           when Enumerable
+             values.map { |value| super(value) }.compact.join(',')
+           when String
+             values
+           when nil
+             ''
+           else
+             fail "Attempt to set #{@attribute.attribute_name} to unsupported type #{values.class}"
+           end
+  end
+
+  def serializable?(values)
+    return case values
+           when Enumerable
+             values.map { |value| super(value) }.compact.join(',')
+           when String
+             values.split(',').map { |value| super(value) }.compact
+           else
+             false
+           end
+  end
+end

data/lib/anchormodel/active_model_type_value_single.rb

@@ -1,5 +1,7 @@
 # @see https://www.rubydoc.info/docs/rails/ActiveModel/Type/Value
 class Anchormodel::ActiveModelTypeValueSingle < ActiveModel::Type::Value
+  attr_reader :attribute
+
   def initialize(attribute)
     super()
     @attribute = attribute
@@ -9,14 +11,14 @@ class Anchormodel::ActiveModelTypeValueSingle < ActiveModel::Type::Value
     :anchormodel
   end
 
-  # This converts an Anchormodel instance to string for DB
+  # This converts DB or input to an Anchormodel instance
   def cast(value)
     value = value.presence
     return value if value.is_a?(@attribute.anchormodel_class)
     return @attribute.anchormodel_class.find(value)
   end
 
-  # This converts DB or input to an Anchormodel instance
+  # This converts an Anchormodel instance to string for DB
   def serialize(value)
     value = value.presence
     return case value

data/lib/anchormodel/attribute.rb

@@ -10,10 +10,16 @@ class Anchormodel::Attribute
   # @param attribute_name [String,Symbol] The name and database column of the attribute
   # @param anchormodel_class [Class] Class of the Anchormodel (omit if attribute `:foo_bar` holds an `FooBar`)
   # @param optional [Boolean] If true, a presence validation is added to the model.
-  def initialize(model_class, attribute_name, anchormodel_class = nil, optional = false)
+  # @param multiple [Boolean] If true, this attribute holds multiple anchormodels.
+  def initialize(model_class, attribute_name, anchormodel_class = nil, optional = false, multiple = false)
     @model_class = model_class
     @attribute_name = attribute_name.to_sym
     @anchormodel_class = anchormodel_class
     @optional = optional
+    @multiple = multiple
+  end
+
+  def multiple?
+    @multiple
   end
 end

data/lib/anchormodel/model_mixin.rb

@@ -14,5 +14,12 @@ module Anchormodel::ModelMixin
     def belongs_to_anchormodel(*args, **kwargs)
       Anchormodel::Util.install_methods_in_model(self, *args, **kwargs)
     end
+
+    # Creates an attribute linking to an array of Anchormodels. The attribute should be
+    # present in the DB and the column should be named the singular of `attribute_name`.
+    # @see Anchormodel::Util#install_methods_in_model Parameters
+    def belongs_to_anchormodels(*args, **kwargs)
+      Anchormodel::Util.install_methods_in_model(self, *args, **kwargs, multiple: true)
+    end
   end
 end

data/lib/anchormodel/simple_form_inputs/anchormodel_check_boxes_input.rb

@@ -0,0 +1,23 @@
+unless defined? SimpleForm
+  begin
+    require 'simple_form'
+  rescue LoadError
+    nil
+  end
+
+end
+if defined? SimpleForm
+  class AnchormodelCheckBoxesInput < SimpleForm::Inputs::CollectionCheckBoxesInput
+    include Anchormodel::SimpleFormInputs::Helpers::AnchormodelInputsCommon
+
+    private
+
+    def sf_selection_key
+      :checked
+    end
+
+    def before_render_input
+      @input_type = :check_boxes
+    end
+  end
+end

data/lib/anchormodel/simple_form_inputs/anchormodel_input.rb

@@ -0,0 +1,21 @@
+unless defined? SimpleForm
+  begin
+    require 'simple_form'
+  rescue LoadError
+    nil
+  end
+
+end
+if defined? SimpleForm
+  class AnchormodelInput < SimpleForm::Inputs::CollectionSelectInput
+    include Anchormodel::SimpleFormInputs::Helpers::AnchormodelInputsCommon
+
+    private
+
+    def sf_selection_key
+      :selected
+    end
+
+    def before_render_input; end
+  end
+end

data/lib/anchormodel/simple_form_inputs/anchormodel_radio_buttons_input.rb

@@ -0,0 +1,23 @@
+unless defined? SimpleForm
+  begin
+    require 'simple_form'
+  rescue LoadError
+    nil
+  end
+
+end
+if defined? SimpleForm
+  class AnchormodelRadioButtonsInput < SimpleForm::Inputs::CollectionRadioButtonsInput
+    include Anchormodel::SimpleFormInputs::Helpers::AnchormodelInputsCommon
+
+    private
+
+    def sf_selection_key
+      :checked
+    end
+
+    def before_render_input
+      @input_type = :radio_buttons
+    end
+  end
+end

data/lib/anchormodel/simple_form_inputs/helpers/anchormodel_inputs_common.rb

@@ -0,0 +1,54 @@
+class Anchormodel
+  module SimpleFormInputs
+    module Helpers
+      module AnchormodelInputsCommon
+        def input(wrapper_options = nil)
+          unless object.respond_to?(:anchormodel_attributes)
+            fail("The form field object does not appear to respond to `anchormodel_attributes`, \
+did you `include Anchormodel::ModelMixin` in your `application_record.rb`? Affected object: #{object.inspect}")
+          end
+
+          am_attr = object.anchormodel_attributes[@attribute_name]
+          unless am_attr
+            fail("#{@attribute_name.inspect} does not look like an Anchormodel attribute, is `belongs_to_anchormodel` called in your model? \
+Affected object: #{object.inspect}")
+          end
+          am_class = am_attr.anchormodel_class
+          options[:multiple] = true if am_attr.multiple? && options[:multiple] != false # allow overriding
+
+          # Attempt to read selected key from html input options "value", as the caller might not know that this is a select.
+          selected_key = input_options[:value]
+          if selected_key.blank? && object
+            # No selected key override present and a model is present, use the model to find out what to select.
+            selected_am = object.send(@attribute_name)
+            if am_attr.multiple?
+              selected_key = selected_am&.map(&:key)&.map(&:to_s) || []
+            else
+              selected_key = (selected_am&.key || am_class.all.first).to_s
+            end
+          end
+
+          options.deep_merge!(
+            label_method:  :first,
+            value_method:  :second,
+            sf_selection_key =>       selected_key,
+            include_blank: !am_attr.multiple? && am_attr.optional
+          )
+
+          @collection = collect(am_class.all)
+
+          before_render_input
+
+          super
+        end
+
+        private
+
+        # Takes an array of objects implementing the methods `label` and `key` and returns an array suitable for simple_form select fields.
+        def collect(flat_array)
+          return flat_array.map { |entry| [entry.label, entry.key] }
+        end
+      end
+    end
+  end
+end

data/lib/anchormodel/util.rb

@@ -5,21 +5,24 @@ module Anchormodel::Util
   # @param model_class [ActiveRecord::Base] Internal only. The model class that the attribute should be installed to.
   # @param attribute_name [String,Symbol] The name and database column of the attribute
   # @param anchormodel_class [Class] Class of the Anchormodel (omit if attribute `:foo_bar` holds a `FooBar`)
-  # @param optional [Boolean] If false, a presence validation is added to the model.
+  # @param optional [Boolean] If false, a presence validation is added to the model. Forced to true if multiple is true.
+  # @param multiple [Boolean] Internal only. Distinguishes between `belongs_to_anchormodel` and `belongs_to_anchormodels`.
   # @param model_readers [Boolean] If true, the model is given an ActiveRecord::Enum style method `my_model.my_key?` reader for each key in the anchormodel
   # @param model_writers [Boolean] If true, the model is given an ActiveRecord::Enum style method `my_model.my_key!` writer for each key in the anchormodel
   # @param model_scopes [Boolean] If true, the model is given an ActiveRecord::Enum style scope `MyModel.mykey` for each key in the anchormodel
   # @param model_methods [Boolean, NilClass] If non-nil, this mass-assigns and overrides `model_readers`, `model_writers` and `model_scopes`
   def self.install_methods_in_model(model_class, attribute_name, anchormodel_class = nil,
                                     optional: false,
+                                    multiple: false,
                                     model_readers: true,
                                     model_writers: true,
                                     model_scopes: true,
                                     model_methods: nil)
 
+    optional = true if multiple
     anchormodel_class ||= attribute_name.to_s.classify.constantize
     attribute_name = attribute_name.to_sym
-    attribute = Anchormodel::Attribute.new(self, attribute_name, anchormodel_class, optional)
+    attribute = Anchormodel::Attribute.new(model_class, attribute_name, anchormodel_class, optional, multiple)
 
     # Mass configurations if model_methods was specfied
     unless model_methods.nil?
@@ -38,11 +41,43 @@ module Anchormodel::Util
 
     # Make casting work
     # Define serializer/deserializer
-    active_model_type_value = Anchormodel::ActiveModelTypeValueSingle.new(attribute)
+    active_model_type_value = (multiple ? Anchormodel::ActiveModelTypeValueMulti : Anchormodel::ActiveModelTypeValueSingle).new(attribute)
 
     # Overwrite reader to force building anchors at every retrieval
     model_class.define_method(attribute_name.to_s) do
-      active_model_type_value.deserialize(read_attribute_before_type_cast(attribute_name))
+      result = active_model_type_value.deserialize(read_attribute_before_type_cast(attribute_name))
+
+      # If this attribute holds multiple anchormodels (`belongs_to_anchormodels`), patch the Array before returning in order to implement collection modifiers:
+      if multiple
+        model = self # fetching the model in order to pass it to the implementation of the following via reflection to make it available for storage
+        single_tv = Anchormodel::ActiveModelTypeValueSingle.new(attribute) # Used for casting inputs to properly compare them to the set.
+
+        # Adding
+        result.define_singleton_method('add') do |value_to_add|
+          super(single_tv.cast(value_to_add))
+          model.write_attribute(attribute_name, active_model_type_value.serialize(self))
+          next self
+        end
+        result.define_singleton_method('<<') { |value_to_add| add(single_tv.cast(value_to_add)) }
+
+        # Deleting
+        result.define_singleton_method('delete') do |value_to_delete|
+          super(single_tv.cast(value_to_delete))
+          model.write_attribute(attribute_name, active_model_type_value.serialize(self))
+          next self
+        end
+
+        # Clearing
+        result.define_singleton_method('clear') do
+          super()
+          model.write_attribute(attribute_name, active_model_type_value.serialize(self))
+          next self
+        end
+
+        # In the future, further methods could be supported. e.g. delete_if, subtract etc.
+      end
+
+      return result
     end
 
     # Override writer to fail early when an invalid target value is specified
@@ -61,7 +96,11 @@ module Anchormodel::Util
           fail("Anchormodel reader #{entry.key}? already defined for #{self}, add `model_readers: false` to `belongs_to_anchormodel :#{attribute_name}`.")
         end
         model_class.define_method(:"#{entry.key}?") do
-          public_send(attribute_name.to_s) == entry
+          if multiple
+            public_send(attribute_name.to_s).include?(entry)
+          else
+            public_send(attribute_name.to_s) == entry
+          end
         end
       end
     end
@@ -74,7 +113,11 @@ module Anchormodel::Util
           fail("Anchormodel writer #{entry.key}! already defined for #{self}, add `model_writers: false` to `belongs_to_anchormodel :#{attribute_name}`.")
         end
         model_class.define_method(:"#{entry.key}!") do
-          public_send(:"#{attribute_name}=", entry)
+          if multiple
+            public_send(attribute_name.to_s) << entry
+          else
+            public_send(:"#{attribute_name}=", entry)
+          end
         end
       end
     end
@@ -86,7 +129,14 @@ module Anchormodel::Util
         if model_class.respond_to?(entry.key)
           fail("Anchormodel scope #{entry.key} already defined for #{self}, add `model_scopes: false` to `belongs_to_anchormodel :#{attribute_name}`.")
         end
-        model_class.scope(entry.key, -> { where(attribute_name => entry.key) })
+        if multiple
+          model_class.scope(entry.key, lambda {
+                                         where("#{attribute_name} LIKE ? OR #{attribute_name} LIKE ? OR #{attribute_name} LIKE ? OR #{attribute_name} LIKE ?",
+                                               "%#{entry.key},%", "%#{entry.key}", "#{entry.key},%", entry.key.to_s)
+                                       })
+        else
+          model_class.scope(entry.key, -> { where(attribute_name => entry.key) })
+        end
       end
     end
   end

data/lib/anchormodel.rb

@@ -25,6 +25,11 @@ class Anchormodel
     entries_list
   end
 
+  # Returns an array of tuples [label, key] suitable for passing as a collection to some form input helpers
+  def self.form_collection
+    entries_list.map { |el| [el.label, el.key.to_s] }
+  end
+
   # Retrieves a particular value given the key. Fails if not found.
   # @param key [String,Symbol] The key of the value that should be retrieved.
   def self.find(key)
@@ -79,6 +84,11 @@ end
 
 require 'anchormodel/util'
 require 'anchormodel/active_model_type_value_single'
+require 'anchormodel/active_model_type_value_multi'
 require 'anchormodel/attribute'
 require 'anchormodel/model_mixin'
 require 'anchormodel/version'
+require 'anchormodel/simple_form_inputs/helpers/anchormodel_inputs_common'
+require 'anchormodel/simple_form_inputs/anchormodel_input'
+require 'anchormodel/simple_form_inputs/anchormodel_radio_buttons_input'
+require 'anchormodel/simple_form_inputs/anchormodel_check_boxes_input'

data/test/active_record_model/user_test.rb

@@ -21,10 +21,6 @@ class UserTest < Minitest::Test
     )
   end
 
-  def test_missing_key
-    assert_raises { Role.find(:does_not_exist) }
-  end
-
   def test_basic_setters_and_getters
     u = User.create!(role: 'guest', locale: 'de') # String assignment
     assert_equal Role.find(:guest), u.role
@@ -57,11 +53,6 @@ class UserTest < Minitest::Test
     assert Role.find(:moderator) < Role.find(:admin)
   end
 
-  def test_presence_validation
-    valentine = User.new
-    assert_raises(ActiveRecord::RecordInvalid) { valentine.save! }
-  end
-
   def test_alternative_column_name
     ben = User.create!(
       role:           Role.find(:moderator),
@@ -119,6 +110,19 @@ class UserTest < Minitest::Test
     assert_nil u.secondary_role
   end
 
+  ###---
+  # Testing failures
+  ###---
+
+  def test_presence_validation
+    valentine = User.new
+    assert_raises(ActiveRecord::RecordInvalid) { valentine.save! }
+  end
+
+  def test_missing_key
+    assert_raises { Role.find(:does_not_exist) }
+  end
+
   # Attempting to create a model with an invalid constant name should fail
   def test_invalid_key_update
     assert_raises(RuntimeError) { User.create!(role: :admin, locale: :de, preferred_locale: :invalid) }
@@ -137,4 +141,64 @@ class UserTest < Minitest::Test
     ActiveRecord::Base.connection.execute(sql)
     assert_raises(RuntimeError) { User.first.role }
   end
+
+  ###---
+  # Testing multiple anchormodel associations
+  ###---
+
+  def test_multi_basics
+    u = User.create!(role: 'guest', locale: 'de')
+    assert_equal(Set.new, u.animals)
+    # Adding
+    u.animals << 'cat'
+    assert_equal(Set.new([Animal.find(:cat)]), u.animals)
+    u.animals.add :dog
+    assert_equal(Set.new([Animal.find(:cat), Animal.find(:dog)]), u.animals)
+    u.animals.add Animal.find(:horse)
+    assert_equal(Set.new([Animal.find(:cat), Animal.find(:dog), Animal.find(:horse)]), u.animals)
+    # Removing
+    u.animals.delete 'cat'
+    assert_equal(Set.new([Animal.find(:dog), Animal.find(:horse)]), u.animals)
+    u.animals.delete :dog
+    assert_equal(Set.new([Animal.find(:horse)]), u.animals)
+    u.animals.delete Animal.find(:horse)
+    assert_equal(false, u.animals.any?)
+    # Setting
+    u.animals = %i[cat dog]
+    assert_equal(Set.new([Animal.find(:cat), Animal.find(:dog)]), u.animals)
+    # Clearing
+    u.animals.clear
+    assert_equal(false, u.animals.any?)
+  end
+
+  def test_multi_save_load
+    u = User.create!(role: 'guest', locale: 'de')
+    u.animals = %i[cat dog]
+    u.save!
+    freshly_loaded_u = User.first
+    assert_equal(Set.new([Animal.find(:cat), Animal.find(:dog)]), freshly_loaded_u.animals)
+  end
+
+  def test_multi_model_readers_and_writers
+    u = User.create!(role: 'guest', locale: 'de')
+    u.cat!
+    u.cat!
+    assert_equal(Set.new([Animal.find(:cat)]), u.animals) # tolerate no duplicate cat
+    assert_equal(true, u.cat?)
+    u.dog!
+    assert_equal(true, u.cat?)
+    assert_equal(true, u.dog?)
+    assert_equal(false, u.horse?)
+  end
+
+  def test_multi_model_scopes
+    u = User.create!(role: 'guest', locale: 'fr', animals: %w[dog cat])
+    v = User.create!(role: 'guest', locale: 'it', animals: %w[dog horse])
+    assert_equal(0, User.rat.count)
+    assert_equal(1, User.cat.count)
+    assert_equal(1, User.horse.count)
+    assert_equal(2, User.dog.count)
+    assert_equal(u.id, User.cat.first.id)
+    assert_equal(v.id, User.horse.first.id)
+  end
 end

data/test/dummy/app/anchormodels/animal.rb

@@ -0,0 +1,6 @@
+class Animal < Anchormodel
+  new :cat
+  new :dog
+  new :horse
+  new :rat
+end

data/test/dummy/app/models/user.rb

@@ -3,4 +3,5 @@ class User < ApplicationRecord
   belongs_to_anchormodel :secondary_role, Role, optional: true, model_readers: false, model_writers: false, model_scopes: false
   belongs_to_anchormodel :locale, model_methods: false
   belongs_to_anchormodel :preferred_locale, Locale
+  belongs_to_anchormodels :animals
 end