Files
Matyáš Richter c759bb6915 Extending generated OpenAPI docs (#799)
* Added login endpoint docs

* make format

* Changed login route into multiple examples.

* Added reset password router docs

* Updated /{id} routes for user

* Updated /me routes

* Fixed user already exists response description

* Updated the /register route

* Updated verify routes

* Updated oauth2 endpoints.

* Applied `make format`

* Renamed Authentication methods for getting their openapi schemas

- `get_login_responses_success` -> `get_openapi_login_responses_success`
- `get_logout_responses_success` -> `get_openapi_logout_responses_success`

* Fixed flake8 errors

* Not using `Final` to keep python37 compatibility

Co-authored-by: François Voron <fvoron@gmail.com>
2021-11-23 13:13:51 +01:00

62 lines
1.7 KiB
Python

from typing import Any, Dict, Generic, Optional, TypeVar
from fastapi import Response
from fastapi.security.base import SecurityBase
from fastapi_users import models
from fastapi_users.manager import BaseUserManager
T = TypeVar("T")
class BaseAuthentication(Generic[T, models.UC, models.UD]):
"""
Base authentication backend.
Every backend should derive from this class.
:param name: Name of the backend.
:param logout: Whether or not this backend has a logout process.
"""
scheme: SecurityBase
name: str
logout: bool
def __init__(self, name: str = "base", logout: bool = False):
self.name = name
self.logout = logout
async def __call__(
self,
credentials: Optional[T],
user_manager: BaseUserManager[models.UC, models.UD],
) -> Optional[models.UD]:
raise NotImplementedError()
async def get_login_response(
self,
user: models.UD,
response: Response,
user_manager: BaseUserManager[models.UC, models.UD],
) -> Any:
raise NotImplementedError()
@staticmethod
def get_openapi_login_responses_success() -> Dict[str, Any]:
"""Return a dictionary to use for the openapi responses route parameter."""
raise NotImplementedError()
async def get_logout_response(
self,
user: models.UD,
response: Response,
user_manager: BaseUserManager[models.UC, models.UD],
) -> Any:
raise NotImplementedError()
@staticmethod
def get_openapi_logout_responses_success() -> Dict[str, Any]:
"""Return a dictionary to use for the openapi responses route parameter."""
raise NotImplementedError()