v9.0.1

Bug fixes

• Fix ImportError when redis optional dependency not installed.

v9.0.0

Version 9 changes the way authentication backends work so that they are more modular and ease the integration of new methods.

Breaking changes

Please read the migration page to update your configuration.

• Authentication backends are now composed of a Transport and a Strategy. [Documentation]
• An OAuth router is now required for each authentication backend. [Documentation]

New features and improvements

• More modular design for authentication backends.
• New authentication strategy storing tokens in a Redis store. [Documentation]

Documentation

• Full examples are now back in the repository and directly included in the documentation. [Documentation]

v8.1.4

Bug fixes

• Fix #823: OpenAPI error when wiring several OAuth routers. Thanks @matyasrichter 🎉

v8.1.3

Improvements

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

v8.1.2

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]

v8.1.1

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

v8.1.0

New features

• Dynamic selection of authentication backends when using the current_user dependency. [Documentation]
• 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]

v8.0.0

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 to update your configuration.

• Event handlers should live in the UserManager. [Documentation]
• Password validation should live in the UserManager. [Documentation]
• Verify token secret and lifetime parameters are attributes of UserManager. [Documentation]
• Reset password token secret and lifetime parameters are attributes of UserManager. [Documentation]
• Database adapter should be provided in a dependency. [Documentation]
• FastAPIUsers now expect a get_user_manager dependency. [Documentation]

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]

v7.0.0

Breaking changes

• The deprecated dependencies to retrieve current user have been removed. Use the current_user factory instead. [Documentation]
• When trying to authenticate a not verified user, a status code 403 is raised instead of status code 401. Thanks @daanbeverdam 🎉 [Documentation]
• 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]

Improvements

• Database adapters now live in their own repositories and packages.
  • 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 have been updated and now support SQLAlchemy 1.4.
• Secret parameters now support Pydantic's SecretStr class. Thanks @pocin 🎉

What's coming next?

• SQLModel support through a new database adapter
• Better examples running on Repl.it
• Tackle #633, #687 and #688

v6.1.3

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/