custom_fields 2.4.0.rc1 → 2.4.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0691b611ee56693347828a7d7c2d5e831d4bfdf4
-  data.tar.gz: 58c48324ef9366f1d1a36876bc0239c212bf5378
+  metadata.gz: 5356e1b094019ce1577efe0dd50bb50a53a036a6
+  data.tar.gz: 7a26e9aa7c23b01d5f37adacb25d13427f6c7328
 SHA512:
-  metadata.gz: 377cdb5985891770d23ec1f76a0bf6a93057c5ef31c5687b0c743b253f591f34ac2c728f26ca7e46ea2634723b2439ad2cbcfd78e5ad310ea50bd307a3fc512b
-  data.tar.gz: cf70d24c170faa1f6c27c864fcf06cf0f2a3ac5ce2bf7accad0d9e1bf22cd6967872a5df2c7bfe546b3cf8f69ae5becfb67c34e03e979ec6742ca9406e3b3532
+  metadata.gz: 2100b8484500a39c00e31221c92e30a6a39a121bf75505b59cee72e3ea0b73d206f6ac8fefd7043a979da41461b13f381942975961c94a9b21c6623c8bd7a9fc
+  data.tar.gz: 5acbfac290dc314b4b9371b2ffeabe92f0366488b6e800a25faa82afacee5e8444bea3a70f502eeb5ccd5f33deb4b4e3f988d0a8313da24cad6c2411a7fa4294

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2013-2015, Didier Lafforgue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,104 @@
+[CustomFields]
+==============
+
+[![Travis CI Status][Travis CI Status]][Travis CI]
+[![Gemnasium Status][Gemnasium Status]][Gemnasium]
+
+Manage custom fields to a Mongoid document or a collection. This module is one of the core features we implemented in
+our custom CMS, named LocomotiveCMS. Basically, its aim is to provide to editors a way to manage extra fields to a
+Mongoid document through, for instance, a web UI.
+
+The main goals:
+
+* Offering a very secure way to add, edit and delete extra fields to a Mongoid document.
+* Scoping the modifications added to a Mongoid document, so that other documents of the same class won't be updated.
+
+Requirements
+------------
+
+* MongoDB 2.x
+* Mongoid 4.x
+* ActiveSupport 4.2.x
+
+Examples
+--------
+
+### On a `has_many` relationship
+
+```ruby
+class Company
+  include CustomFields::Source
+
+  has_many :employees
+
+  custom_fields_for :employees
+end
+
+class Employee
+  include CustomFields::Target
+
+  field :name, String
+
+  belongs_to :company, inverse_of: :employees
+end
+
+company = Company.new
+company.employees_custom_fields.build label: 'His/her position', name: 'position', type: 'string', required: true
+
+company.save
+
+company.employees.build name: 'Michael Scott', position: 'Regional manager'
+
+another_company = Company.new
+employee = another_company.employees.build
+employee.position # Returns a `not defined method` error
+```
+
+### On the class itself
+
+**IN PROGRESS**
+
+```ruby
+class Company
+  custom_fields_for_itself
+end
+
+company = Company.new
+company.self_metadata_custom_fields.build label: 'Shipping Address', name: 'address', type: 'text'
+
+company.save
+
+company.self_metadata.address = '700 S Laflin, 60607 Chicago'
+
+another_company = Company.new
+other_company.self_metadata.address # Returns a `not defined method` error
+```
+
+Development
+-----------
+
+### Run specs
+
+Run `rspec` or `rake`.
+
+### Test Coverage
+
+Run `COVERAGE=true rspec` or `COVERAGE=true rake`.
+
+Contact
+-------
+
+Feel free to contact me at didier at nocoffee dot fr.
+
+License
+-------
+
+Copyright (c) 2013-2015 NoCoffee, released under the [MIT License (MIT)], see [LICENSE].
+
+[CustomFields]: https://github.com/locomotivecms/custom_fields "Custom fields extension for Mongoid."
+[Gemnasium]: https://gemnasium.com/locomotivecms/custom_fields "CustomFields at Gemnasium"
+[Gemnasium Status]: https://img.shields.io/gemnasium/locomotivecms/custom_fields.svg?style=flat "Gemnasium Status"
+[LICENSE]: https://raw.githubusercontent.com/locomotivecms/custom_fields/master/LICENSE "License"
+[MIT License (MIT)]: http://opensource.org/licenses/MIT "The MIT License (MIT)"
+[Travis CI]: https://travis-ci.org/locomotivecms/custom_fields "CustomFields at Travis CI"
+[Travis CI Status]: https://img.shields.io/travis/locomotivecms/custom_fields.svg?style=flat "Travis CI Status"

