activemodel 3.2.22.5 → 4.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 982cc00a572b16d30544a1a24969040bc7251498
-  data.tar.gz: 0e339f7d10f59eec64a80ff22f4cf39d4777890d
+  metadata.gz: a123b304fffb488ab66aab52d5fc0d41b0c0b511
+  data.tar.gz: 1890c14c3ab9251044e70e38f993d4c55707cb52
 SHA512:
-  metadata.gz: 9d68cb6eef4d157b7db04e67b43fbb2b90231deba15aa7ee8ebe2f7a5db6bb5539673e6f76bc3cc6f2c38395401b981716eaff1f830bfd1a8c308a1012bd232b
-  data.tar.gz: f472aeea89ec6c3e099c84d89d45d78c24784efe382a8fb5abab61a62f20212caf3328c07254bb93f1cc21dd44c33125a9b0d9ea8157aa62efc3d3d41665207c
+  metadata.gz: 882ad1f17ccb90c6a79d86a42d3f91685a1ece5e7ec63ed83be888a20d086ea38928aba2af650e13b79c1955d5f62d78c4b865311be1a8ae065197ee2a858aaa
+  data.tar.gz: 5452a0c0afabc7f3c3f536e670cb61244dd8d9236bfac6dd049da917dbe6bed0d110b4c6ed3bd0a374c7e09b42988cd937ae57cef83ff03e42a33aeea2cbb276

data/CHANGELOG.md

@@ -1,122 +1,143 @@
-## Rails 3.2.22 (Jun 16, 2015) ##
+## Rails 4.0.0.beta1 (February 25, 2013) ##
 
-* No changes.
+*   Add `ActiveModel::Validations::AbsenceValidator`, a validator to check the
+    absence of attributes.
 
+        class Person
+          include ActiveModel::Validations
 
-## Rails 3.2.19 (Jul 2, 2014) ##
+          attr_accessor :first_name
+          validates_absence_of :first_name
+        end
 
-* No changes.
+        person = Person.new
+        person.first_name = "John"
+        person.valid?
+        # => false
+        person.errors.messages
+        # => {:first_name=>["must be blank"]}
 
+    *Roberto Vasquez Angel*
 
-## Rails 3.2.18 (May 6, 2014) ##
+*   `[attribute]_changed?` now returns `false` after a call to `reset_[attribute]!`.
 
-* No changes.
+    *Renato Mascarenhas*
 
+*   Observers was extracted from Active Model as `rails-observers` gem.
 
-## Rails 3.2.17 (Feb 18, 2014) ##
+    *Rafael Mendonça França*
 
-* No changes.
+*   Specify type of singular association during serialization.
 
+    *Steve Klabnik*
 
-## Rails 3.2.16 (Dec 3, 2013) ##
+*   Fixed length validator to correctly handle `nil`. Fixes #7180.
 
-* No changes.
+    *Michal Zima*
 
+*   Removed dispensable `require` statements. Make sure to require `active_model` before requiring
+    individual parts of the framework.
 
-## Rails 3.2.15 (Oct 16, 2013) ##
+    *Yves Senn*
 
-*   No changes.
+*   Use BCrypt's `MIN_COST` in the test environment for speedier tests when using `has_secure_pasword`.
 
-## Rails 3.2.14 (Jul 22, 2013) ##
+    *Brian Cardarella + Jeremy Kemper + Trevor Turk*
 
-*   No changes.
+*   Add `ActiveModel::ForbiddenAttributesProtection`, a simple module to
+    protect attributes from mass assignment when non-permitted attributes are passed.
 
+    *DHH + Guillermo Iguaran*
 
-## Rails 3.2.13 (Mar 18, 2013) ##
+*   `ActiveModel::MassAssignmentSecurity` has been extracted from Active Model and the
+    `protected_attributes` gem should be added to Gemfile in order to use
+    `attr_accessible` and `attr_protected` macros in your models.
 
-*   Specify type of singular association during serialization *Steve Klabnik*
+    *Guillermo Iguaran*
 
