RubyGems - devise - Versions diffs - 3.2.4 → 4.0.0 - Mend

devise 3.2.4 → 4.0.0

Potentially problematic release.

This version of devise might be problematic. Click here for more details.

Files changed (178) hide show

checksums.yaml +4 -4
data/.gitignore +0 -1
data/.travis.yml +33 -17
data/CHANGELOG.md +57 -1033
data/CODE_OF_CONDUCT.md +22 -0
data/CONTRIBUTING.md +2 -0
data/Gemfile +5 -5
data/Gemfile.lock +138 -115
data/MIT-LICENSE +1 -1
data/README.md +124 -65
data/Rakefile +2 -1
data/app/controllers/devise/confirmations_controller.rb +7 -3
data/app/controllers/devise/omniauth_callbacks_controller.rb +8 -4
data/app/controllers/devise/passwords_controller.rb +16 -6
data/app/controllers/devise/registrations_controller.rb +22 -10
data/app/controllers/devise/sessions_controller.rb +42 -14
data/app/controllers/devise/unlocks_controller.rb +5 -2
data/app/controllers/devise_controller.rb +63 -29
data/app/mailers/devise/mailer.rb +4 -0
data/app/views/devise/confirmations/new.html.erb +7 -3
data/app/views/devise/mailer/password_change.html.erb +3 -0
data/app/views/devise/passwords/edit.html.erb +14 -5
data/app/views/devise/passwords/new.html.erb +7 -3
data/app/views/devise/registrations/edit.html.erb +19 -9
data/app/views/devise/registrations/new.html.erb +18 -7
data/app/views/devise/sessions/new.html.erb +16 -7
data/app/views/devise/shared/{_links.erb → _links.html.erb} +2 -2
data/app/views/devise/unlocks/new.html.erb +7 -3
data/bin/test +13 -0
data/config/locales/en.yml +19 -16
data/devise.gemspec +3 -4
data/gemfiles/{Gemfile.rails-3.2-stable → Gemfile.rails-4.1-stable} +6 -6
data/gemfiles/Gemfile.rails-4.1-stable.lock +167 -0
data/gemfiles/{Gemfile.rails-head → Gemfile.rails-4.2-stable} +6 -6
data/gemfiles/Gemfile.rails-4.2-stable.lock +189 -0
data/gemfiles/Gemfile.rails-5.0-beta +37 -0
data/gemfiles/Gemfile.rails-5.0-beta.lock +199 -0
data/lib/devise/controllers/helpers.rb +94 -27
data/lib/devise/controllers/rememberable.rb +9 -2
data/lib/devise/controllers/sign_in_out.rb +2 -9
data/lib/devise/controllers/store_location.rb +11 -3
data/lib/devise/controllers/url_helpers.rb +7 -7
data/lib/devise/encryptor.rb +22 -0
data/lib/devise/failure_app.rb +72 -23
data/lib/devise/hooks/activatable.rb +3 -4
data/lib/devise/hooks/csrf_cleaner.rb +3 -1
data/lib/devise/hooks/timeoutable.rb +13 -8
data/lib/devise/mailers/helpers.rb +1 -1
data/lib/devise/mapping.rb +6 -2
data/lib/devise/models/authenticatable.rb +32 -28
data/lib/devise/models/confirmable.rb +55 -22
data/lib/devise/models/database_authenticatable.rb +32 -19
data/lib/devise/models/lockable.rb +5 -5
data/lib/devise/models/recoverable.rb +44 -20
data/lib/devise/models/rememberable.rb +54 -27
data/lib/devise/models/timeoutable.rb +0 -6
data/lib/devise/models/trackable.rb +5 -3
data/lib/devise/models/validatable.rb +3 -3
data/lib/devise/models.rb +1 -1
data/lib/devise/omniauth/url_helpers.rb +62 -4
data/lib/devise/parameter_sanitizer.rb +176 -61
data/lib/devise/rails/routes.rb +76 -59
data/lib/devise/rails/warden_compat.rb +1 -10
data/lib/devise/rails.rb +2 -11
data/lib/devise/strategies/authenticatable.rb +15 -6
data/lib/devise/strategies/database_authenticatable.rb +5 -4
data/lib/devise/strategies/rememberable.rb +13 -3
data/lib/devise/test_helpers.rb +12 -7
data/lib/devise/token_generator.rb +1 -41
data/lib/devise/version.rb +1 -1
data/lib/devise.rb +150 -58
data/lib/generators/active_record/devise_generator.rb +28 -4
data/lib/generators/active_record/templates/migration.rb +3 -3
data/lib/generators/active_record/templates/migration_existing.rb +3 -3
data/lib/generators/devise/controllers_generator.rb +44 -0
data/lib/generators/devise/install_generator.rb +15 -0
data/lib/generators/devise/orm_helpers.rb +1 -18
data/lib/generators/devise/views_generator.rb +14 -3
data/lib/generators/templates/README +1 -1
data/lib/generators/templates/controllers/README +14 -0
data/lib/generators/templates/controllers/confirmations_controller.rb +28 -0
data/lib/generators/templates/controllers/omniauth_callbacks_controller.rb +28 -0
data/lib/generators/templates/controllers/passwords_controller.rb +32 -0
data/lib/generators/templates/controllers/registrations_controller.rb +60 -0
data/lib/generators/templates/controllers/sessions_controller.rb +25 -0
data/lib/generators/templates/controllers/unlocks_controller.rb +28 -0
data/lib/generators/templates/devise.rb +36 -28
data/lib/generators/templates/markerb/confirmation_instructions.markerb +1 -1
data/lib/generators/templates/markerb/password_change.markerb +3 -0
data/lib/generators/templates/markerb/reset_password_instructions.markerb +1 -1
data/lib/generators/templates/markerb/unlock_instructions.markerb +1 -1
data/lib/generators/templates/simple_form_for/passwords/edit.html.erb +1 -1
data/lib/generators/templates/simple_form_for/registrations/new.html.erb +1 -1
data/lib/generators/templates/simple_form_for/sessions/new.html.erb +2 -2
data/test/controllers/custom_registrations_controller_test.rb +40 -0
data/test/controllers/custom_strategy_test.rb +7 -5
data/test/controllers/helper_methods_test.rb +22 -0
data/test/controllers/helpers_test.rb +41 -1
data/test/controllers/inherited_controller_i18n_messages_test.rb +51 -0
data/test/controllers/internal_helpers_test.rb +19 -15
data/test/controllers/load_hooks_controller_test.rb +19 -0
data/test/controllers/passwords_controller_test.rb +5 -4
data/test/controllers/sessions_controller_test.rb +24 -21
data/test/controllers/url_helpers_test.rb +7 -1
data/test/devise_test.rb +48 -8
data/test/failure_app_test.rb +107 -19
data/test/generators/active_record_generator_test.rb +6 -26
data/test/generators/controllers_generator_test.rb +48 -0
data/test/generators/install_generator_test.rb +14 -3
data/test/generators/views_generator_test.rb +8 -1
data/test/helpers/devise_helper_test.rb +10 -12
data/test/integration/authenticatable_test.rb +37 -21
data/test/integration/confirmable_test.rb +54 -14
data/test/integration/database_authenticatable_test.rb +12 -1
data/test/integration/http_authenticatable_test.rb +4 -5
data/test/integration/lockable_test.rb +10 -9
data/test/integration/omniauthable_test.rb +13 -11
data/test/integration/recoverable_test.rb +28 -15
data/test/integration/registerable_test.rb +41 -33
data/test/integration/rememberable_test.rb +51 -7
data/test/integration/timeoutable_test.rb +23 -22
data/test/integration/trackable_test.rb +3 -3
data/test/mailers/confirmation_instructions_test.rb +10 -10
data/test/mailers/reset_password_instructions_test.rb +8 -8
data/test/mailers/unlock_instructions_test.rb +8 -8
data/test/mapping_test.rb +7 -0
data/test/models/authenticatable_test.rb +11 -1
data/test/models/confirmable_test.rb +91 -42
data/test/models/database_authenticatable_test.rb +26 -6
data/test/models/lockable_test.rb +29 -17
data/test/models/recoverable_test.rb +74 -7
data/test/models/rememberable_test.rb +68 -94
data/test/models/trackable_test.rb +28 -0
data/test/models/validatable_test.rb +9 -17
data/test/models_test.rb +15 -6
data/test/omniauth/url_helpers_test.rb +4 -7
data/test/orm/active_record.rb +6 -1
data/test/parameter_sanitizer_test.rb +103 -53
data/test/rails_app/app/active_record/user.rb +1 -0
data/test/rails_app/app/active_record/user_on_engine.rb +7 -0
data/test/rails_app/app/active_record/user_on_main_app.rb +7 -0
data/test/rails_app/app/active_record/user_without_email.rb +8 -0
data/test/rails_app/app/controllers/admins_controller.rb +1 -6
data/test/rails_app/app/controllers/application_controller.rb +5 -2
data/test/rails_app/app/controllers/application_with_fake_engine.rb +30 -0
data/test/rails_app/app/controllers/custom/registrations_controller.rb +31 -0
data/test/rails_app/app/controllers/home_controller.rb +5 -1
data/test/rails_app/app/controllers/users/omniauth_callbacks_controller.rb +3 -3
data/test/rails_app/app/controllers/users_controller.rb +6 -6
data/test/rails_app/app/mailers/users/from_proc_mailer.rb +3 -0
data/test/rails_app/app/mailers/users/mailer.rb +0 -9
data/test/rails_app/app/mailers/users/reply_to_mailer.rb +4 -0
data/test/rails_app/app/mongoid/user_on_engine.rb +39 -0
data/test/rails_app/app/mongoid/user_on_main_app.rb +39 -0
data/test/rails_app/app/mongoid/user_without_email.rb +33 -0
data/test/rails_app/config/application.rb +3 -3
data/test/rails_app/config/boot.rb +4 -4
data/test/rails_app/config/environments/production.rb +6 -2
data/test/rails_app/config/environments/test.rb +13 -3
data/test/rails_app/config/initializers/devise.rb +15 -16
data/test/rails_app/config/initializers/secret_token.rb +1 -6
data/test/rails_app/config/routes.rb +23 -3
data/test/rails_app/db/migrate/20100401102949_create_tables.rb +2 -2
data/test/rails_app/lib/shared_user.rb +1 -1
data/test/rails_app/lib/shared_user_without_email.rb +26 -0
data/test/rails_app/lib/shared_user_without_omniauth.rb +13 -0
data/test/rails_test.rb +9 -0
data/test/routes_test.rb +33 -16
data/test/support/assertions.rb +2 -3
data/test/support/helpers.rb +13 -6
data/test/support/http_method_compatibility.rb +51 -0
data/test/support/integration.rb +4 -4
data/test/support/webrat/integrations/rails.rb +9 -0
data/test/test_helper.rb +7 -0
data/test/test_helpers_test.rb +43 -38
data/test/test_models.rb +3 -3
metadata +77 -23
data/gemfiles/Gemfile.rails-4.0-stable +0 -29