data/lib/custom_fields/extensions/mongoid/document.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid #:nodoc:
 
   module Document #:nodoc:

data/lib/custom_fields/extensions/mongoid/factory.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid #:nodoc:
 
   # Instantiates documents that came from the database.

data/lib/custom_fields/extensions/mongoid/fields/localized.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid #:nodoc:
   module Fields #:nodoc:
 
@@ -23,7 +22,18 @@ module Mongoid #:nodoc:
         elsif object.has_key?(locale.to_s)
           object[locale.to_s]
         elsif I18n.fallbacks?
-          object[I18n.fallbacks[locale].map(&:to_s).find { |loc| !object[loc].nil? }]
+          lookup_with_fallback(object)
+        else
+          nil
+        end
+      end
+
+      def lookup_with_fallback(object)
+        fallback_locales = I18n.fallbacks[locale].try(:map, &:to_s)
+
+        if fallback_locales
+          _locale = fallback_locales.find { |loc| !object[loc].nil? }
+          object[_locale]
         else
           nil
         end

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

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid # :nodoc:
   module Relations #:nodoc:
     module Referenced #:nodoc:

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

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid #:nodoc:
   module Relations #:nodoc:
     module Referenced #:nodoc:

data/lib/custom_fields/extensions/mongoid/validations/collection_size.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Mongoid
   module Validations
 

data/lib/custom_fields/extensions/origin/smash.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 module Origin
 
   # This is a smart hash for use with options and selectors.

data/lib/custom_fields/source.rb

@@ -172,9 +172,16 @@ module CustomFields
       operations['$set'].merge!({ 'custom_fields_recipe.version' => self.custom_fields_version(name) })
       collection, selector = self.send(name).collection, self.send(name).criteria.selector
 
-      # puts "selector = #{selector.inspect}, memo = #{attributes.inspect}" # DEBUG
+      # http://docs.mongodb.org/manual/reference/method/db.collection.update/#update-parameter
+      # The <update> document must contain only update operator expressions.
+      %w(set unset rename).each do |operation_name|
+        _fields = operations.delete("$#{operation_name}")
 
-      collection.find(selector).update operations, multi: true
+        next if _fields.empty?
+
+        _operation = { "$#{operation_name}" => _fields }
+        collection.find(selector).update _operation, multi: true
+      end
     end
 
     # If the localized attribute has been changed in at least one of the custom fields,

data/lib/custom_fields/types/has_many.rb

@@ -26,13 +26,13 @@ module CustomFields
           # @param [ Hash ] rule It contains the name of the relation and if it is required or not
           #
           def apply_has_many_custom_field(klass, rule)
-            # puts "#{klass.inspect}.has_many #{rule['name'].inspect}, class_name: #{rule['class_name'].inspect}, inverse_of: #{rule['inverse_of']}" # DEBUG
+            # puts "#{klass.inspect}.has_many #{rule['name'].inspect}, class_name: #{rule['class_name'].inspect}, inverse_of: #{rule['inverse_of']}, order_by: #{rule['order_by'].inspect}" # DEBUG
             position_name = "position_in_#{rule['inverse_of']}"
 
             _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: _inverse_of, order: _order_by do
+            klass.has_many rule['name'], class_name: rule['class_name'], inverse_of: _inverse_of, order: _order_by, validate: false do
 
               def filtered(conditions = {}, order_by = nil)
                 list = conditions.empty? ? self.unscoped : self.where(conditions)

data/lib/custom_fields/types/many_to_many.rb

@@ -28,11 +28,7 @@ module CustomFields
           def apply_many_to_many_custom_field(klass, rule)
             # puts "#{klass.inspect}.many_to_many #{rule['name'].inspect}, class_name: #{rule['class_name'].inspect} / #{rule['order_by']}" # DEBUG
 
