FastAPI
=======

Installing
----------

To install aioauth with FastAPI at the command line:

.. code-block::

   $ pip install aioauth[fastapi]

Usage example

.. code-block:: python

    from dataclasses import dataclasses
    from aioauth_fastapi.router import get_oauth2_router
    from aioauth.storage import BaseStorage
    from aioauth.requests import BaseRequest, Query, Post
    from aioauth.models import AuthorizationCode, Client, Token
    from aioauth.config import Settings
    from aioauth.server import AuthorizationServer
    from fastapi import FastAPI

    app = FastAPI()

    @dataclasses
    class User:
        """Custom user model"""
        first_name: str
        last_name: str


    class Request(BaseRequest[Query, Post, User]):
        """Custom Request model"""


    class Storage(BaseStorage[Token, Client, AuthorizationCode, Request]):
        """
        Storage methods must be implemented here.
        """

    storage = Storage()
    authorization_server = AuthorizationServer[Request, Storage](storage)

    # NOTE: Redefinition of the default aioauth settings
    # INSECURE_TRANSPORT must be enabled for local development only!
    settings = Settings(
        INSECURE_TRANSPORT=True,
    )

    # Include FastAPI router with oauth2 endpoints.
    app.include_router(
        get_oauth2_router(authorization_server, settings),
        prefix="/oauth2",
        tags=["oauth2"],
    )