custom_fields 2.0.0.rc13 → 2.1.0.rc

data/README.textile

@@ -12,7 +12,7 @@ The main goals:
 
 h2. Requirements
 
-ActiveSupport 3.2.1, MongoDB 2.0 and Mongoid 2.4.3
+ActiveSupport 3.2.9, MongoDB 2.0 and Mongoid 2.4.12
 
 h2. Examples
 

data/lib/custom_fields/extensions/mongoid/relations/referenced/many.rb

@@ -24,6 +24,9 @@ module Mongoid #:nodoc:
         end
 
         alias_method_chain :build, :custom_fields
+
+        # new should point to the new build method
+        alias :new :build_with_custom_fields
       end
 
     end

data/lib/custom_fields/source.rb

@@ -101,6 +101,8 @@ module CustomFields
 
       # puts "old_metadata = #{old_metadata.klass.inspect} / #{old_metadata.object_id.inspect}" # DEBUG
 
+      # puts "[CustomFields] refresh_metadata_with_custom_fields, #{name.inspect}, self = #{self.inspect}"
+
       self.send(name).metadata = old_metadata.clone.tap do |metadata|
         # Rails.logger.debug "[CustomFields] refresh_metadata_with_custom_fields #{metadata.klass}" if defined?(Rails) # DEBUG
 

data/lib/custom_fields/target.rb

@@ -84,7 +84,6 @@ module CustomFields
 
     end
 
-
   end
 
 end

data/lib/custom_fields/target_helpers.rb

@@ -2,7 +2,7 @@ module CustomFields
 
   module TargetHelpers
 
-    # Returns the list of the getters dynamically based on the
+    # Return the list of the getters dynamically based on the
     # custom_fields recipe in order to get the formatted values
     # of the custom fields.
     # If a block is passed, then the list will be filtered accordingly with
@@ -15,7 +15,7 @@ module CustomFields
     #     rule['name] != 'foo'
     #   end
     #
-    # @returns [ List ] a list of method names (string)
+    # @return [ List ] a list of method names (string)
     #
     def custom_fields_methods(&filter)
       self.custom_fields_recipe['rules'].map do |rule|
@@ -28,12 +28,12 @@ module CustomFields
       end.compact.flatten
     end
 
-    # Lists all the attributes that are used by the custom_fields
+    # List all the setters that are used by the custom_fields
     # in order to get updated thru a html form for instance.
     #
-    # @returns [ List ] a list of attributes (string)
+    # @return [ List ] a list of method names (string)
     #
-    def custom_fields_safe_attributes
+    def custom_fields_safe_setters
       self.custom_fields_recipe['rules'].map do |rule|
         case rule['type'].to_sym
         when :date                    then "formatted_#{rule['name']}"
@@ -46,12 +46,47 @@ module CustomFields
       end.compact.flatten
     end
 
-    # Determines if the rule defined by the name is a "many" relationship kind.
+    # Build a hash for all the non-relationship fields
+    # meaning string, text, date, boolean, select, file types.
+    # This hash stores their name and their value.
+    #
+    # @return [ Hash ] Field name / formatted value
+    #
+    def custom_fields_basic_attributes
+      {}.tap do |hash|
+        self.non_relationship_custom_fields.each do |rule|
+          name, type = rule['name'], rule['type'].to_sym
+
+          # method of the custom getter
+          method_name = "#{type}_attribute_get"
+
+          hash.merge!(self.class.send(method_name, self, name))
+        end
+      end
+    end
+
+    # Set the values (and their related fields) for all the non-relationship fields
+    # meaning string, text, date, boolean, select, file types.
+    #
+    # @param [ Hash ] The attributes for the custom fields and their related fields.
+    #
+    def custom_fields_basic_attributes=(attributes)
+      self.non_relationship_custom_fields.each do |rule|
+        name, type = rule['name'], rule['type'].to_sym
+
+        # method of the custom getter
+        method_name = "#{type}_attribute_set"
+
+        self.class.send(method_name, self, name, attributes)
+      end
+    end
+
+    # Check if the rule defined by the name is a "many" relationship kind.
     # A "many" relationship includes "has_many" and "many_to_many"
     #
-    # @params [ String ] name The name of the rule
+    # @param [ String ] name The name of the rule
     #
-    # @returns [ Boolean ] True if the rule is a "many" relationship kind.
+    # @return [ Boolean ] True if the rule is a "many" relationship kind.
     #
     def is_a_custom_field_many_relationship?(name)
       rule = self.custom_fields_recipe['rules'].detect do |rule|