data/CODE_OF_CONDUCT.md ADDED Viewed

@@ -0,0 +1,22 @@
+# Contributor Code of Conduct
+As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.
+Examples of unacceptable behavior by participants include:
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. By adopting this Code of Conduct, project maintainers commit themselves to fairly and consistently applying these principles to every aspect of managing this project. Project maintainers who do not follow or enforce the Code of Conduct may be permanently removed from the project team.
+This code of conduct applies both within project spaces and in public spaces when an individual is representing the project or its community.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by sending an email to [conduct@plataformatec.com.br](conduct@plataformatec.com.br) or contacting one or more of the project maintainers.
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.2.0, available at [http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)

data/CONTRIBUTING.md CHANGED Viewed

@@ -8,6 +8,8 @@
 4) When reporting an issue, include Rails, Devise and Warden versions. If you are getting exceptions, please include the full backtrace.
+5) Notice that all of your interactions in the project are expected to follow our [Code of Conduct](CODE_OF_CONDUCT.md)
 That's it! The more information you give, the easier it becomes for us to track it down and fix it.
 Ideally, you should provide an application that reproduces the error or a test case to Devise's suite.

data/Gemfile CHANGED Viewed

@@ -2,16 +2,16 @@ source "https://rubygems.org"
 gemspec
-gem "rails", "~> 4.0.0"
-gem "omniauth", "~> 1.0.0"
-gem "omniauth-oauth2", "~> 1.0.0"
+gem "rails", "~> 4.2.6"
+gem "omniauth", "~> 1.3"
+gem "omniauth-oauth2", "~> 1.4"
 gem "rdoc"
 group :test do
   gem "omniauth-facebook"
   gem "omniauth-openid", "~> 1.0.1"
   gem "webrat", "0.7.3", require: false
