Fastapi-users

**Version 8 includes the biggest code changes since version 1. We reorganized lot of parts of the code to make it even more modular and integrate more into the dependency injection system of FastAPI.**

Breaking changes

**Please read the [migration page](https://fastapi-users.github.io/fastapi-users/migration/7x_to_8x/) to update your configuration.**

* Event handlers should live in the `UserManager`. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/user-manager/)]
* Password validation should live in the `UserManager`. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/user-manager/)]
* Verify token secret and lifetime parameters are attributes of `UserManager`. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/user-manager/)]
* Reset password token secret and lifetime parameters are attributes of `UserManager`. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/user-manager/)]
* Database adapter should be provided in a dependency. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/databases/sqlalchemy/)]
* FastAPIUsers now expect a `get_user_manager` dependency. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/routers/)]

Improvements

* More modular design using the new `UserManager` class.
* More integrated into the dependency injection system by using dependencies for database adapters and user manager.
* When updating a user e-mail with the same address as the current one, `UPDATE_USER_EMAIL_ALREADY_EXISTS` is not raised anymore. Thanks ScrimForever 🎉

Documentation

* Full working examples now available as Repl.it. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/full-example/)]

Breaking changes

* The deprecated dependencies to retrieve current user have been removed. Use the `current_user` factory instead. [[Documentation](https://fastapi-users.github.io/fastapi-users/usage/current-user/)]
* When trying to authenticate a not verified user, a **status code 403** is raised instead of status code 401. Thanks daanbeverdam 🎉 [[Documentation](https://fastapi-users.github.io/fastapi-users/usage/current-user/#current_user)]
* Your `UserUpdate` model shouldn't inherit from the base `User` class anymore. If you have custom fields, you should repeat them in this model. [[Documentation](https://fastapi-users.github.io/fastapi-users/configuration/model/#define-your-models)]

Improvements

* Database adapters now live in their [own repositories and packages](https://github.com/fastapi-users).
* When upgrading to v7.0.0, the dependency for your database adapter should automatically be installed.
* The `import` statements remain unchanged.
* [SQLAlchemy + encode/databases adapter](https://github.com/fastapi-users/fastapi-users-db-sqlalchemy) have been updated and now support SQLAlchemy 1.4.
* Secret parameters now support Pydantic's [`SecretStr` class](https://pydantic-docs.helpmanual.io/usage/types/#secret-types). Thanks pocin 🎉

What's coming next?

* [SQLModel](https://sqlmodel.tiangolo.com/) support through a new database adapter
* Better examples running on Repl.it
* Tackle 633, 687 and 688

Miscellaneous

* Update URL:
* Repository is now at: https://github.com/fastapi-users/fastapi-users/
* Documentation is now at: https://fastapi-users.github.io/fastapi-users/

Improvements

* Bump dependencies:
* `fastapi >=0.65.2,<0.69.0`

Fixes

* Fix 646: add a `python_type` to the GUID column type for SQLAlchemy database backend. Thanks mark-todd 🎉
* Fix users delete route returning `null` in content with a 204 status code (see 650). Thanks jnu 🎉

Improvements

* Bump dependencies:
* `fastapi >=0.65.2,<0.67.0`

New features

* Password validation feature: use your own function to validate password. It'll get called consistently at registration, password reset and user update. [[Documentation](https://frankie567.github.io/fastapi-users/configuration/password-validation/)]

Improvements

* Bump dependencies
* `fastapi >=0.63.0,<0.66.0`
* `pyjwt ==2.1.0`
* Improve documentation regarding JWTAuthentication's `tokenUrl` argument. Thanks eddsalkield 🎉