anchormodel 0.1.5 → 0.2.1

data/doc/index.html

@@ -6,7 +6,7 @@
 <title>
   File: README
   
-    &mdash; Documentation by YARD 0.9.28
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -261,15 +261,87 @@
 <p>If you want to have multiple attributes in the same model pointing to the same Anchormodel, you need to disable <code>model_methods</code> for at least one of them (otherwise the model methods will clash in your model class):</p>
 
 <pre class="code ruby"><code class="ruby"><span class='comment'># app/models/user.rb
-</span>  <span class='id identifier rubyid_belongs_to_anchormodel'>belongs_to_anchormodel</span> <span class='symbol'>:role</span>
-  <span class='id identifier rubyid_belongs_to_anchormodel'>belongs_to_anchormodel</span> <span class='symbol'>:secondary_role</span><span class='comma'>,</span> <span class='const'>Role</span><span class='comma'>,</span> <span class='label'>model_methods:</span> <span class='kw'>false</span>
+</span><span class='id identifier rubyid_belongs_to_anchormodel'>belongs_to_anchormodel</span> <span class='symbol'>:role</span>
+<span class='id identifier rubyid_belongs_to_anchormodel'>belongs_to_anchormodel</span> <span class='symbol'>:secondary_role</span><span class='comma'>,</span> <span class='const'>Role</span><span class='comma'>,</span> <span class='label'>model_methods:</span> <span class='kw'>false</span>
+</code></pre>
+
+<h1 id="label-Attaching+multiple+Anchormodels+to+an+attribute+-28similar+to+a+has_many+collection-29">Attaching multiple Anchormodels to an attribute (similar to a has_many collection)</h1>
+
+<p>Collections of Anchormodels are supported. Assuming that your <code>User</code> can have multiple <code>Role</code> anchormodels, your code can look as follows:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='comment'># app/models/user.rb
+</span><span class='id identifier rubyid_belongs_to_anchormodels'>belongs_to_anchormodels</span> <span class='symbol'>:roles</span>
+</code></pre>
+
+<p>The method is deliberately called <code>belongs_to...</code> and not <code>has_many...</code> in order to indicate that the key is stored in a column of the model in which you are calling it. The rule of thumb for using a collection of Anchormodels is:</p>
+<ul><li>
+<p>Your column should be of type <code>string</code>, just like with the singular <code>belongs_to_anchormodel</code>.</p>
+</li><li>
+<p>Anchormodels will be stored in string form, separated by the <code>,</code> character</p>
+</li><li>
+<p>When reading the attribute, you will get a <code>Set</code>, thus duplicates are avoided.</p>
+</li></ul>
+
+<p>Example usage for a User model with multiple roles as shown above:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_u'>u</span> <span class='op'>=</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
+<span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span> <span class='op'>=</span> <span class='qsymbols_beg'>%i[</span><span class='tstring_content'>moderator</span><span class='words_sep'> </span><span class='tstring_content'>admin</span><span class='tstring_end'>]</span></span> <span class='comment'># this will replace the user&#39;s roles by the two specified
+</span><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span> <span class='comment'># this will return a set of two Role Anchormodel instances, moderator and role
+</span><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_guest!'>guest!</span> <span class='comment'># this will add the role `guest` to the user&#39;s roles
+</span><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_guest?'>guest?</span> <span class='comment'># this will query whether the role `guest` is part of the user&#39;s roles
+</span><span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_moderator'>moderator</span> <span class='comment'># This will return all users that have the moderator role as part of their roles
+</span></code></pre>
+
+<p>For modifying a collection of Anchormodels, the following methods are implemented, the first three accepting a String, Symbol or Anchormodel:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span><span class='period'>.</span><span class='id identifier rubyid_add'>add</span><span class='lparen'>(</span><span class='symbol'>:moderator</span><span class='rparen'>)</span> <span class='comment'># same as u.moderator!
+</span><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span> <span class='op'>&lt;&lt;</span> <span class='symbol'>:moderator</span> <span class='comment'># alias of add
+</span><span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='symbol'>:moderator</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_u'>u</span><span class='period'>.</span><span class='id identifier rubyid_roles'>roles</span><span class='period'>.</span><span class='id identifier rubyid_clear'>clear</span>
+</code></pre>
+
+<p>Note that no other methods of Set are overwritten at this point - if you use any other methods mutating the underlying Set, your changes will not be applied.</p>
+
+<h2 id="label-Basic+rails+form+for+a+collection+of+Anchormodels">Basic rails form for a collection of Anchormodels</h2>
+
+<pre class="code ruby"><code class="ruby">&lt;%= form_with(model: user) do |form| %&gt;
+  &lt;%# ... %&gt;
+  &lt;%= form.collection_select :role, Role.all, :key, :label, multiple: true %&gt;
+  &lt;%# ... %&gt;
+&lt;% end %&gt;
+</code></pre>
+
+<p>If you get an error due to unpermitted params, make sure, you are allowing array-style parameters: <code>params.require(:user).permit(roles: [])</code></p>
+
+<h2 id="label-SimpleForm+for+a+collection+of+Anchormodels">SimpleForm for a collection of Anchormodels</h2>
+
+<p>Anchormodel’s <a href="https://github.com/heartcombo/simple_form">simple_form</a> support also includes collections of Anchormodels.</p>
+
+<p>Just like in the single Anchormodel implementation, a select input can be provided with:</p>
+
+<pre class="code ruby"><code class="ruby">&lt;%= simple_form_for user do |f| %&gt;
+  &lt;%# ... %&gt;
+  &lt;%= f.input :role %&gt;
+  &lt;%# ... %&gt;
+&lt;% end %&gt;
+</code></pre>
+
+<p>The input figures out automatically that it is operating on a collection, so the form code is the same as for a single Anchormodel.</p>
+
+<p>However, radio buttons are unsuitable for collections, so use check boxes instead:</p>
+
+<pre class="code ruby"><code class="ruby">&lt;%= simple_form_for user do |f| %&gt;
+  &lt;%# ... %&gt;
+  &lt;%= f.input :role, as: :anchormodel_check_boxes %&gt;
+  &lt;%# ... %&gt;
+&lt;% end %&gt;
 </code></pre>
 </div></div>
 
       <div id="footer">