@@ -59,31 +94,59 @@ module CustomFields
       end
     end
 
-    # Returns the names of all the select fields of this object
+    # Return the rules of the custom fields which do not describe a relationship.
+    #
+    # @return [ Array ] List of rules (Hash)
+    #
+    def non_relationship_custom_fields
+      self.custom_fields_recipe['rules'].find_all do |rule|
+        !%w(belongs_to has_many many_to_many).include?(rule['type'])
+      end
+    end
+
+    # Return the rules of the custom fields which describe a relationship.
+    #
+    # @return [ Array ] List of rules (Hash)
+    #
+    def relationship_custom_fields
+      self.custom_fields_recipe['rules'].find_all do |rule|
+        %w(belongs_to has_many many_to_many).include?(rule['type'])
+      end
+    end
+
+    # Return the names of all the select fields of this object
     def select_custom_fields
       group_custom_fields 'select'
     end
 
-    # Returns the names of all the file custom_fields of this object
+    # Return the names of all the file custom_fields of this object
     #
-    # @returns [ Array ] List of names
+    # @return [ Array ] List of names
     #
     def file_custom_fields
       group_custom_fields 'file'
     end
 
-    # Returns the names of all the has_many custom_fields of this object
+    # Return the names of all the belongs_to custom_fields of this object
+    #
+    # @return [ Array ] List of names
+    #
+    def belongs_to_custom_fields
+      group_custom_fields 'belongs_to'
+    end
+
+    # Return the names of all the has_many custom_fields of this object
     #
-    # @returns [ Array ] Array of array [name, inverse_of]
+    # @return [ Array ] Array of array [name, inverse_of]
     #
     def has_many_custom_fields
       group_custom_fields('has_many') { |rule| [rule['name'], rule['inverse_of']] }
     end
 
-    # Returns the names of all the many_to_many custom_fields of this object.
+    # Return the names of all the many_to_many custom_fields of this object.
     # It also adds the property used to set/get the target ids.
     #
-    # @returns [ Array ] Array of array [name, <name in singular>_ids]
+    # @return [ Array ] Array of array [name, <name in singular>_ids]
     #
     def many_to_many_custom_fields
       group_custom_fields('many_to_many') { |rule| [rule['name'], "#{rule['name'].singularize}_ids"] }
@@ -91,13 +154,13 @@ module CustomFields
 
     protected
 
-    # Gets the names of the getter methods for a field.
+    # Get the names of the getter methods for a field.
     # The names depend on the field type.
     #
-    # @params [ String ] name Name of the field
-    # @params [ String ] type Type of the field
+    # @param [ String ] name Name of the field
+    # @param [ String ] type Type of the field
     #
-    # @returns [ Object ] A string or an array of names
+    # @return [ Object ] A string or an array of names
     #
     def custom_fields_getters_for(name, type)
       case type.to_sym

data/lib/custom_fields/types/boolean.rb

@@ -12,17 +12,36 @@ module CustomFields
 
         module ClassMethods
 
-          # Adds a boolean field
+          # Adds a boolean field. It can not be required.
           #
           # @param [ Class ] klass The class to modify
-          # @param [ Hash ] rule It contains the name of the field and if it is required or not
+          # @param [ Hash ] rule It contains the name of the field.
           #
           def apply_boolean_custom_field(klass, rule)
             klass.field rule['name'], :type => ::Boolean, :localize => rule['localized'] || false, :default => false
+          end
+
+          # Build a hash storing the boolean value (true / false) for
+          # a boolean custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the boolean custom field
+          #
+          # @return [ Hash ] field name => true / false
+          #
+          def boolean_attribute_get(instance, name)
+            default_attribute_get(instance, name)
+          end
 
-            if rule['required']
-              klass.validates_presence_of rule['name']
-            end
+          # Set the value for the instance and the boolean field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the boolean custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def boolean_attribute_set(instance, name, attributes)
+            self.default_attribute_set(instance, name, attributes)
           end
 
         end

data/lib/custom_fields/types/date.rb

@@ -31,6 +31,37 @@ module CustomFields
             end
           end
 