-            klass.has_and_belongs_to_many rule['name'], class_name: rule['class_name'], inverse_of: rule['inverse_of'], order: rule['order_by'] do
-
-              # def at_least_one_element?
-              #   (base.send(metadata.key.to_sym).try(:size) || 0) > 0
-              # end
+            klass.has_and_belongs_to_many rule['name'], class_name: rule['class_name'], inverse_of: rule['inverse_of'], validate: false, order: rule['order_by'] do
 
               def filtered(conditions = {}, order_by = nil)
                 list = conditions.empty? ? self : self.where(conditions)
@@ -40,15 +36,30 @@ module CustomFields
                 if order_by
                   list.order_by(order_by)
                 else
-                  # use the natural order given by the initial array (ex: project_ids).
-                  # Warning: it returns an array and not a criteria object meaning it breaks the chain
-                  ids = base.send(relation_metadata.key.to_sym)
-                  list.entries.sort { |a, b| ids.index(a.id) <=> ids.index(b.id) }
+                  _naturally_ordered(list, order_by)
                 end
               end
 
               alias :ordered :filtered # backward compatibility + semantic purpose
 
+              def _naturally_ordered(criteria, order_by = nil)
+                # use the natural order given by the initial array (ex: project_ids).
+                # Warning: it returns an array and not a criteria object meaning it breaks the chain
+                ids = base.send(relation_metadata.key.to_sym)
+                criteria.entries.sort { |a, b| ids.index(a.id) <=> ids.index(b.id) }
+              end
+
+              def pluck_with_natural_order(*attributes)
+                criteria = self.only([:_id] + [*attributes])
+                _naturally_ordered(criteria).map do |entry|
+                  if attributes.size == 1
+                    entry.public_send(attributes.first.to_sym)
+                  else
+                    attributes.map { |name| entry.public_send(name.to_sym) }
+                  end
+                end
+              end
+
             end
 
             if rule['required']

data/lib/custom_fields/types/money.rb

@@ -107,7 +107,7 @@ module CustomFields
         protected
 
         def _set_money_defaults(names)
-          ::Money.assume_from_symbol = self.send(names[:allow_currency_from_symbol])
+          ::Monetize.assume_from_symbol = self.send(names[:allow_currency_from_symbol])
           ::Money.default_currency = self.send(names[:default_currency])
         end
 
@@ -129,7 +129,7 @@ module CustomFields
         def _set_money(_money, names)
           return if _money.blank?
           _set_money_defaults(names)
-          money = _money.kind_of?(Money) ? _money : ::Money.parse(_money)
+          money = _money.kind_of?(Money) ? _money : ::Monetize.parse(_money)
           self.write_attribute(names[:cents_field], money.cents)
           self.write_attribute(names[:currency_field], money.currency.iso_code)
         rescue

data/lib/custom_fields/types/select.rb

@@ -134,8 +134,8 @@ module CustomFields
           #
           def group_by_select_option(name, order_by = nil)
             name_id = "#{name}_id"
-            groups = self.each.group_by{|x| x.send(name_id)}.map do |(k, v)|
-              {name_id => k, "group" => v}
+            groups = self.each.group_by { |x| x.send(name_id) }.map do |(k, v)|
+              { name_id => k, 'group' => v }
             end
 
             _select_options(name).map do |option|

data/lib/custom_fields/version.rb

@@ -1,6 +1,5 @@
-# encoding: utf-8
 module CustomFields #:nodoc
 
-  VERSION = '2.4.0.rc1'
+  VERSION = '2.4.0.rc2'
 
 end

data/lib/custom_fields.rb

@@ -2,7 +2,7 @@ $:.unshift File.expand_path(File.dirname(__FILE__))
 
 require 'active_support'
 require 'carrierwave/mongoid'
-require 'money'
+require 'monetize'
 
 Money.use_i18n = false
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: custom_fields
 version: !ruby/object:Gem::Version