-  gem "mocha", "~> 1.0.0", require: false
+  gem "mocha", "~> 1.1", require: false
 end
 platforms :jruby do
@@ -25,5 +25,5 @@ platforms :ruby do
 end
 group :mongoid do
-  gem "mongoid", github: "mongoid/mongoid", branch: "master"
+  gem "mongoid", "~> 4.0"
 end

data/Gemfile.lock CHANGED Viewed

@@ -1,139 +1,159 @@
-GIT
-  remote: git://github.com/mongoid/mongoid.git
-  revision: 346a79a7d01aa194de80e649916239a18d38ce13
-  branch: master
-  specs:
-    mongoid (4.0.0)
-      activemodel (~> 4.0.0)
-      moped (~> 1.5)
-      origin (~> 1.0)
-      tzinfo (~> 0.3.22)
 PATH
   remote: .
   specs:
-    devise (3.2.4)
+    devise (4.0.0)
       bcrypt (~> 3.0)
       orm_adapter (~> 0.1)
-      railties (>= 3.2.6, < 5)
-      thread_safe (~> 0.1)
+      railties (>= 4.1.0, < 5.1)
+      responders
       warden (~> 1.2.3)
 GEM
   remote: https://rubygems.org/
   specs:
-    actionmailer (4.0.0)
-      actionpack (= 4.0.0)
-      mail (~> 2.5.3)
-    actionpack (4.0.0)
-      activesupport (= 4.0.0)
-      builder (~> 3.1.0)
-      erubis (~> 2.7.0)
-      rack (~> 1.5.2)
+    actionmailer (4.2.6)
+      actionpack (= 4.2.6)
+      actionview (= 4.2.6)
+      activejob (= 4.2.6)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+    actionpack (4.2.6)
+      actionview (= 4.2.6)
+      activesupport (= 4.2.6)
+      rack (~> 1.6)
       rack-test (~> 0.6.2)
