Best practice to structure multiple module

When I sperate apis into multiple module, I find it hard to structure the code, currently I approach like this:

# app.py
from fastapi import FastAPI
app = FastAPI()

# api1.py
from app import app

@app.get('/test1')
...

# api2.py
from app import app

@app.get('/test2')
...

# main.py
from app import app
import api1
import api2

$ uvicorn main:app --lifespan on
...

Any suggestions?

[dmontagu]

From the FastAPI project-generator codebase:

# app/api/api_v1/endpoints/items.py
...

from fastapi import APIRouter, Depends, HTTPException

...

router = APIRouter()


@router.get("/", response_model=List[Item])
...

# app/api/api_v1/api.py
from fastapi import APIRouter

from app.api.api_v1.endpoints import items, login, users, utils

api_router = APIRouter()
api_router.include_router(login.router, tags=["login"])
api_router.include_router(users.router, prefix="/users", tags=["users"])
api_router.include_router(utils.router, prefix="/utils", tags=["utils"])
api_router.include_router(items.router, prefix="/items", tags=["items"])

# app/main.py
from fastapi import FastAPI

...

from app.api.api_v1.api import api_router

...

app = FastAPI(title=config.PROJECT_NAME, openapi_url="/api/v1/openapi.json")

...

app.include_router(api_router, prefix=config.API_V1_STR)

...

[dmontagu]

Right, you’d have to give it a name (e.g. @router.get("/items", response_model=List[Item])).

You can mount multiple routers with the same prefix if, for example, you want to have multiple distinct resources with the same prefix and different non-slash-ending endpoints:

from fastapi import FastAPI, APIRouter

app = FastAPI()

router1 = APIRouter()
router2 = APIRouter()


@router1.get("/items")
async def read_items():
    return []


@router2.get("/things")
async def read_things():
    return []


app.include_router(router1, prefix="")
app.include_router(router2, prefix="")

if __name__ == '__main__':
    import uvicorn

    uvicorn.run(app, host='0.0.0.0', port=8000)