-
-## Rails 3.2.12 (Feb 11, 2013) ##
-
-*   Fix issue with `attr_protected` where malformed input could circumvent protection.
-    CVE-2013-0276
-
-    *joernchen*
-
-
-## Rails 3.2.11 (Jan 8, 2013) ##
-
-*   No changes.
-
-
-## Rails 3.2.10 (Jan 2, 2013) ##
-
-*   No changes.
-
-
-## Rails 3.2.9 (Nov 12, 2012) ##
-
-*   Due to a change in builder, nil values and empty strings now generates
+*   Due to a change in builder, `nil` and empty strings now generate
     closed tags, so instead of this:
 
         <pseudonyms nil=\"true\"></pseudonyms>
 
-    It generates this:
+    it generates this:
 
         <pseudonyms nil=\"true\"/>
 
     *Carlos Antonio da Silva*
 
+*   Inclusion/exclusion validators accept a method name passed as a symbol to the
+    `:in` option.
 
-## Rails 3.2.8 (Aug 9, 2012) ##
-
-*   No changes.
-
+    This allows to use dynamic inclusion/exclusion values using methods, besides
+    the current lambda/proc support.
 
-## Rails 3.2.7 (Jul 26, 2012) ##
+    *Gabriel Sobrinho*
 
-* `validates_inclusion_of` and `validates_exclusion_of` now accept `:within` option as alias of `:in` as documented.
+*   `ActiveModel::Validation#validates` ability to pass custom exception to the
+    `:strict` option.
 
-* Fix the the backport of the object dup with the ruby 1.9.3p194.
+    *Bogdan Gusiev*
 
+*   Changed `ActiveModel::Serializers::Xml::Serializer#add_associations` to by default
+    propagate `:skip_types, :dasherize, :camelize` keys to included associations.
+    It can be overriden on each association by explicitly specifying the option on one
+    or more associations
 
-## Rails 3.2.6 (Jun 12, 2012) ##
+    *Anthony Alberto*
 
-*   No changes.
+*   Changed `ActiveModel::Serializers::JSON.include_root_in_json` default value to false.
+    Now, AM Serializers and AR objects have the same default behaviour. Fixes #6578.
 
+        class User < ActiveRecord::Base; end
 
-## Rails 3.2.4 (May 31, 2012) ##
+        class Person
+          include ActiveModel::Model
+          include ActiveModel::AttributeMethods
+          include ActiveModel::Serializers::JSON
 
-*   No changes.
+          attr_accessor :name, :age
 
+          def attributes
+            instance_values
+          end
+        end
 
-## Rails 3.2.3 (March 30, 2012) ##
+        user.as_json
+        => {"id"=>1, "name"=>"Konata Izumi", "age"=>16, "awesome"=>true}
+        # root is not included
 
-*   No changes.
+        person.as_json
+        => {"name"=>"Francesco", "age"=>22}
+        # root is not included
 
+    *Francesco Rodriguez*
 
-## Rails 3.2.2 (March 1, 2012) ##
+*   Passing false hash values to `validates` will no longer enable the corresponding validators.
 
-*   No changes.
+    *Steve Purcell*
 
+*   `ConfirmationValidator` error messages will attach to `:#{attribute}_confirmation` instead of `attribute`.
 
-## Rails 3.2.1 (January 26, 2012) ##
+    *Brian Cardarella*
 
-*   No changes.
+*   Added `ActiveModel::Model`, a mixin to make Ruby objects work with AP out of box.
 
+    *Guillermo Iguaran*
 
-## Rails 3.2.0 (January 20, 2012) ##
+*   `AM::Errors#to_json`: support `:full_messages` parameter.
 
-*   Deprecated `define_attr_method` in `ActiveModel::AttributeMethods`, because this only existed to
-    support methods like `set_table_name` in Active Record, which are themselves being deprecated. *Jon Leighton*
+    *Bogdan Gusiev*
 
-*   Add ActiveModel::Errors#added? to check if a specific error has been added *Martin Svalin*
+*   Trim down Active Model API by removing `valid?` and `errors.full_messages`.
 
-*   Add ability to define strict validation(with :strict => true option) that always raises exception when fails *Bogdan Gusiev*
+    *José Valim*
 