-    activemodel (4.0.0)
-      activesupport (= 4.0.0)
-      builder (~> 3.1.0)
-    activerecord (4.0.0)
-      activemodel (= 4.0.0)
-      activerecord-deprecated_finders (~> 1.0.2)
-      activesupport (= 4.0.0)
-      arel (~> 4.0.0)
-    activerecord-deprecated_finders (1.0.3)
-    activesupport (4.0.0)
-      i18n (~> 0.6, >= 0.6.4)
-      minitest (~> 4.2)
-      multi_json (~> 1.3)
-      thread_safe (~> 0.1)
-      tzinfo (~> 0.3.37)
-    arel (4.0.0)
-    atomic (1.1.12)
-    bcrypt (3.1.7)
-    builder (3.1.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.6)
+      activesupport (= 4.2.6)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activejob (4.2.6)
+      activesupport (= 4.2.6)
+      globalid (>= 0.3.0)
+    activemodel (4.2.6)
+      activesupport (= 4.2.6)
+      builder (~> 3.1)
+    activerecord (4.2.6)
+      activemodel (= 4.2.6)
+      activesupport (= 4.2.6)
+      arel (~> 6.0)
+    activesupport (4.2.6)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    arel (6.0.3)
+    bcrypt (3.1.11)
+    bson (3.2.6)
+    builder (3.2.2)
+    concurrent-ruby (1.0.1)
+    connection_pool (2.2.0)
     erubis (2.7.0)
-    faraday (0.8.8)
-      multipart-post (~> 1.2.0)
-    hashie (1.2.0)
-    hike (1.2.3)
-    httpauth (0.2.0)
-    i18n (0.6.5)
-    json (1.8.0)
-    jwt (0.1.8)
-      multi_json (>= 1.5)
-    mail (2.5.4)
-      mime-types (~> 1.16)
-      treetop (~> 1.4.8)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    globalid (0.3.6)
+      activesupport (>= 4.1.0)
+    hashie (3.4.3)
+    i18n (0.7.0)
+    json (1.8.3)
+    jwt (1.5.1)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mail (2.6.3)
+      mime-types (>= 1.16, < 3)
     metaclass (0.0.4)
-    mime-types (1.23)
-    minitest (4.7.5)
-    mocha (1.0.0)
+    mime-types (2.99.1)
+    mini_portile2 (2.0.0)
+    minitest (5.8.4)
+    mocha (1.1.0)
       metaclass (~> 0.0.1)
