sorcery 0.8.5 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ece0272de9fa2ea03bbc1be9b2f9aa3b80e0f870
-  data.tar.gz: 5369015b55c79aab6aeeeae13328624a8e20b7c8
+  metadata.gz: f79fec92f71b24d1507e3848c0c943e3b8e7a6ed
+  data.tar.gz: bf2cfc0eb30778fbb3eb85f896a9b73811a179c4
 SHA512:
-  metadata.gz: 1a45a1696ebbcf7e4e8e248918389a38ea4555c263f12e290b1fdfd92c4e413d9713c29bbe98aa909ab9cb8642ff3e872a15405e6db9398afdf4f940521f68d5
-  data.tar.gz: aed312b559bbdecd335535df0814989b906d4768fe56382ae18a029f534fb0d9904e8540913e2c6dccc51de9d5e8d2096212a3dbf7f6b787df647987aa72076a
+  metadata.gz: d48170391dc1db75bb8bc88ce444ecc8d957796e0aaf96c29cafc4a01493689bc52e47ecaa5c0968c3aced147d623d2623f9dbe56e3dfdf46bf5309b005345f6
+  data.tar.gz: 4101544b567f3cb86c02bda20721a864b9c32fb688d62e64e7eee7fc0672614d06e0d8c004c8fa494113a9c834c1a09df1be91454ee00ee58865fcd31d01d7e0

data/.gitignore