+          # Build a hash storing the formatted value for
+          # a date custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the date custom field
+          #
+          # @return [ Hash ] field name => formatted date
+          #
+          def date_attribute_get(instance, name)
+            if value = instance.send(:"formatted_#{name}")
+              { name => value, "formatted_#{name}" => value }
+            else
+              {}
+            end
+          end
+
+          # Set the value for the instance and the date field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the date custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def date_attribute_set(instance, name, attributes)
+            return unless attributes.key?(name) || attributes.key?("formatted_#{name}")
+
+            value = attributes[name] || attributes["formatted_#{name}"]
+
+            instance.send(:"formatted_#{name}=", value)
+          end
+
         end
 
         protected
@@ -38,7 +69,7 @@ module CustomFields
         def _set_formatted_date(name, value)
           if value.is_a?(::String) && !value.blank?
             date  = ::Date._strptime(value, I18n.t('date.formats.default'))
-            value = ::Date.new(date[:year], date[:mon], date[:mday])
+            value = date ? ::Date.new(date[:year], date[:mon], date[:mday]) : nil
           end
 
           self.send(:"#{name}=", value)

data/lib/custom_fields/types/default.rb

@@ -54,6 +54,45 @@ module CustomFields
             end
           end
 
+          # Build a hash storing the formatted (or not) values
+          # for a custom field of an instance.
+          # Since aliases are accepted, we return a hash. Beside,
+          # it is more convenient to use (ex: API).
+          # By default, it only returns hash with only one entry
+          # whose key is the second parameter and the value the
+          # value of the field in the instance given in first parameter.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the custom field
+          #
+          # @return [ Hash ] field name => formatted value or empty hash if no value
+          #
+          def default_attribute_get(instance, name)
+            unless (value = instance.send(name.to_sym)).nil?
+              { name => instance.send(name.to_sym) }
+            else
+              {}
+            end
+          end
+
+          # Set the value for the instance and the field specified by
+          # the 2 params.
+          # Since the value can come from different attributes and other
+          # params can modify the instance too, we need to pass a hash
+          # instead of a single value.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def default_attribute_set(instance, name, attributes)
+            # do not go further if the name is not one of the attributes keys.
+            return unless attributes.key?(name)
+
+            # simple assign
+            instance.send(:"#{name}=", attributes[name])
+          end
+
         end
 
       end

data/lib/custom_fields/types/file.rb

@@ -31,6 +31,35 @@ module CustomFields
             end
           end
 
+          # Build a hash storing the url for a file custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the file custom field
+          #
+          # @return [ Hash ] field name => url or empty hash if no file
+          #
+          def file_attribute_get(instance, name)
+            if instance.send(:"#{name}?")
+              value = instance.send(name.to_sym).url
+              { name => value, "#{name}_url" => value }
+            else
+              {}
+            end
+          end
+
+          # Set the value for the instance and the file field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the file custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def file_attribute_set(instance, name, attributes)
+            [name, "remote_#{name}_url", "remove_#{name}"].each do |_name|
+              self.default_attribute_set(instance, _name, attributes)
+            end.compact
+          end
+
         end
 
       end

data/lib/custom_fields/types/has_many.rb

@@ -38,9 +38,10 @@ module CustomFields
 
             position_name = "position_in_#{rule['inverse_of']}"
 
-            _order_by = rule['order_by'] || position_name.to_sym.asc
+            _order_by   = rule['order_by'] || position_name.to_sym.asc
+            _inverse_of = rule['inverse_of'].blank? ? nil : rule['inverse_of'] # an empty String can cause weird behaviours
 
-            klass.has_many rule['name'], :class_name => rule['class_name'], :inverse_of => rule['inverse_of'], :order => _order_by do
+            klass.has_many rule['name'], :class_name => rule['class_name'], :inverse_of => _inverse_of, :order => _order_by do
 
               def filtered(conditions = {}, order_by = nil)
                 list = conditions.empty? ? self : self.where(conditions)

data/lib/custom_fields/types/select.rb

@@ -89,6 +89,44 @@ module CustomFields
             end
           end
 
+          # Build a hash storing the values (id and option name) for
+          # a select custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the select custom field
+          #
+          # @return [ Hash ] fields: <name>: option name, <name>_id: id of the option
+          #
+          def select_attribute_get(instance, name)
+            if value = instance.send(name.to_sym)
+              {
+                name          => value,
+                "#{name}_id"  => instance.send(:"#{name}_id")
+              }
+            else
+              {}
+            end
+          end
+
+          # Set the value for the instance and the select field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the select custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def select_attribute_set(instance, name, attributes)
+            id_or_name  = attributes[name] || attributes["#{name}_id"]
+
+            return if id_or_name.nil?
+
+            option = _select_options(name).detect do |option|
+              [option['_id'], option['name']].include?(id_or_name)
+            end
+
+            instance.send(:"#{name}_id=", option['_id'])
+          end
+
           # Returns a list of documents groupes by select values defined in the custom fields recipe
           #
           # @param [ Class ] klass The class to modify

