Fastapi-users

Bug fixes

* Fix 823: OpenAPI error when wiring several OAuth routers. Thanks matyasrichter 🎉

Improvements

* Every route is now fully documented through OpenAPI schema. Thanks matyasrichter 🎉

Bug fixes

* When changing the e-mail address, the `is_verified` flag is correctly reset to `False`. Thanks jakemanger 🎉

Improvements

* Every routes have now a fixed `name` allowing programmatic path generation using `url_for`. Thanks BrandonGoding and ricardoorfao 🎉
* Bump dependencies
* `pyjwt ==2.3.0`
* `httpx-oauth >=0.4,<0.5`

Documentation

* Add a cookbook to create a user programmatically. [[Documentation](https://fastapi-users.github.io/fastapi-users/cookbook/create-user-programmatically/)]

Bug fixes

* Fix custom reset password token audience not being set correctly in `UserManager`. Thanks maximka1221 🎉

Improvements

* Bump dependencies
* `fastapi >=0.65.2,<0.71.0`
* `pyjwt ==2.2.0`
* `makefun >=1.9.2,<1.13`

New features

* Dynamic selection of authentication backends when using the `current_user` dependency. [[Documentation](https://fastapi-users.github.io/fastapi-users/usage/current-user/#dynamically-enable-authentication-backends)]
* `get_login_response` and `get_logout_response` methods of authentication backends are called with a `UserManager` instance in argument.
* If you use the standard backend, nothing changes for you.
* If you implemented custom backends, you should make sure to accept this new argument in your implementation. [[Source](https://github.com/fastapi-users/fastapi-users/blob/0826ec529915e80c217f1ddc52f76d1c1c71d223/fastapi_users/authentication/base.py#L37-L51)]

**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/)]