@@ -51,4 +51,6 @@ spec/rails_app/log/*
 *.log
 *.sqlite3
 Gemfile*.lock
-.ruby-version
+gemfiles/*.lock
+.ruby-version
+tags

data/.travis.yml

@@ -2,14 +2,131 @@ language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
+  - 2.1
 
 services: mongodb
 
 gemfile:
   - Gemfile
-  - Gemfile.rails4
 
-script:
-  - "SORCERY_ORM=active_record bundle exec rake spec SPEC=spec/active_record"
-  - "SORCERY_ORM=mongoid bundle exec rake spec SPEC=spec/mongoid"
-  - "SORCERY_ORM=mongo_mapper bundle exec rake spec SPEC=spec/mongo_mapper"
+env:
+  - "SORCERY_ORM=active_record"
+  - "SORCERY_ORM=mongoid"
+  - "SORCERY_ORM=mongo_mapper"
+  - "SORCERY_ORM=data_mapper"
+
+before_script:
+  - mysql -e 'create database sorcery_test;'
+
+matrix:
+  allow_failures:
+    - rvm: :jruby
+
+  include:
+    - rvm: 1.9.3
+      gemfile: gemfiles/mongoid-rails41.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/mongoid-rails41.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.1
+      gemfile: gemfiles/mongoid-rails41.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: jruby
+      gemfile: gemfiles/mongoid-rails41.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/mongo_mapper-rails41.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/mongo_mapper-rails41.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 2.1
+      gemfile: gemfiles/mongo_mapper-rails41.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: jruby
+      gemfile: gemfiles/mongo_mapper-rails41.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/active_record-rails41.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/active_record-rails41.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 2.1
+      gemfile: gemfiles/active_record-rails41.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: jruby
+      gemfile: gemfiles/active_record-rails41.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/mongoid-rails40.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/mongoid-rails40.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.1
+      gemfile: gemfiles/mongoid-rails40.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: jruby
+      gemfile: gemfiles/mongoid-rails40.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/mongo_mapper-rails40.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/mongo_mapper-rails40.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 2.1
+      gemfile: gemfiles/mongo_mapper-rails40.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: jruby
+      gemfile: gemfiles/mongo_mapper-rails40.gemfile
+      env: "SORCERY_ORM=mongo_mapper"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/active_record-rails40.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/active_record-rails40.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 2.1
+      gemfile: gemfiles/active_record-rails40.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: jruby
+      gemfile: gemfiles/active_record-rails40.gemfile
+      env: "SORCERY_ORM=active_record"
+
+    - rvm: 1.9.3
+      gemfile: gemfiles/mongoid3-rails32.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.0.0
+      gemfile: gemfiles/mongoid3-rails32.gemfile
+      env: "SORCERY_ORM=mongoid"
+
+    - rvm: 2.1
+      gemfile: gemfiles/mongoid3-rails32.gemfile
+      env: "SORCERY_ORM=mongoid"

data/CHANGELOG.md

@@ -1,6 +1,42 @@
 # Changelog
 
-## 0.8.5 (not released)
+## 1.0 (not released yet)
+
+* Adapters (Mongoid, MongoMapper, DataMapper) are now separated from the core Sorcery repo and moved under `sorcery-rails` organization. Special thanks to @juike!
+
+## 0.9.0
+
+* Sending emails works with Rails 4.2 (thanks to @wooly)
+* Added `valid_password?` method
+* Added support for JIRA OAuth (thanks to @camilasan)
+* Added support for Heroku OAuth (thanks to @tyrauber)
+* Added support for Salesforce OAuth (thanks to @supremebeing7)
+* Added support for Mongoid 4
+* Fixed issues with empty passwords (thanks to @Borzik)
+* `find_by_provider_and_uid` method was replaced with `find_by_oauth_credentials`
+* Sorcery::VERSION constant was added to allow easy version check
+* `@user.setup_activation` method was made to be public (thanks @iTakeshi)
+* `current_users` method is deprecated
+* Fetching email from VK auth, thanks to @makaroni4
+* Add logged_in? method to test_helpers (thanks to @oriolbcn)
+* #locked? method is now public API (thanks @rogercampos)
+* Introduces a new User instance method `generate_reset_password_token` to generate a new reset password token without sending an email (thanks to @tbuehl)
+
+## 0.8.6
+
+* `current_user` returns `nil` instead of `false` if there's no user loggd in (#493)
+* MongoMapper adapter does not override `save!` method anymore. However due to ORM's lack of support for `validate: false` in `save!`, the combination of `validate: false` and `raise_on_failure: true` is not possible in MongoMapper. The errors will not be raised in this situation. (#151)
+* Fixed rename warnings for bcrypt-ruby
+* The way Sorcery adapters are included has been changed due to problem with multiple `included` blocks error in `ActiveSupport::Concern` class (#527)
+* Session timeout works with new cookie serializer introduced in Rails 4.1
+* Rails 4.1 compatibility bugs were fixed, this version is fully supported (#538)
+* VK providers now supports `scope` option
+* Support for DataMapper added
+* Helpers for integration tests were added
+* Fixed problems with special characters in user login attributes (MongoMapper & Mongoid)
+* Fixed remaining `password_confirmation` value - it is now cleared just like `password`
+
+## 0.8.5
 * Fixed add_provider_to_user with CamelCased authentications_class model (#382)
 * Fixed unlock_token_mailer_disabled to only disable automatic mailing (#467)
 * Make send_email_* methods easier to overwrite (#473)

data/Gemfile

@@ -1,24 +1,8 @@
 source 'https://rubygems.org'
-# Add dependencies required to use your gem here.
-# Example:
-#   gem "activesupport", ">= 2.3.5"
-gem 'oauth', "~> 0.4.4"
-gem 'oauth2', "~> 0.8.0"
-gem 'bcrypt-ruby', "~> 3.0.0"
 
-# Add dependencies to develop your gem here.
-# Include everything needed to run rake, tests, features, etc.
-
-gem 'abstract', '>= 1.0.0'
-gem "rails", "~> 3.2.15"
-gem 'json', ">= 1.7.7"
-gem "rspec", "~> 2.14.0"
-gem 'rspec-rails', "~> 2.14.0"
+gem 'rails', '~> 3.2'
 gem 'sqlite3'
-gem "yard", "~> 0.6.0"
-gem "bundler", ">= 1.1.0"
-gem 'simplecov', '>= 0.3.8', :require => false # Will install simplecov-html as a dependency
-gem 'timecop'
+gem 'pry'
 
 group :mongomapper do
   gem 'mongo_mapper'
@@ -28,3 +12,11 @@ group :mongoid do
   gem 'mongoid', "~> 2.4.4"
   gem 'bson_ext'
 end
+
+group :datamapper do
+  gem 'mysql2'
+  gem 'data_mapper'
+  gem 'dm-mysql-adapter'
+end
+
+gemspec

data/README.md

@@ -1,19 +1,20 @@
-[<img src="https://secure.travis-ci.org/NoamB/sorcery.png"
-/>](http://travis-ci.org/NoamB/sorcery) [<img
-src="https://codeclimate.com/github/NoamB/sorcery.png"
-/>](https://codeclimate.com/github/NoamB/sorcery)
+[![Build Status](https://travis-ci.org/NoamB/sorcery.svg?branch=master)](https://travis-ci.org/NoamB/sorcery)
+[![Code Climate](https://codeclimate.com/github/NoamB/sorcery.png)](https://codeclimate.com/github/NoamB/sorcery)
+[![Inline docs](http://inch-ci.org/github/NoamB/sorcery.png?branch=master)](http://inch-ci.org/github/NoamB/sorcery)
 
 # sorcery
-Magical Authentication for Rails 3 and 4. Supports ActiveRecord, Mongoid and
-MongoMapper.
+Magical Authentication for Rails 3 and 4. Supports ActiveRecord,
+DataMapper, Mongoid and MongoMapper.
 
 Inspired by restful_authentication, Authlogic and Devise. Crypto code taken
 almost unchanged from Authlogic. OAuth code inspired by OmniAuth and Ryan
 Bates's railscasts about it.
 
-**Rails 4 status:** basicly it works without issues, except
-[the issue with protect_from_forgery](https://github.com/NoamB/sorcery/issues/464).
-We will release new version soon, which will be updated for Rails 4.
+**What's happening now?** We are working on 1.0 version, which will include some API-breaking changes. It should be released about April 2015.
+Until then we'll continue releasing `0.9.x` version with bug fixed.
+
+**Rails 4 status:** [Sorcery 0.9.0](http://rubygems.org/gems/sorcery/versions/0.9.0) is fully tested and ready for Rails 4.0, 4.1 and 4.2.
+**Mongoid status:** Version 0.9.0 works with Mongoid 4.
 
 https://github.com/NoamB/sorcery/wiki/Simple-Password-Authentication
 
@@ -35,94 +36,116 @@ can write your own authentication flow. It was built with a few goals in mind:
 
 Hopefully, I've achieved this. If not, let me know.
 
-## Useful Links:
-
-Railscast: http://railscasts.com/episodes/283-authentication-with-sorcery
-
-Example Rails 3 app using sorcery:
-https://github.com/NoamB/sorcery-example-app
+## Useful Links
 
-Documentation: http://rubydoc.info/gems/sorcery
+[Documentation](http://rubydoc.info/gems/sorcery) |
+[Railscast](http://railscasts.com/episodes/283-authentication-with-sorcery) | [Simple tutorial](https://github.com/NoamB/sorcery/wiki/Simple-Password-Authentication) | [Example Rails 3 app](https://github.com/NoamB/sorcery-example-app)
 
-Check out the tutorials in the github wiki!
+Check out the tutorials in the [Wiki](https://github.com/NoamB/sorcery/wiki) for more!
 
 ## API Summary
 
 Below is a summary of the library methods. Most method names are self
 explaining and the rest are commented:
 
-    # core
-    require_login # this is a before filter
-    login(email, password, remember_me = false)
-    auto_login(user)# login without credentials
-    logout
-    logged_in?      # available to view
-    current_user    # available to view
-    redirect_back_or_to # used when a user tries to access a page while logged out, is asked to login, and we want to return him back to the page he originally wanted.
-    @user.external? # external users, such as facebook/twitter etc.
-    User.authenticates_with_sorcery!
-
-    # activity logging
-    current_users
-
-    # http basic auth
-    require_login_from_http_basic # this is a before filter
-
-    # external
-    login_at(provider) # sends the user to an external service (twitter etc.) to authenticate.
-    login_from(provider) # tries to login from the external provider's callback.
-    create_from(provider) # create the user in the local app db.
-
-    # remember me
-    auto_login(user, should_remember=false)  # login without credentials, optional remember_me
-    remember_me!
-    forget_me!
-
-    # reset password
-    User.load_from_reset_password_token(token)
-    @user.deliver_reset_password_instructions!
-    @user.change_password!(new_password)
-
-    # user activation
-    User.load_from_activation_token(token)
-    @user.activate!
+
+### core
+```ruby
+require_login # this is a before filter
+login(email, password, remember_me = false)
+auto_login(user)# login without credentials
+logout
+logged_in?      # available to view
+current_user    # available to view
+redirect_back_or_to # used when a user tries to access a page while logged out, is asked to login, and we want to return him back to the page he originally wanted.
+@user.external? # external users, such as facebook/twitter etc.
+User.authenticates_with_sorcery!
+```
+
+### http basic auth
+```ruby
+require_login_from_http_basic # this is a before filter
+```
+
+### external
+```ruby
+login_at(provider) # sends the user to an external service (twitter etc.) to authenticate.
+login_from(provider) # tries to login from the external provider's callback.
+create_from(provider) # create the user in the local app db.
+```
+
+### remember me
+```ruby
+auto_login(user, should_remember=false)  # login without credentials, optional remember_me
+remember_me!
+forget_me!
+```
+
+### reset password
+```ruby
+User.load_from_reset_password_token(token)
+@user.generate_reset_password_token! # if you want to send the email by youself
+@user.deliver_reset_password_instructions! # generates the token and sends the email
+@user.change_password!(new_password)
+```
+
+### user activation
+```ruby
+User.load_from_activation_token(token)
+@user.setup_activation
+@user.activate!
+```
 
 Please see the tutorials in the github wiki for detailed usage information.
 
-## Installation:
+## Installation
 
 If using bundler, first add 'sorcery' to your Gemfile:
 
-    gem "sorcery"
+```ruby
+gem "sorcery"
+```
 
 And run
 
-    bundle install
+```ruby
+bundle install
+```
 
 Otherwise simply
 
-    gem install sorcery
+```ruby
+gem install sorcery
+```
 
-## Rails configuration:
+## Rails configuration
 
-    rails generate sorcery:install
+```bash
+rails generate sorcery:install
+```
 
 This will generate the core migration file, the initializer file and the
 'User' model class.
 
-    rails generate sorcery:install remember_me reset_password
+```bash
+rails generate sorcery:install remember_me reset_password
+```
 
 This will generate the migrations files for remember_me and reset_password
 submodules and will create the initializer file (and add submodules to it),
 and create the 'User' model class.
 
-    rails generate sorcery:install --model Person
+```bash
+rails generate sorcery:install --model Person
+```
 
 This will generate the core migration file, the initializer and change the
 model class (in the initializer and migration files) to the class 'Person'
 (and its pluralized version, 'people')
 
-    rails generate sorcery:install http_basic_auth external remember_me --migrations
+```bash
+rails generate sorcery:install http_basic_auth external remember_me --only-submodules
+```
 
 This will generate only the migration files for the specified submodules and
 will add them to the initializer file.
@@ -138,25 +161,29 @@ After implementing the `delayed_job` into your project add the code below at
 the end of the `config/initializers/sorcery.rb` file. After that all emails
 will be sent asynchronously.
 
-    module Sorcery
-      module Model
-        module InstanceMethods
-          def generic_send_email(method, mailer)
-            config = sorcery_config
-            mail = config.send(mailer).delay.send(config.send(method), self)
-          end
-        end
+```ruby
+module Sorcery
+  module Model
+    module InstanceMethods
+      def generic_send_email(method, mailer)
+        config = sorcery_config
+        mail = config.send(mailer).delay.send(config.send(method), self)
       end
     end
+  end
+end
+```
 
 Sidekiq and Resque integrations are coming soon.
 
 ## Single Table Inheritance (STI) Support
 STI is supported via a single setting in config/initializers/sorcery.rb.
 
-## Full Features List by module:
+## Full Features List by module
+
+**Core** (see [lib/sorcery/model.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model.rb) and
+[lib/sorcery/controller.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/controller.rb)):
 
-Core (see lib/sorcery/model.rb and lib/sorcery/controller.rb):
 *   login/logout, optional return user to requested url on login, configurable
     redirect for non-logged-in users.
 *   password encryption, algorithms: bcrypt(default), md5, sha1, sha256,
@@ -165,7 +192,8 @@ Core (see lib/sorcery/model.rb and lib/sorcery/controller.rb):
 *   allow multiple fields to serve as username.
 
 
-User Activation (see lib/sorcery/model/submodules/user_activation.rb):
+**User Activation** (see [lib/sorcery/model/submodules/user_activation.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model/submodules/user_activation.rb)):
+
 *   User activation by email with optional success email.
 *   configurable attribute names.
 *   configurable mailer, method name, and attribute name.
@@ -173,37 +201,41 @@ User Activation (see lib/sorcery/model/submodules/user_activation.rb):
 *   Optionally prevent non-active users to login.
 
 
-Reset Password (see lib/sorcery/model/submodules/reset_password.rb):
+**Reset Password** (see [lib/sorcery/model/submodules/reset_password.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model/submodules/reset_password.rb)):
+
 *   Reset password with email verification.
 *   configurable mailer, method name, and attribute name.
 *   configurable temporary token expiration.
 *   configurable time between emails (hammering protection).
 
 
-Remember Me (see lib/sorcery/model/submodules/remember_me.rb):
+**Remember Me** (see [lib/sorcery/model/submodules/remember_me.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model/submodules/remember_me.rb)):
+
 *   Remember me with configurable expiration.
 *   configurable attribute names.
 
 
-Session Timeout (see lib/sorcery/controller/submodules/session_timeout.rb):
+**Session Timeout** (see [lib/sorcery/controller/submodules/session_timeout.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/controller/submodules/session_timeout.rb)):
+
 *   Configurable session timeout.
 *   Optionally session timeout will be calculated from last user action.
 
 
-Brute Force Protection (see
-lib/sorcery/model/submodules/brute_force_protection.rb):
+**Brute Force Protection** (see [lib/sorcery/model/submodules/brute_force_protection.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model/submodules/brute_force_protection.rb)):
+
 *   Brute force login hammering protection.
 *   configurable logins before lock and lock duration.
 
 
-Basic HTTP Authentication (see
-lib/sorcery/controller/submodules/http_basic_auth.rb):
+**Basic HTTP Authentication** (see [lib/sorcery/controller/submodules/http_basic_auth.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/controller/submodules/http_basic_auth.rb)):
+
 *   A before filter for requesting authentication with HTTP Basic.
 *   automatic login from HTTP Basic.
 *   automatic login is disabled if session key changed.
 
 
-Activity Logging (see lib/sorcery/model/submodules/activity_logging.rb):
+**Activity Logging** (see [lib/sorcery/model/submodules/activity_logging.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/model/submodules/activity_logging.rb)):
+
 *   automatic logging of last login, last logout, last activity time and IP
     address for last login.
 *   an easy method of collecting the list of currently logged in users.
@@ -211,14 +243,17 @@ Activity Logging (see lib/sorcery/model/submodules/activity_logging.rb):
     list of logged in users.
 
 
-External (see lib/sorcery/controller/submodules/external.rb):
-*   OAuth1 and OAuth2 support (currently twitter & facebook)
+**External** (see [lib/sorcery/controller/submodules/external.rb](https://github.com/NoamB/sorcery/blob/master/lib/sorcery/controller/submodules/external.rb)):
+
+*   OAuth1 and OAuth2 support (currently: Twitter, Facebook, Github, Google, Heroku,
+    LinkedIn, VK, LiveID, Xing, and Salesforce)
 *   configurable db field names and authentications table.
 
 
-## Next Planned Features:
+## Next Planned Features
 
 I've got some thoughts which include (unordered):
+
 *   Passing a block to encrypt, allowing the developer to define his own mix
     of salting and encrypting
 *   Forgot username, maybe as part of the reset_password module
@@ -243,23 +278,53 @@ In short, an app that works with x.3.1 should be able to upgrade to x.3.2 with
 no code changes. The same cannot be said about upgrading to x.4.0 and above,
 however.
 
+## DataMapper Support
+
+Important notes:
+
+*   Expected to work with DM adapters: dm-mysql-adapter,
+    dm-redis-adapter.
+*   Submodules DM adapter dependent: activity_logging (dm-mysql-adapter)
+*   Usage: include DataMapper::Resource in user model, follow sorcery
+    instructions (remember to add property id, validators and accessor
+attributes such as password and password_confirmation)
+*   Option downcase__username_before_authenticating and dm-mysql,
+    http://datamapper.lighthouseapp.com/projects/20609/tickets/1105-add-support-for-definingchanging-default-collation
+
 ## Upgrading
 
 Important notes while upgrading:
 
+*   If you are upgrading from <= **0.8.6** and you use Sorcery model methods in your app,
+    you might need to change them from `user.method` to `user.sorcery_adapter.method` and from
+    `User.method` to `User.sorcery_adapter_method`
+
+*   If you are upgrading from <= **0.8.5** and you're using Sorcery test helpers,
+    you need to change the way you include them to following code:
+
+    ```ruby
+    RSpec.configure do |config|
+      config.include Sorcery::TestHelpers::Rails::Controller, type: :controller
+      config.include Sorcery::TestHelpers::Rails::Integration, type: :feature
+    end
+    ```
+
 *   If are upgrading to **0.8.2** and use activity_logging feature with
     ActiveRecord, you will have to add a new column
     `last_login_from_ip_address`
     [#465](https://github.com/NoamB/sorcery/issues/465)
 *   Sinatra support existed until **v0.7.0** (including), but was dropped
     later due to being a maintenance nightmare.
-*   If upgrading from <= **0.6.1 to >= <b>0.7.0** you need to change
-    'username_attribute_name' to 'username_attribute_names' in initializer.
+*   If upgrading from <= **0.6.1 to >= **0.7.0** you need to change
+    'username
+    _attribute_name' to 'username_attribute_names' in initializer.
 *   If upgrading from <= **v0.5.1** to >= **v0.5.2** you need to explicitly
     set your user_class model in the initializer file.
 
-        # This line must come after the 'user config' block.
-        config.user_class = User
+    ```ruby
+    # This line must come after the 'user config' block.
+    config.user_class = User
+    ```
 
 
 ## Contributing to sorcery
@@ -294,7 +359,13 @@ email: shatrov@me.com
 
 twitter: @Kiiiir
 
+#### Grzegorz Witek
+
+email: arnvald.to@gmail.com
+
+twitter: @arnvald
+
 ## Copyright
 
-Copyright (c) 2010 Noam Ben Ari (nbenari@gmail.com). See LICENSE.txt for
+Copyright (c) 2010-2014 Noam Ben Ari (nbenari@gmail.com). See LICENSE.txt for
 further details.

data/gemfiles/active_record-rails40.gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'sqlite3', platform: :mri
+gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
+gem 'rails', '~> 4.0.1'
+
+gemspec path: '..'

data/gemfiles/active_record-rails41.gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'sqlite3', platform: :mri
+gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
+gem 'rails', '~> 4.1.0'
+
+gemspec path: '..'

data/gemfiles/mongo_mapper-rails40.gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gem 'rails', '~> 4.0.0'
+
+gem 'mongo_mapper', github: 'mongomapper/mongomapper'
+gem 'sqlite3', platform: :mri
+gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
+
+gemspec path: '..'

data/gemfiles/mongo_mapper-rails41.gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gem 'rails', '~> 4.1.0'
+
+gem 'mongo_mapper', github: 'mongomapper/mongomapper'
+gem 'sqlite3', platform: :mri
+gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
+
+gemspec path: '..'