data/lib/custom_fields/types/string.rb

@@ -12,7 +12,7 @@ module CustomFields
 
         module ClassMethods
 
-          # Adds a string field
+          # Add a string field
           #
           # @param [ Class ] klass The class to modify
           # @param [ Hash ] rule It contains the name of the field and if it is required or not
@@ -21,6 +21,29 @@ module CustomFields
             apply_custom_field(klass, rule)
           end
 
+          # Build a hash storing the raw value for
+          # a string custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the string custom field
+          #
+          # @return [ Hash ] field name => raw value
+          #
+          def string_attribute_get(instance, name)
+            self.default_attribute_get(instance, name)
+          end
+
+          # Set the value for the instance and the string field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the string custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def string_attribute_set(instance, name, attributes)
+            self.default_attribute_set(instance, name, attributes)
+          end
+
         end
 
       end

data/lib/custom_fields/types/text.rb

@@ -31,6 +31,29 @@ module CustomFields
             apply_custom_field(klass, rule)
           end
 
+          # Build a hash storing the raw value for
+          # a string custom field of an instance.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the string custom field
+          #
+          # @return [ Hash ] field name => raw value
+          #
+          def text_attribute_get(instance, name)
+            default_attribute_get(instance, name)
+          end
+
+          # Set the value for the instance and the text field specified by
+          # the 2 params.
+          #
+          # @param [ Object ] instance An instance of the class enhanced by the custom_fields
+          # @param [ String ] name The name of the text custom field
+          # @param [ Hash ] attributes The attributes used to fetch the values
+          #
+          def text_attribute_set(instance, name, attributes)
+            self.default_attribute_set(instance, name, attributes)
+          end
+
         end
 
       end

data/lib/custom_fields/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module CustomFields #:nodoc
 
-  VERSION = '2.0.0.rc13'
+  VERSION = '2.1.0.rc'
 
 end

metadata

@@ -1,203 +1,203 @@
 --- !ruby/object:Gem::Specification
 name: custom_fields
 version: !ruby/object:Gem::Version
-  version: 2.0.0.rc13
   prerelease: 6
+  version: 2.1.0.rc
 platform: ruby
 authors:
 - Didier Lafforgue
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-28 00:00:00.000000000 Z
+date: 2012-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.12
   name: mongoid
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.4.9
+        version: 2.4.12
+- !ruby/object:Gem::Dependency
   type: :runtime
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.4.9
-- !ruby/object:Gem::Dependency
+        version: 3.2.9
   name: activesupport
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.2.1
+        version: 3.2.9
+- !ruby/object:Gem::Dependency
   type: :runtime
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.2.1
-- !ruby/object:Gem::Dependency
+        version: 0.2.1
   name: carrierwave-mongoid
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.2.1
-  type: :runtime
-  prerelease: false
+- !ruby/object:Gem::Dependency
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.2.1
-- !ruby/object:Gem::Dependency
+        version: 0.7.3
   name: yard
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.7.3
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.7.3
-- !ruby/object:Gem::Dependency
+        version: 1.3.1
   name: bson
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.3.1
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.3.1
-- !ruby/object:Gem::Dependency
   name: mongo
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.3.1
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.3.1
-- !ruby/object:Gem::Dependency
   name: bson_ext
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.3.1
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.3.1
-- !ruby/object:Gem::Dependency
+        version: 0.9.12
   name: mocha
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.9.12
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.12
-- !ruby/object:Gem::Dependency
+        version: '2.6'
   name: rspec
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.6'
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.6'
-- !ruby/object:Gem::Dependency
+        version: 0.6.1
   name: simplecov
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.6.1
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.6.1
-- !ruby/object:Gem::Dependency
+        version: 0.6.7
   name: database_cleaner
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.6.7
+- !ruby/object:Gem::Dependency
   type: :development
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.6.7
-- !ruby/object:Gem::Dependency
-  name: RedCloth
-  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 4.2.8
-  type: :development
+  name: RedCloth
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -256,10 +256,10 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
       segments:
       - 0
-      hash: 4293513692852653419
+      hash: -612963602801593079
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -268,7 +268,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: nowarning
-rubygems_version: 1.8.24
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Custom fields extension for Mongoid