-  Generated on Wed Apr 24 17:01:46 2024 by
+  Generated on Wed May 22 11:24:43 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.28 (ruby-3.2.2).
+  0.9.34 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/method_list.html

@@ -78,21 +78,29 @@
 
   <li class="odd ">
     <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>
+      <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/ModelMixin.html#belongs_to_anchormodel-class_method" title="Anchormodel::ModelMixin.belongs_to_anchormodel (method)">belongs_to_anchormodel</a></span>
-      <small>Anchormodel::ModelMixin</small>
+      <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>
     </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 +108,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 +116,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 +124,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>
@@ -189,6 +205,14 @@
   
 
   <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>
       <small>Anchormodel::Attribute</small>
@@ -196,6 +220,14 @@
   </li>
   
 
+  <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>
@@ -205,6 +237,14 @@
   
 
   <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>
       <small>Anchormodel::ActiveModelTypeValueSingle</small>
@@ -212,7 +252,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#setup!-class_method" title="Anchormodel.setup! (method)">setup!</a></span>
       <small>Anchormodel</small>
@@ -220,7 +260,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel.html#to_s-instance_method" title="Anchormodel#to_s (method)">#to_s</a></span>
       <small>Anchormodel</small>
@@ -228,7 +268,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Anchormodel/ActiveModelTypeValueSingle.html#type-instance_method" title="Anchormodel::ActiveModelTypeValueSingle#type (method)">#type</a></span>
       <small>Anchormodel::ActiveModelTypeValueSingle</small>

data/doc/top-level-namespace.html

@@ -6,7 +6,7 @@
 <title>
   Top Level Namespace
   
-    &mdash; Documentation by YARD 0.9.28
+    &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>, <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>
+      <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 Wed Apr 24 17:01:46 2024 by
+  Generated on Wed May 22 11:24:43 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.28 (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/helpers/anchormodel_inputs_common.rb

@@ -14,20 +14,24 @@ did you `include Anchormodel::ModelMixin` in your `application_record.rb`? Affec
 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)
-            selected_key = selected_am&.key || am_class.all.first
+            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.to_s,
-            include_blank: am_attr.optional
+            sf_selection_key =>       selected_key
           )
 
           @collection = collect(am_class.all)

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,9 +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'