-  version: 2.4.0.rc1
+  version: 2.4.0.rc2
 platform: ruby
 authors:
 - Didier Lafforgue
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-07 00:00:00.000000000 Z
+date: 2015-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mongoid
@@ -16,128 +16,128 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.0.2
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: carrierwave-mongoid
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.8
+        version: 0.7.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.8
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
-  name: carrierwave-mongoid
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 4.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 4.2.1
 - !ruby/object:Gem::Dependency
-  name: money
+  name: monetize
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.1
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.1
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.3
+        version: '10.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.3
+        version: '10.4'
 - !ruby/object:Gem::Dependency
-  name: mocha
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.12
+        version: 0.10.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.12
+        version: 0.10.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.99'
+        version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.99'
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: 1.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 1.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
-  name: database_cleaner
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -151,45 +151,58 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.9.1
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: database_cleaner
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: RedCloth
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.8
+        version: 4.2.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.9
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.8
-description: Manage custom fields to a mongoid document or a collection. This module
-  is one of the core features we implemented in our custom cms named Locomotive.
-email:
-- didier@nocoffee.fr
+        version: 0.8.7
+description: Manage custom fields to a Mongoid document or a collection. This module
+  is one of the core features we implemented in our custom CMS, named LocomotiveCMS.
+email: didier@nocoffee.fr
 executables: []
 extensions: []
 extra_rdoc_files:
-- MIT-LICENSE
-- README.textile
+- LICENSE
+- README.md
 files:
-- MIT-LICENSE
-- README.textile
+- LICENSE
+- README.md
 - config/locales/de.yml
 - config/locales/en.yml
 - config/locales/fr.yml
@@ -230,8 +243,9 @@ files:
 - lib/custom_fields/types/tags.rb
 - lib/custom_fields/types/text.rb
 - lib/custom_fields/version.rb
-homepage: http://github.com/locomotivecms/custom_fields
-licenses: []
+homepage: https://github.com/locomotivecms/custom_fields
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -239,18 +253,18 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: 1.3.6
+      version: '2.4'
 requirements: []
-rubyforge_project: nowarning
-rubygems_version: 2.2.2
+rubyforge_project: 
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: Custom fields extension for Mongoid
+summary: Custom fields extension for Mongoid.
 test_files: []

data/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright (c) 2013 [Didier Lafforgue]
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -1,70 +0,0 @@
-"!https://secure.travis-ci.org/locomotivecms/custom_fields.png!":http://travis-ci.org/locomotivecms/custom_fields
-
-h1. CustomFields
-
-Manage custom fields to a mongoid document or a collection. This module is one of the core features we implemented in our custom cms, LocomotiveCMS.
-Basically, its aim is to provide to editors a way to manage extra fields to a Mongoid document through, for instance, a web UI.
-
-The main goals:
-
-* offering a very secure way to add / edit / delete extra fields to a Mongoid document
-* scoping the modifications added to a Mongoid document so that other documents of the same class won't be updated.
-
-h2. Requirements
-
-ActiveSupport 3.2.13, MongoDB 2.0 and Mongoid 3.1.3
-
-h2. Examples
-
-h3. On a has_many relationship
-
-bc.. class Company
-  include CustomFields::Source
-
-  has_many :employees
-
-  custom_fields_for :employees
-end
-
-class Employee
-  include CustomFields::Target
-
-  field :name, String
-
-  belongs_to :company, :inverse_of => :employees
-end
-
-company = Company.new
-company.employees_custom_fields.build :label => 'His/her position', :name => 'position', :type => 'string', :required => true
-
-company.save
-
-company.employees.build :name => 'Michael Scott', :position => 'Regional manager'
-
-another_company = Company.new
-employee = another_company.employees.build
-employee.position # returns a "not defined method" error
-
-h3. On the class itself
-
-[IN PROGRESS]
-
-bc.. class Company
-  custom_fields_for_itself
-end
-
-company = Company.new
-company.self_metadata_custom_fields.build :label => 'Shipping Address', :name => 'address', :type => 'text'
-
-company.save
-
-company.self_metadata.address = '700 S Laflin, 60607 Chicago'
-
-another_company = Company.new
-other_company.self_metadata.address # returns a "not defined method" error
-
-h2. Contact
-
-Feel free to contact me at didier at nocoffee dot fr.
-
-Copyright (c) 2013 NoCoffee, released under the MIT license