-*   Deprecate "Model.model_name.partial_path" in favor of "model.to_partial_path" *Grant Hutchins, Peter Jaros*
+*   When `^` or `$` are used in the regular expression provided to `validates_format_of`
+    and the `:multiline` option is not set to true, an exception will be raised. This is
+    to prevent security vulnerabilities when using `validates_format_of`. The problem is
+    described in detail in the Rails security guide.
 
-*   Provide mass_assignment_sanitizer as an easy API to replace the sanitizer behavior. Also support both :logger (default) and :strict sanitizer behavior *Bogdan Gusiev*
+    *Jan Berdajs + Egor Homakov*
 
-Please check [3-1-stable](https://github.com/rails/rails/blob/3-1-stable/activemodel/CHANGELOG.md) for previous changes.
+Please check [3-2-stable](https://github.com/rails/rails/blob/3-2-stable/activemodel/CHANGELOG.md) for previous changes.

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2004-2011 David Heinemeier Hansson
+Copyright (c) 2004-2013 David Heinemeier Hansson
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -1,7 +1,7 @@
 = Active Model -- model interfaces for Rails
 
 Active Model provides a known set of interfaces for usage in model classes.
-They allow for Action Pack helpers to interact with non-ActiveRecord models,
+They allow for Action Pack helpers to interact with non-Active Record models,
 for example. Active Model also helps building custom ORMs for use outside of
 the Rails framework.
 
@@ -9,10 +9,31 @@ Prior to Rails 3.0, if a plugin or gem developer wanted to have an object
 interact with Action Pack helpers, it was required to either copy chunks of
 code from Rails, or monkey patch entire helpers to make them handle objects
 that did not exactly conform to the Active Record interface. This would result
-in code duplication and fragile applications that broke on upgrades.
+in code duplication and fragile applications that broke on upgrades. Active
+Model solves this by defining an explicit API. You can read more about the
+API in <tt>ActiveModel::Lint::Tests</tt>.
 
-Active Model solves this. You can include functionality from the following
-modules:
+Active Model provides a default module that implements the basic API required
+to integrate with Action Pack out of the box: <tt>ActiveModel::Model</tt>.
+
+    class Person
+      include ActiveModel::Model
+
+      attr_accessor :name, :age
+      validates_presence_of :name
+    end
+
+    person = Person.new(name: 'bob', age: '18')
+    person.name # => 'bob'
+    person.age # => '18'
+    person.valid? # => true
+
+It includes model name introspections, conversions, translations and
+validations, resulting in a class suitable to be used with Action Pack.
+See <tt>ActiveModel::Model</tt> for more examples.
+
+Active Model also provides the following functionality to have ORM-like
+behavior out of the box:
 
 * Add attribute magic to objects
 
@@ -20,7 +41,7 @@ modules:
       include ActiveModel::AttributeMethods
 
       attribute_method_prefix 'clear_'
-      define_attribute_methods [:name, :age]
+      define_attribute_methods :name, :age
 
       attr_accessor :name, :age
 
@@ -54,7 +75,11 @@ modules:
 
 * Tracking value changes
 
-  The ActiveModel::Dirty module allows for tracking attribute changes:
+    class Person
+      include ActiveModel::Dirty
+
+      attr_accessor :name
+    end
 
     person = Person.new
     person.name # => nil
@@ -87,18 +112,14 @@ modules:
         errors.add(:name, "can not be nil") if name.nil?
       end
 
-      def ErrorsPerson.human_attribute_name(attr, options = {})
+      def self.human_attribute_name(attr, options = {})
         "Name"
       end
-
     end
 
     person.errors.full_messages
     # => ["Name can not be nil"]
 
-    person.errors.full_messages
-    # => ["Name can not be nil"]
-
   {Learn more}[link:classes/ActiveModel/Errors.html]
 
 * Model name introspection
@@ -112,22 +133,36 @@ modules:
 
   {Learn more}[link:classes/ActiveModel/Naming.html]
 
-* Observer support
-
-  ActiveModel::Observers allows your object to implement the Observer
-  pattern in a Rails App and take advantage of all the standard observer
-  functions.
-
-  {Learn more}[link:classes/ActiveModel/Observer.html]
-
 * Making objects serializable
 
   ActiveModel::Serialization provides a standard interface for your object
   to provide +to_json+ or +to_xml+ serialization.
 
+    class SerialPerson
+      include ActiveModel::Serialization
+
+      attr_accessor :name
+
+      def attributes
+        {'name' => name}
+      end
+    end
+
     s = SerialPerson.new
     s.serializable_hash   # => {"name"=>nil}
+
+    class SerialPerson
+      include ActiveModel::Serializers::JSON
+    end
+
+    s = SerialPerson.new
     s.to_json             # => "{\"name\":null}"
+
+    class SerialPerson
+      include ActiveModel::Serializers::Xml
+    end
+
+    s = SerialPerson.new
     s.to_xml              # => "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<serial-person...
 
   {Learn more}[link:classes/ActiveModel/Serialization.html]
@@ -163,7 +198,7 @@ modules:
 
 * Custom validators
 
-   class Person
+   class ValidatorPerson
      include ActiveModel::Validations
      validates_with HasNameValidator
      attr_accessor :name
@@ -171,7 +206,7 @@ modules:
 
    class HasNameValidator < ActiveModel::Validator
      def validate(record)
-      record.errors[:name] = "must exist" if record.name.blank?
+       record.errors[:name] = "must exist" if record.name.blank?
      end
    end
 
@@ -182,7 +217,7 @@ modules:
    p.valid?                  # =>  true
 
   {Learn more}[link:classes/ActiveModel/Validator.html]
-  
+
 
 == Download and installation
 
@@ -192,12 +227,14 @@ The latest version of Active Model can be installed with RubyGems:
 
 Source code can be downloaded as part of the Rails project on GitHub
 
-* https://github.com/rails/rails/tree/3-2-stable/activemodel
+* https://github.com/rails/rails/tree/master/activemodel
 
 
 == License
 
-Active Model is released under the MIT license.
+Active Model is released under the MIT license:
+
+* http://www.opensource.org/licenses/MIT
 
 
 == Support

data/lib/active_model.rb

@@ -1,5 +1,5 @@
 #--
-# Copyright (c) 2004-2011 David Heinemeier Hansson
+# Copyright (c) 2004-2013 David Heinemeier Hansson
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -21,9 +21,8 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
-activesupport_path = File.expand_path('../../../activesupport/lib', __FILE__)
-$:.unshift(activesupport_path) if File.directory?(activesupport_path) && !$:.include?(activesupport_path)
 require 'active_support'
+require 'active_support/rails'
 require 'active_model/version'
 
 module ActiveModel
@@ -35,13 +34,12 @@ module ActiveModel
   autoload :Conversion
   autoload :Dirty
   autoload :EachValidator, 'active_model/validator'
-  autoload :Errors
+  autoload :ForbiddenAttributesProtection
   autoload :Lint
-  autoload :MassAssignmentSecurity
+  autoload :Model
+  autoload :DeprecatedMassAssignmentSecurity
   autoload :Name, 'active_model/naming'
   autoload :Naming
-  autoload :Observer, 'active_model/observing'
-  autoload :Observing
   autoload :SecurePassword
   autoload :Serialization
   autoload :TestCase
@@ -49,13 +47,25 @@ module ActiveModel
   autoload :Validations
   autoload :Validator
 
+  eager_autoload do
+    autoload :Errors
+  end
+
   module Serializers
     extend ActiveSupport::Autoload
 
-    autoload :JSON
-    autoload :Xml
+    eager_autoload do
+      autoload :JSON
+      autoload :Xml
+    end
+  end
+
+  def eager_load!
+    super
+    ActiveModel::Serializer.eager_load!
   end
 end
 
-require 'active_support/i18n'
-I18n.load_path << File.dirname(__FILE__) + '/active_model/locale/en.yml'
+ActiveSupport.on_load(:i18n) do
+  I18n.load_path << File.dirname(__FILE__) + '/active_model/locale/en.yml'
+end