-    moped (1.5.1)
-    multi_json (1.7.9)
-    multipart-post (1.2.0)
-    nokogiri (1.5.9)
-    oauth2 (0.8.1)
-      faraday (~> 0.8)
-      httpauth (~> 0.1)
-      jwt (~> 0.1.4)
-      multi_json (~> 1.0)
-      rack (~> 1.2)
-    omniauth (1.0.3)
-      hashie (~> 1.2)
-      rack
-    omniauth-facebook (1.4.0)
-      omniauth-oauth2 (~> 1.0.2)
-    omniauth-oauth2 (1.0.3)
-      oauth2 (~> 0.8.0)
-      omniauth (~> 1.0)
+    mongoid (4.0.2)
+      activemodel (~> 4.0)
+      moped (~> 2.0.0)
+      origin (~> 2.1)
+      tzinfo (>= 0.3.37)
+    moped (2.0.7)
+      bson (~> 3.0)
+      connection_pool (~> 2.0)
+      optionable (~> 0.2.0)
+    multi_json (1.11.2)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    oauth2 (1.1.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0, < 1.5.2)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    omniauth (1.3.1)
+      hashie (>= 1.2, < 4)
+      rack (>= 1.0, < 3)
+    omniauth-facebook (3.0.0)
+      omniauth-oauth2 (~> 1.2)
+    omniauth-oauth2 (1.4.0)
+      oauth2 (~> 1.0)
+      omniauth (~> 1.2)
     omniauth-openid (1.0.1)
       omniauth (~> 1.0)
       rack-openid (~> 1.3.1)
-    origin (1.1.0)
+    optionable (0.2.0)
+    origin (2.2.0)
     orm_adapter (0.5.0)
-    polyglot (0.3.3)
-    rack (1.5.2)
+    rack (1.6.4)
     rack-openid (1.3.1)
       rack (>= 1.1.0)
       ruby-openid (>= 2.1.8)
-    rack-test (0.6.2)
+    rack-test (0.6.3)
       rack (>= 1.0)
-    rails (4.0.0)
-      actionmailer (= 4.0.0)
-      actionpack (= 4.0.0)
-      activerecord (= 4.0.0)
-      activesupport (= 4.0.0)
+    rails (4.2.6)
+      actionmailer (= 4.2.6)
+      actionpack (= 4.2.6)
+      actionview (= 4.2.6)
+      activejob (= 4.2.6)
+      activemodel (= 4.2.6)
+      activerecord (= 4.2.6)
+      activesupport (= 4.2.6)
       bundler (>= 1.3.0, < 2.0)
-      railties (= 4.0.0)
-      sprockets-rails (~> 2.0.0)
-    railties (4.0.0)
-      actionpack (= 4.0.0)
-      activesupport (= 4.0.0)
+      railties (= 4.2.6)
+      sprockets-rails
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.7)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.3)
+      loofah (~> 2.0)
+    railties (4.2.6)
+      actionpack (= 4.2.6)
+      activesupport (= 4.2.6)
       rake (>= 0.8.7)
       thor (>= 0.18.1, < 2.0)
-    rake (10.1.0)
-    rdoc (4.0.1)
+    rake (11.0.1)
+    rdoc (4.2.2)
       json (~> 1.4)
-    ruby-openid (2.2.3)
-    sprockets (2.10.0)
-      hike (~> 1.2)
-      multi_json (~> 1.0)
-      rack (~> 1.0)
-      tilt (~> 1.1, != 1.3.0)
-    sprockets-rails (2.0.0)
-      actionpack (>= 3.0)
-      activesupport (>= 3.0)
-      sprockets (~> 2.8)
-    sqlite3 (1.3.7)
-    thor (0.18.1)
-    thread_safe (0.1.2)
-      atomic
-    tilt (1.4.1)
-    treetop (1.4.14)
-      polyglot
-      polyglot (>= 0.3.1)
-    tzinfo (0.3.37)
-    warden (1.2.3)
+    responders (2.1.2)
+      railties (>= 4.2.0, < 5.1)
+    ruby-openid (2.7.0)
+    sprockets (3.5.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.0.4)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    sqlite3 (1.3.11)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    warden (1.2.6)
       rack (>= 1.0)
     webrat (0.7.3)
       nokogiri (>= 1.2.0)
@@ -148,13 +168,16 @@ DEPENDENCIES
   activerecord-jdbcsqlite3-adapter
   devise!
   jruby-openssl
-  mocha (~> 1.0.0)
-  mongoid!
-  omniauth (~> 1.0.0)
+  mocha (~> 1.1)
+  mongoid (~> 4.0)
+  omniauth (~> 1.3)
   omniauth-facebook
-  omniauth-oauth2 (~> 1.0.0)
+  omniauth-oauth2 (~> 1.4)
   omniauth-openid (~> 1.0.1)
-  rails (~> 4.0.0)
+  rails (~> 4.2.6)
   rdoc
   sqlite3
   webrat (= 0.7.3)
+BUNDLED WITH
+   1.11.2

data/MIT-LICENSE CHANGED Viewed

@@ -1,4 +1,4 @@
-Copyright 2009-2014 Plataformatec. http://plataformatec.com.br
+Copyright 2009-2016 Plataformatec. http://plataformatec.com.br
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the