omniauth-identity 3.0.8 → 3.1.0

data/README.md

@@ -1,13 +1,76 @@
-# OmniAuth Identity
-
-[![Version](https://img.shields.io/gem/v/omniauth-identity.svg)](https://rubygems.org/gems/omniauth-identity)
-[![Depfu](https://badges.depfu.com/badges/6c9b45362951b872127f9e46d39bed76/count.svg)](https://depfu.com/github/omniauth/omniauth-identity?project_id=22381)
-[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fomniauth%2Fomniauth-identity%2Fbadge&style=flat)](https://actions-badge.atrox.dev/omniauth/omniauth-identity/goto)
-[![Maintainability](https://api.codeclimate.com/v1/badges/621d6211cb2e0959ce00/maintainability)](https://codeclimate.com/github/omniauth/omniauth-identity/maintainability)
-[![Test Coverage](https://api.codeclimate.com/v1/badges/621d6211cb2e0959ce00/test_coverage)](https://codeclimate.com/github/omniauth/omniauth-identity/test_coverage)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Open Source Helpers](https://www.codetriage.com/omniauth/omniauth-identity/badges/users.svg)](https://www.codetriage.com/omniauth/omniauth-identity)
-[![Downloads Rank](https://img.shields.io/gem/rd/omniauth-identity.svg)](https://rubygems.org/gems/omniauth-identity)
+# `OmniAuth::Identity`
+
+[![Version][👽versioni]][👽version]
+[![License: MIT][📄license-img]][📄license-ref]
+[![Downloads Rank][👽dl-ranki]][👽dl-rank]
+[![Open Source Helpers][👽oss-helpi]][👽oss-help]
+[![Depfu][🔑depfui♻️]][🔑depfu]
+[![CodeCov][🔑codecovi♻️]][🔑codecov]
+[![Test Coverage][🔑cc-covi♻️]][🔑cc-cov]
+[![Maintainability][🔑cc-mnti♻️]][🔑cc-mnt]
+[![CI Supported Build][🚎6-s-wfi]][🚎6-s-wf]
+[![CI Legacy Build][🚎4-lg-wfi]][🚎4-lg-wf]
+[![CI Unsupported Build][🚎7-us-wfi]][🚎7-us-wf]
+[![CI Heads Build][🚎3-hd-wfi]][🚎3-hd-wf]
+[![CI Ancient Build][🚎1-an-wfi]][🚎1-an-wf]
+[![CI Coverage Build][🚎2-cov-wfi]][🚎2-cov-wf]
+[![CI Style Build][🚎5-st-wfi]][🚎5-st-wf]
+
+<!--- ( 👽️ INFO LINKS ) -->
+
+[👽dl-rank]: https://rubygems.org/gems/omniauth-identity
+[👽dl-ranki]: https://img.shields.io/gem/rd/omniauth-identity.svg
+[👽oss-help]: https://www.codetriage.com/omniauth/omniauth-identity
+[👽oss-helpi]: https://www.codetriage.com/omniauth/omniauth-identity/badges/users.svg
+[👽version]: https://rubygems.org/gems/omniauth-identity
+[👽versioni]: https://img.shields.io/gem/v/omniauth-identity.svg
+
+<!--- ( 🔑 KEYED LINKS ) -->
+
+[🔑cc-mnt]: https://codeclimate.com/github/omniauth/omniauth-identity/maintainability
+[🔑cc-mnti♻️]: https://api.codeclimate.com/v1/badges/621d6211cb2e0959ce00/maintainability
+[🔑cc-cov]: https://codeclimate.com/github/omniauth/omniauth-identity/test_coverage
+[🔑cc-covi♻️]: https://api.codeclimate.com/v1/badges/621d6211cb2e0959ce00/test_coverage
+[🔑codecov]: https://codecov.io/gh/omniauth/omniauth-identity
+[🔑codecovi♻️]: https://codecov.io/gh/omniauth/omniauth-identity/graph/badge.svg?token=cc6UdZCpAL
+[🔑depfu]: https://depfu.com/github/omniauth/omniauth-identity
+[🔑depfui♻️]: https://badges.depfu.com/badges/6c9b45362951b872127f9e46d39bed76/count.svg
+
+<!--- ( 🚎 BUILD LINKS ) -->
+
+[🚎1-an-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/ancient.yml
+[🚎1-an-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/ancient.yml/badge.svg
+[🚎2-cov-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/coverage.yml
+[🚎2-cov-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/coverage.yml/badge.svg
+[🚎3-hd-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/heads.yml
+[🚎3-hd-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/heads.yml/badge.svg
+[🚎4-lg-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/legacy.yml
+[🚎4-lg-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/legacy.yml/badge.svg
+[🚎5-st-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/style.yml
+[🚎5-st-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/style.yml/badge.svg
+[🚎6-s-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/supported.yml
+[🚎6-s-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/supported.yml/badge.svg
+[🚎7-us-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/unsupported.yml
+[🚎7-us-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/unsupported.yml/badge.svg
+
+-----
+
+[![Liberapay Patrons][⛳liberapay-img]][⛳liberapay]
+[![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor]
+[![Polar Shield][🖇polar-img]][🖇polar]
+[![Donate to my FLOSS or refugee efforts at ko-fi.com][🖇kofi-img]][🖇kofi]
+[![Donate to my FLOSS or refugee efforts using Patreon][🖇patreon-img]][🖇patreon]
+
+[⛳liberapay-img]: https://img.shields.io/liberapay/patrons/pboling.svg?logo=liberapay
+[⛳liberapay]: https://liberapay.com/pboling/donate
+[🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
+[🖇sponsor]: https://github.com/sponsors/pboling
+[🖇polar-img]: https://polar.sh/embed/seeks-funding-shield.svg?org=pboling
+[🖇polar]: https://polar.sh/pboling
+[🖇kofi-img]: https://img.shields.io/badge/buy%20me%20coffee-donate-yellow.svg
+[🖇kofi]: https://ko-fi.com/O5O86SNP4
+[🖇patreon-img]: https://img.shields.io/badge/patreon-donate-yellow.svg
+[🖇patreon]: https://patreon.com/galtzo
 
 The OmniAuth Identity gem provides a way for applications to utilize a
 traditional username/password based authentication system without the need
@@ -15,27 +78,63 @@ to give up the simple authentication flow provided by OmniAuth. Identity
 is designed on purpose to be as featureless as possible: it provides the
 basic construct for user management and then gets out of the way.
 
-## Compatibility
-
-This gem is compatible with, as of Feb 2021, version 3:
-
-* Latest released version of omniauth, v2.0.2
-* Ruby 2.4, 2.5, 2.6, 2.7, 3.0, ruby-head
+| Primary Namespace | `OmniAuth::Identity`                                                                                                                                                                                                                                                                                                                                    |
+|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| documentation     | [on Github.com][homepage], [Latest release on RubyDoc.info][documentation], [HEAD on RubyDoc.info][documentation-head]                                                                                                                                                                                                                           |
+| expert support    | [![Get help on Codementor](https://cdn.codementor.io/badges/get_help_github.svg)](https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github)                                                                                                                                                   |
+| `...` 💖          | [![Follow Me on LinkedIn][🖇linkedin-img]][🖇linkedin] [![Find Me on WellFound:][✌️wellfound-img]][✌️wellfound] [![Find Me on CrunchBase][💲crunchbase-img]][💲crunchbase] [![My LinkTree][🌳linktree-img]][🌳linktree] [![Follow Me on Ruby.Social][🐘ruby-mast-img]][🐘ruby-mast] [![Tweet @ Peter][🐦tweet-img]][🐦tweet] [💻][coderme] [🌏][aboutme] |
+
+<!--- 7️⃣ spread 💖 -->
+[🐦tweet-img]: https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow%20%40galtzo
+[🐦tweet]: http://twitter.com/galtzo
+[🚎blog]: http://www.railsbling.com/tags/omniauth-identity/
+[🚎blog-img]: https://img.shields.io/badge/blog-railsbling-brightgreen.svg?style=flat
+[🖇linkedin]: http://www.linkedin.com/in/peterboling
+[🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-blue?style=plastic&logo=linkedin
+[✌️wellfound]: https://angel.co/u/peter-boling
+[✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=plastic&logo=wellfound
+[💲crunchbase]: https://www.crunchbase.com/person/peter-boling
+[💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=plastic&logo=crunchbase
+[🐘ruby-mast]: https://ruby.social/@galtzo
+[🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https%3A%2F%2Fruby.social&style=plastic&logo=mastodon&label=Ruby%20%40galtzo
+[🌳linktree]: https://linktr.ee/galtzo
+[🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=plastic&logo=linktree
+
+<!--- Maintainer Contact Links -->
+[aboutme]: https://about.me/peter.boling
+[coderme]: https://coderwall.com/Peter%20Boling
 
 ## Installation
 
-To acquire the latest release from RubyGems add the following to your `Gemfile`:
+To acquire the latest release from RubyGems, and add this gem to your `Gemfile`, run:
 
-```ruby
-gem 'omniauth-identity'
+```shell
+bundle add omniauth-identity
 ```
 
 If the git repository has new commits not yet in an official release, simply specify the repo instead:
 
 ```ruby
-gem 'omniauth-identity', git: 'https://github.com/intridea/omniauth-identity.git'
+gem "omniauth-identity", git: "https://github.com/omniauth/omniauth-identity.git"
 ```
 
+## Compatibility
+
+This gem is compatible with a wide range of Ruby versions and Ruby ORMs, as of Nov 2024, version 3.1.
+
+* Latest released version of omniauth, v2+
+* Tested in CI against Ruby 2.5, 2.6, 2.7, 3.0, 3.1, 3.2, 3.3, ruby-head, truffleruby-head
+* Probably also compatible with Ruby 2.4 and jruby-head
+* At least 5 different database ORM adapters, which connect to 15 different database clients!
+
+| Databases                                                                                                 | Adapter Libraries                                                        |
+|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|
+| MySQL, PostgreSQL, SQLite3                                                                                | [ActiveRecord](https://guides.rubyonrails.org/active_record_basics.html) |
+| CouchDB                                                                                                   | [CouchPotato](https://github.com/langalex/couch_potato)                  |
+| MongoDB                                                                                                   | [Mongoid](https://github.com/mongodb/mongoid)                            |
+| RethinkDB                                                                                                 | [NoBrainer](http://nobrainer.io/)                                        |
+| ADO, Amalgalite, IBM_DB, JDBC, MySQL, Mysql2, ODBC, Oracle, PostgreSQL, SQLAnywhere, SQLite3, and TinyTDS | [Sequel](http://sequel.jeremyevans.net)                                  |
+
 ## Usage
 
 This can be a bit hard to understand the first time. Luckily, Ryan Bates made
@@ -48,8 +147,8 @@ Rack middleware. In rails, this would be created by an initializer, such as
 ```ruby
 use OmniAuth::Builder do
   provider :identity,                        #mandatory: tells OA that the Identity strategy is being used
-           model: Identity,                  # optional: specifies the name of the "Identity" model. Defaults to "Identity"
-           fields: %i[email custom1 custom2] # optional: list of custom fields that are in the model's table
+    model: Identity,                  # optional: specifies the name of the "Identity" model. Defaults to "Identity"
+    fields: %i[email custom1 custom2] # optional: list of custom fields that are in the model's table
 end
 ```
 
@@ -100,7 +199,6 @@ class SequelTestIdentity < Sequel::Model(:identities)
 end
 ```
 
-
 ### Mongoid
 
 Include the `OmniAuth::Identity::Models::Mongoid` mixin and specify
@@ -171,7 +269,7 @@ end
 ```
 
 NOTE: In the above example, `MyCustomClass` must have a class method called `auth_key` that returns
- the default (`email`) or custom `auth_key` to use.
+the default (`email`) or custom `auth_key` to use.
 
 ## Customizing Registration Failure
 
@@ -212,8 +310,8 @@ fails. In your OmniAuth configuration, specify any valid rack endpoint in the
 ```ruby
 use OmniAuth::Builder do
   provider :identity,
-           fields: [:email],
-           on_failed_registration: UsersController.action(:new)
+    fields: [:email],
+    on_failed_registration: UsersController.action(:new)
 end
 ```
 
@@ -232,7 +330,7 @@ The default value is:
 ```ruby
 use OmniAuth::Builder do
   provider :identity,
-           locate_conditions: ->(req) { { model.auth_key => req['auth_key'] } }
+    locate_conditions: ->(req) { {model.auth_key => req.params["auth_key"]} }
     # ...
 end
 ```
@@ -261,60 +359,123 @@ option :on_login, nil               # See #request_phase
 option :on_validation, nil          # See #registration_phase
 option :on_registration, nil        # See #registration_phase
 option :on_failed_registration, nil # See #registration_phase
-option :locate_conditions, ->(req) { { model.auth_key => req['auth_key'] } }
+option :locate_conditions, ->(req) { {model.auth_key => req.params["auth_key"]} }
 ```
 
 Please contribute some documentation if you have the gumption!  The maintainer's time is limited, and sometimes the authors of PRs with new options don't update the _this_ readme. 😭
 
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am ‘Added some feature’`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.
-   - NOTE: In order to run *all* the tests you will need to have the following databases installed, configured, and running.
-     1. [RethinkDB](https://rethinkdb.com), an open source, real-time, web database, [installed](https://rethinkdb.com/docs/install/) and [running](https://rethinkdb.com/docs/start-a-server/), e.g.
-      ```bash
-      brew install rethinkdb
-      rethinkdb
-      ```
-      2. [MongoDB](https://docs.mongodb.com/manual/administration/install-community/)
-      ```bash
-      brew tap mongodb/brew
-      brew install mongodb-community@4.4
-      mongod --config /usr/local/etc/mongod.conf
-      ```
-      3. [CouchDB](https://couchdb.apache.org) (download the .app)
-   To run all tests on all databases:
-   ```bash
-   bundle exec rake
-   ```
-   To run a specific DB:
-   ```bash
-   # CouchDB / CouchPotato
-   bundle exec rspec spec spec_orms --tag 'couchdb'
-
-   # ActiveRecord and Sequel, as they both use the in-memory SQLite driver.
-   bundle exec rspec spec spec_orms --tag 'sqlite3'
-
-   # NOTE - mongoid and nobrainer specs can't be isolated with "tag" because it still loads everything,
-   #        and the two libraries are fundamentally incompatible.
-
-   # MongoDB / Mongoid
-   bundle exec rspec spec_orms/mongoid_spec.rb
-
-   # RethinkDB / NoBrainer
-   bundle exec rspec spec_orms/nobrainer_spec.rb
-   ```
-6. Create new Pull Request
-
-## License
-
-MIT License. See LICENSE for details.
-
-## Copyright
-
-* Copyright (c) 2021 OmniAuth-Identity Maintainers
-* Copyright (c) 2020 Peter Boling, Andrew Roberts, and Jellybooks Ltd.
+## 🤝 Contributing
+
+If you need some ideas of where to help, you could work on adding more code coverage,
+or if it is already 💯 (see [below](#code-coverage)) then check [issues][🤝issues], or [PRs][🤝pulls],
+or use the gem and think about how it could be better.
+
+Also, see [CONTRIBUTING.md][🤝contributing].
+
+[🤝issues]: https://github.com/omniauth/omniauth-identity/issues
+[🤝pulls]: https://github.com/omniauth/omniauth-identity/pulls
+[🤝contributing]: CONTRIBUTING.md
+
+### Code Coverage
+
+[![Coverage Graph][🔑codecov-g]][🔑codecov]
+
+[🔑codecov-g]: https://codecov.io/gh/omniauth/omniauth-identity/graphs/tree.svg?token=cc6UdZCpAL
+
+## 🌈 Contributors
+
+[![Contributors][🖐contributors-img]][🖐contributors]
+
+Made with [contributors-img][🖐contrib-rocks].
+
+[🖐contrib-rocks]: https://contrib.rocks
+[🖐contributors]: https://github.com/omniauth/omniauth-identity/graphs/contributors
+[🖐contributors-img]: https://contrib.rocks/image?repo=omniauth/omniauth-identity
+
+## Star History
+
+<a href="https://star-history.com/#omniauth/omniauth-identity&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=omniauth/omniauth-identity&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=omniauth/omniauth-identity&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=omniauth/omniauth-identity&type=Date" />
+ </picture>
+</a>
+
+## 🪇 Code of Conduct
+
+Everyone interacting in this project's codebases, issue trackers,
+chat rooms and mailing lists is expected to follow the [code of conduct][🪇conduct].
+
+[🪇conduct]: CODE_OF_CONDUCT.md
+
+## 📌 Versioning
+
+This Library adheres to [Semantic Versioning 2.0.0][📌semver].
+Violations of this scheme should be reported as bugs.
+Specifically, if a minor or patch version is released that breaks backward compatibility,
+a new version should be immediately released that restores compatibility.
+Breaking changes to the public API will only be introduced with new major versions.
+
+To get a better understanding of how SemVer is intended to work over a project's lifetime,
+read this article from the creator of SemVer:
+
+- ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
+
+As a result of this policy, you can (and should) specify a dependency on these libraries using
+the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
+
+For example:
+
+```ruby
+spec.add_dependency("omniauth-identity", "~> 3.1")
+```
+
+See [CHANGELOG.md][📌changelog] for list of releases.
+
+<!--- ( 📌 VERSIONING LINKS ) -->
+
+[📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
+[📌semver]: http://semver.org/
+[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
+[📌changelog]: CHANGELOG.md
+
+## 📄 License
+
+The gem is available as open source under the terms of
+the [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].
+See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].
+
+[comment]: <> ( 📄 LEGAL LINKS )
+
+[📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
+[📄license]: LICENSE.txt
+[📄license-ref]: https://opensource.org/licenses/MIT
+[📄license-img]: https://img.shields.io/badge/License-MIT-green.svg
+
+### © Copyright
+
+* Copyright (c) 2021, 2024 [Peter H. Boling][peterboling], and OmniAuth-Identity Maintainers
+* Copyright (c) 2020 [Peter H. Boling][peterboling], Andrew Roberts, and Jellybooks Ltd.
 * Copyright (c) 2010-2015 Michael Bleigh, and Intridea, Inc.
+
+[railsbling]: http://www.railsbling.com
+[peterboling]: http://www.peterboling.com
+[bundle-group-pattern]: https://gist.github.com/pboling/4564780
+[documentation]: http://rubydoc.info/gems/omniauth-identity
+[documentation-head]: https://rubydoc.info/github/omniauth/omniauth-identity/main
+[homepage]: https://github.com/omniauth/omniauth-identity
+
+## 🤑 One more thing
+
+You made it to the bottom of the page,
+so perhaps you'll indulge me for another 20 seconds.
+I maintain many dozens of gems, including this one,
+because I want Ruby to be a great place for people to solve problems, big and small.
+Please consider supporting my efforts via the giant yellow link below,
+or one of the others at the head of this README.
+
+[![Buy me a latte][🖇buyme-img]][🖇buyme]
+
+[🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
+[🖇buyme]: https://www.buymeacoffee.com/pboling

data/lib/omniauth/identity/model.rb

@@ -2,7 +2,7 @@
 
 module OmniAuth
   module Identity
-    # This module provides an includable interface for implementing the
+    # This module provides an include-able interface for implementing the
     # necessary API for OmniAuth Identity to properly locate identities
     # and provide all necessary information.
     #
@@ -23,20 +23,22 @@ module OmniAuth
     module Model
       SCHEMA_ATTRIBUTES = %w[name email nickname first_name last_name location description image phone].freeze
 
-      def self.included(base)
-        base.extend ClassMethods
-        base.extend ClassCreateApi unless base.respond_to?(:create)
-        im = base.instance_methods
-        base.include InstanceSaveApi unless im.include?(:save)
-        base.include InstancePersistedApi unless im.include?(:persisted?)
+      class << self
+        def included(base)
+          base.extend(ClassMethods)
+          base.extend(ClassCreateApi) unless base.respond_to?(:create)
+          i_methods = base.instance_methods
+          base.include(InstanceSaveApi) unless i_methods.include?(:save)
+          base.include(InstancePersistedApi) unless i_methods.include?(:persisted?)
+        end
       end
 
       module ClassMethods
         # Authenticate a user with the given key and password.
         #
-        # @param [String] key The unique login key provided for a given identity.
+        # @param [String] conditions The unique login key provided for a given identity.
         # @param [String] password The presumed password for the identity.
-        # @return [Model] An instance of the identity model class.
+        # @return [Model, false] An instance of the identity model class.
         def authenticate(conditions, password)
           instance = locate(conditions)
           return false unless instance
@@ -49,15 +51,15 @@ module OmniAuth
         # @return [String] The method name.
         def auth_key(method = false)
           @auth_key = method.to_s unless method == false
-          @auth_key = nil if !defined?(@auth_key) || @auth_key == ''
+          @auth_key = nil if !defined?(@auth_key) || @auth_key == ""
 
-          @auth_key || 'email'
+          @auth_key || "email"
         end
 
         # Locate an identity given its unique login key.
         #
         # @abstract
-        # @param [String] key The unique login key.
+        # @param [String] _key The unique login key.
         # @return [Model] An instance of the identity model class.
         def locate(_key)
           raise NotImplementedError
@@ -71,7 +73,7 @@ module OmniAuth
         #
         # @deprecated v4.0 will begin using {#new} with {#save} instead.
         # @abstract
-        # @param [Hash] args Attributes of the new instance.
+        # @param [Hash] _args Attributes of the new instance.
         # @return [Model] An instance of the identity model class.
         # @since 3.0.5
         def create(*_args)
@@ -109,7 +111,7 @@ module OmniAuth
       # otherwise.
       #
       # @abstract
-      # @param [String] password The password to check.
+      # @param [String] _password The password to check.
       # @return [self or false] Self if authenticated, false if not.
       def authenticate(_password)
         raise NotImplementedError
@@ -121,7 +123,7 @@ module OmniAuth
       # @return [String] An identifier string unique to this identity.
       def uid
         if respond_to?(:id)
-          return nil if id.nil?
+          return if id.nil?
 
           id.to_s
         else
@@ -172,8 +174,8 @@ module OmniAuth
         SCHEMA_ATTRIBUTES.each_with_object(info) do |attribute, hash|
           hash[attribute] = send(attribute) if respond_to?(attribute)
         end
-        info['name'] ||= [info['first_name'], info['last_name']].join(' ').strip if info['first_name'] || info['last_name']
-        info['name'] ||= info['nickname']
+        info["name"] ||= [info["first_name"], info["last_name"]].join(" ").strip if info["first_name"] || info["last_name"]
+        info["name"] ||= info["nickname"]
         info
       end
     end

data/lib/omniauth/identity/models/active_record.rb

@@ -1,24 +1,28 @@
 # frozen_string_literal: true
 
-require 'active_record'
+require "active_record"
 
 module OmniAuth
   module Identity
     module Models
+      # ActiveRecord is an ORM for MySQL, PostgreSQL, and SQLite3:
+      #   https://guides.rubyonrails.org/active_record_basics.html
+      # NOTE: ActiveRecord is based on ActiveModel.
       class ActiveRecord < ::ActiveRecord::Base
         include ::OmniAuth::Identity::Model
         include ::OmniAuth::Identity::SecurePassword
 
         self.abstract_class = true
+        # validations: true (default) incurs a dependency on ActiveModel, but ActiveRecord is ActiveModel based.
         has_secure_password
 
         def self.auth_key=(key)
           super
-          validates_uniqueness_of key, case_sensitive: false
+          validates_uniqueness_of(key, case_sensitive: false)
         end
 
         def self.locate(search_hash)
-          search_hash = search_hash.reverse_merge!('provider' => 'identity') if column_names.include?('provider')
+          search_hash = search_hash.reverse_merge!("provider" => "identity") if column_names.include?("provider")
           where(search_hash).first
         end
       end

data/lib/omniauth/identity/models/couch_potato.rb

@@ -1,24 +1,27 @@
 # frozen_string_literal: true
 
-require 'couch_potato'
+require "couch_potato"
 
 module OmniAuth
   module Identity
     module Models
-      # can not be named CouchPotato since there is a class with that name
+      # CouchPotato is an ORM adapter for CouchDB:
+      #   https://github.com/langalex/couch_potato
       # NOTE: CouchPotato is based on ActiveModel.
       # NOTE: CouchPotato::Persistence must be included before OmniAuth::Identity::Models::CouchPotatoModule
+      # NOTE: Includes "Module" in the name for invalid legacy reasons. Rename only with a major version bump.
       module CouchPotatoModule
         def self.included(base)
           base.class_eval do
-            include ::OmniAuth::Identity::Model
-            include ::OmniAuth::Identity::SecurePassword
+            include(::OmniAuth::Identity::Model)
+            include(::OmniAuth::Identity::SecurePassword)
 
+            # validations: true (default) incurs a dependency on ActiveModel, but CouchPotato is ActiveModel based.
             has_secure_password
 
             def self.auth_key=(key)
               super
-              validates_uniqueness_of key, case_sensitive: false
+              validates_uniqueness_of(key, case_sensitive: false)
             end
 
             def self.locate(search_hash)
@@ -26,7 +29,7 @@ module OmniAuth
             end
 
             def save
-              CouchPotato.database.save(self)
+              CouchPotato.database.save_document(self)
             end
           end
         end

data/lib/omniauth/identity/models/mongoid.rb

@@ -1,22 +1,25 @@
 # frozen_string_literal: true
 
-require 'mongoid'
+require "mongoid"
 
 module OmniAuth
   module Identity
     module Models
+      # Mongoid is an ORM adapter for MongoDB:
+      #   https://github.com/mongodb/mongoid
       # NOTE: Mongoid is based on ActiveModel.
       module Mongoid
         def self.included(base)
           base.class_eval do
-            include ::OmniAuth::Identity::Model
-            include ::OmniAuth::Identity::SecurePassword
+            include(::OmniAuth::Identity::Model)
+            include(::OmniAuth::Identity::SecurePassword)
 
+            # validations: true (default) incurs a dependency on ActiveModel, but Mongoid is ActiveModel based.
             has_secure_password
 
             def self.auth_key=(key)
               super
-              validates_uniqueness_of key, case_sensitive: false
+              validates_uniqueness_of(key, case_sensitive: false)
             end
 
             def self.locate(search_hash)

data/lib/omniauth/identity/models/nobrainer.rb

@@ -1,23 +1,25 @@
 # frozen_string_literal: true
 
-require 'nobrainer'
+require "nobrainer"
 
 module OmniAuth
   module Identity
     module Models
-      # http://nobrainer.io/ an ORM for RethinkDB
+      # NoBrainer is an ORM adapter for RethinkDB:
+      #   http://nobrainer.io/
       # NOTE: NoBrainer is based on ActiveModel.
       module NoBrainer
         def self.included(base)
           base.class_eval do
-            include ::OmniAuth::Identity::Model
-            include ::OmniAuth::Identity::SecurePassword
+            include(::OmniAuth::Identity::Model)
+            include(::OmniAuth::Identity::SecurePassword)
 
+            # validations: true (default) incurs a dependency on ActiveModel, but NoBrainer is ActiveModel based.
             has_secure_password
 
             def self.auth_key=(key)
               super
-              validates_uniqueness_of key, case_sensitive: false
+              validates_uniqueness_of(key, case_sensitive: false)
             end
 
             def self.locate(search_hash)