From 313bbe802fc9c2d16ff0203d82420f5279b7c45d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Sun, 29 Nov 2020 18:32:18 +0100 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20shared/top-le?= =?UTF-8?q?vel=20parameters=20(dependencies,=20tags,=20etc)=20(#2434)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * ✨ Add Default and DefaultPlaceholder data structures to handle defaults and overrides * ✨ Add utils to get values by priority handling DefaultPlaceholders * ✨ Add support for top-level parameters in FastAPI, APIRouter, include_router including: prefix, tags, dependencies, deprecated, include_in_schema, responses, default_response_class, callbacks * ♻️ Update openapi utils to handle DefaultPlaceholder for response_class * 📝 Update bigger-application example code to use top-level params and showcase them in APIRouter, FastAPI, include_router * 📝 Update docs for Bigger Applications, include diagrams, top-level params * 🔥 Simplify code and docs for callbacks as default_response_class is no longer required * 📝 Add docs for top-level dependencies, in FastAPI() * 📝 Add docs reference to top-level dependencies in docs for decorator * ✅ Update/increase tests for Bigger Applications including shared parameters * ✅ Add tests for top-level dependencies in FastAPI() * ✅ Add tests for internal DefaultPlaceholder * ✅ Update/increase tests for callbacks with top-level parameters * ✅ Add LOTS of tests covering branches and cases for shared parameters in top-level FastAPI, path operations, include_router, APIRouter, its path operations, nested include_router, nested APIRouter, and its path operations * 🎨 Format/reorder parameters for consistency in FastAPI, APIRouter, include_router --- docs/en/docs/advanced/openapi-callbacks.md | 9 - .../tutorial/bigger-applications/image01.png | Bin 77899 -> 74516 bytes .../bigger-applications/package.drawio | 43 + .../tutorial/bigger-applications/package.svg | 1 + docs/en/docs/tutorial/bigger-applications.md | 329 +- ...pendencies-in-path-operation-decorators.md | 9 + .../dependencies/global-dependencies.md | 17 + docs/en/mkdocs.yml | 1 + .../bigger_applications/app/dependencies.py | 11 + .../app/internal/__init__.py | 0 .../bigger_applications/app/internal/admin.py | 8 + docs_src/bigger_applications/app/main.py | 25 +- .../bigger_applications/app/routers/items.py | 28 +- .../bigger_applications/app/routers/users.py | 2 +- docs_src/dependencies/tutorial012.py | 25 + docs_src/openapi_callbacks/tutorial001.py | 3 +- fastapi/applications.py | 112 +- fastapi/datastructures.py | 33 +- fastapi/openapi/utils.py | 11 +- fastapi/routing.py | 185 +- fastapi/utils.py | 19 + tests/test_datastructures.py | 15 + .../test_include_router_defaults_overrides.py | 6613 +++++++++++++++++ tests/test_sub_callbacks.py | 70 +- .../test_bigger_applications/test_main.py | 295 +- .../test_dependencies/test_tutorial012.py | 209 + 26 files changed, 7786 insertions(+), 287 deletions(-) create mode 100644 docs/en/docs/img/tutorial/bigger-applications/package.drawio create mode 100644 docs/en/docs/img/tutorial/bigger-applications/package.svg create mode 100644 docs/en/docs/tutorial/dependencies/global-dependencies.md create mode 100644 docs_src/bigger_applications/app/dependencies.py create mode 100644 docs_src/bigger_applications/app/internal/__init__.py create mode 100644 docs_src/bigger_applications/app/internal/admin.py create mode 100644 docs_src/dependencies/tutorial012.py create mode 100644 tests/test_include_router_defaults_overrides.py create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial012.py diff --git a/docs/en/docs/advanced/openapi-callbacks.md b/docs/en/docs/advanced/openapi-callbacks.md index e927aea4d..138c90dd7 100644 --- a/docs/en/docs/advanced/openapi-callbacks.md +++ b/docs/en/docs/advanced/openapi-callbacks.md @@ -83,15 +83,6 @@ So we are going to use that same knowledge to document how the *external API* sh First create a new `APIRouter` that will contain one or more callbacks. -This router will never be added to an actual `FastAPI` app (i.e. it will never be passed to `app.include_router(...)`). - -Because of that, you need to declare what will be the `default_response_class`, and set it to `JSONResponse`. - -!!! Note "Technical Details" - The `response_class` is normally set by the `FastAPI` app during the call to `app.include_router(some_router)`. - - But as we are never calling `app.include_router(some_router)`, we need to set the `default_response_class` during creation of the `APIRouter`. - ```Python hl_lines="5 26" {!../../../docs_src/openapi_callbacks/tutorial001.py!} ``` diff --git a/docs/en/docs/img/tutorial/bigger-applications/image01.png b/docs/en/docs/img/tutorial/bigger-applications/image01.png index f31195934b6892ef73d1f5da15daca6be7c40ec5..faba6628e765abca6ec4b534989cb9e371648af8 100644 GIT binary patch literal 74516 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 dHjAB6CK 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 Nz|+;wWt~$(69D33F`@tf literal 77899 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 diff --git a/docs/en/docs/img/tutorial/bigger-applications/package.drawio b/docs/en/docs/img/tutorial/bigger-applications/package.drawio new file mode 100644 index 000000000..48f6e76fe --- /dev/null +++ b/docs/en/docs/img/tutorial/bigger-applications/package.drawio @@ -0,0 +1,43 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/en/docs/img/tutorial/bigger-applications/package.svg b/docs/en/docs/img/tutorial/bigger-applications/package.svg new file mode 100644 index 000000000..a9cec926a --- /dev/null +++ b/docs/en/docs/img/tutorial/bigger-applications/package.svg @@ -0,0 +1 @@ +
Package app
app/__init__.py
Package app...
Module app.main
app/main.py
Module app.main...
Module app.dependencies
app/dependencies.py
Module app.dependencies...
Subpackage app.internal
app/internal/__init__.py
Subpackage app.internal...
Module app.internal.admin
app/internal/admin.py
Module app.internal.admin...
Subpackage app.routers
app/routers/__init__.py
Subpackage app.routers...
Module app.routers.items
app/routers/items.py
Module app.routers.items...
Module app.routers.users
app/routers/users.py
Module app.routers.users...Viewer does not support full SVG 1.1 \ No newline at end of file diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md index ab151f8f3..2796d7fb1 100644 --- a/docs/en/docs/tutorial/bigger-applications.md +++ b/docs/en/docs/tutorial/bigger-applications.md @@ -16,14 +16,18 @@ Let's say you have a file structure like this: ├── app │   ├── __init__.py │   ├── main.py +│   ├── dependencies.py │   └── routers +│   │ ├── __init__.py +│   │ ├── items.py +│   │ └── users.py +│   └── internal │   ├── __init__.py -│   ├── items.py -│   └── users.py +│   └── admin.py ``` !!! tip - There are two `__init__.py` files: one in each directory or subdirectory. + There are several `__init__.py` files: one in each directory or subdirectory. This is what allows importing code from one file into another. @@ -33,18 +37,33 @@ Let's say you have a file structure like this: from app.routers import items ``` -* The `app` directory contains everything. -* This `app` directory has an empty file `app/__init__.py`. - * So, the `app` directory is a "Python package" (a collection of "Python modules"). -* The `app` directory also has a `app/main.py` file. - * As it is inside a Python package directory (because there's a file `__init__.py`), it is a "module" of that package: `app.main`. -* There's a subdirectory `app/routers/`. -* The subdirectory `app/routers` also has an empty file `__init__.py`. - * So, it is a "Python subpackage". -* The file `app/routers/items.py` is beside the `app/routers/__init__.py`. - * So, it's a submodule: `app.routers.items`. -* The file `app/routers/users.py` is beside the `app/routers/__init__.py`. - * So, it's a submodule: `app.routers.users`. +* The `app` directory contains everything. And it has an empty file `app/__init__.py`, so it is a "Python package" (a collection of "Python modules"): `app`. +* It contains an `app/main.py` file. As it is inside a Python package (a directory with a file `__init__.py`), it is a "module" of that package: `app.main`. +* There's also an `app/dependencies.py` file, just like `app/main.py`, it is a "module": `app.dependencies`. +* There's a subdirectory `app/routers/` with another file `__init__.py`, so it's a "Python subpackage": `app.routers`. +* The file `app/routers/items.py` is inside a package, `app/routers/`, so, it's a submodule: `app.routers.items`. +* The same with `app/routers/users.py`, it's another submodule: `app.routers.users`. +* There's also a subdirectory `app/internal/` with another file `__init__.py`, so it's another "Python subpackage": `app.internal`. +* And the file `app/internal/admin.py` is another submodule: `app.internal.admin`. + + + +The same file structure with comments: + +``` +. +├── app # "app" is a Python package +│   ├── __init__.py # this file makes "app" a "Python package" +│   ├── main.py # "main" module, e.g. import app.main +│   ├── dependencies.py # "dependencies" module, e.g. import app.dependencies +│   └── routers # "routers" is a "Python subpackage" +│   │ ├── __init__.py # makes "routers" a "Python subpackage" +│   │ ├── items.py # "items" submodule, e.g. import app.routers.items +│   │ └── users.py # "users" submodule, e.g. import app.routers.users +│   └── internal # "internal" is a "Python subpackage" +│   ├── __init__.py # makes "internal" a "Python subpackage" +│   └── admin.py # "admin" submodule, e.g. import app.internal.admin +``` ## `APIRouter` @@ -78,16 +97,33 @@ You can think of `APIRouter` as a "mini `FastAPI`" class. All the same options are supported. -All the same parameters, responses, dependencies, tags, etc. +All the same `parameters`, `responses`, `dependencies`, `tags`, etc. !!! tip In this example, the variable is called `router`, but you can name it however you want. -We are going to include this `APIRouter` in the main `FastAPI` app, but first, let's add another `APIRouter`. +We are going to include this `APIRouter` in the main `FastAPI` app, but first, let's check the dependencies and another `APIRouter`. + +## Dependencies + +We see that we are going to need some dependencies used in several places of the application. + +So we put them in their own `dependencies` module (`app/dependencies.py`). + +We will now use a simple dependency to read a custom `X-Token` header: + +```Python hl_lines="1 4-6" +{!../../../docs_src/bigger_applications/app/dependencies.py!} +``` + +!!! tip + We are using an invented header to simplify this example. + + But in real cases you will get better results using the integrated [Security utilities](./security/index.md){.internal-link target=_blank}. ## Another module with `APIRouter` -Let's say you also have the endpoints dedicated to handling "Items" from your application in the module at `app/routers/items.py`. +Let's say you also have the endpoints dedicated to handling "items" from your application in the module at `app/routers/items.py`. You have *path operations* for: @@ -96,24 +132,148 @@ You have *path operations* for: It's all the same structure as with `app/routers/users.py`. -But let's say that this time we are more lazy. +But we want to be smarter and simplify the code a bit. + +We know all the *path operations* in this module have the same: + +* Path `prefix`: `/items`. +* `tags`: (just one tag: `items`). +* Extra `responses`. +* `dependencies`: they all need that `X-Token` dependency we created. + +So, instead of adding all that to each *path operation*, we can add it to the `APIRouter`. + +```Python hl_lines="5-10 16 21" +{!../../../docs_src/bigger_applications/app/routers/items.py!} +``` + +As the path of each *path operation* has to start with `/`, like in: + +```Python hl_lines="1" +@router.get("/{item_id}") +async def read_item(item_id: str): + ... +``` + +...the prefix must not include a final `/`. + +So, the prefix in this case is `/items`. + +We can also add a list of `tags` and extra `responses` that will be applied to all the *path operations* included in this router. + +And we can add a list of `dependencies` that will be added to all the *path operations* in the router and will be executed/solved for each request made to them. -And we don't want to have to explicitly type `/items/` and `tags=["items"]` in every *path operation* (we will be able to do it later): +!!! tip + Note that, much like [dependencies in *path operation decorators*](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, no value will be passed to your *path operation function*. + +The end result is that the item paths are now: + +* `/items/` +* `/items/{item_id}` + +...as we intended. + +* They will be marked with a list of tags that contain a single string `"items"`. + * These "tags" are especially useful for the automatic interactive documentation systems (using OpenAPI). +* All of them will include the predefined `responses`. +* All these *path operations* will have the list of `dependencies` evaluated/executed before them. + * If you also declare dependencies in a specific *path operation*, **they will be executed too**. + * The router dependencies are executed first, then the [`dependencies` in the decorator](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, and then the normal parameter dependencies. + * You can also add [`Security` dependencies with `scopes`](../advanced/security/oauth2-scopes.md){.internal-link target=_blank}. + +!!! tip + Having `dependencies` in the `APIRouter` can be used, for example, to require authentication for a whole group of *path operations*. Even if the dependencies are not added individually to each one of them. + +!!! check + The `prefix`, `tags`, `responses`, and `dependencies` parameters are (as in many other cases) just a feature from **FastAPI** to help you avoid code duplication. + +### Import the dependencies + +This codes lives in the module `app.routers.items`, the file `app/routers/items.py`. -```Python hl_lines="6 11" +And we need to get the dependency function from the module `app.dependencies`, the file `app/dependencies.py`. + +So we use a relative import with `..` for the dependencies: + +```Python hl_lines="3" {!../../../docs_src/bigger_applications/app/routers/items.py!} ``` +#### How relative imports work + +!!! tip + If you know perfectly how imports work, continue to the next section below. + +A single dot `.`, like in: + +```Python +from .dependencies import get_token_header +``` + +would mean: + +* Starting in the same package that this module (the file `app/routers/items.py`) lives in (the directory `app/routers/`)... +* find the module `dependencies` (an imaginary file at `app/routers/dependencies.py`)... +* and from it, import the function `get_token_header`. + +But that file doesn't exist, our dependencies are in a file at `app/dependencies.py`. + +Remember how our app/file structure looks like: + + + +--- + +The two dots `..`, like in: + +```Python +from ..dependencies import get_token_header +``` + +mean: + +* Starting in the same package that this module (the file `app/routers/items.py`) lives in (the directory `app/routers/`)... +* go to the parent package (the directory `app/`)... +* and in there, find the module `dependencies` (the file at `app/routers/dependencies.py`)... +* and from it, import the function `get_token_header`. + +That works correctly! 🎉 + +--- + +The same way, if we had used three dots `...`, like in: + +```Python +from ...dependencies import get_token_header +``` + +that would mean: + +* Starting in the same package that this module (the file `app/routers/items.py`) lives in (the directory `app/routers/`)... +* go to the parent package (the directory `app/`)... +* then go to the parent of that package (there's no parent package, `app` is the top level 😱)... +* and in there, find the module `dependencies` (the file at `app/routers/dependencies.py`)... +* and from it, import the function `get_token_header`. + +That would refer to some package above `app/`, with its own file `__init__.py`, etc. But we don't have that. So, that would throw an error in our example. 🚨 + +But now you know how it works, so you can use relative imports in your own apps no matter how complex they are. 🤓 + ### Add some custom `tags`, `responses`, and `dependencies` -We are not adding the prefix `/items/` nor the `tags=["items"]` to add them later. +We are not adding the prefix `/items` nor the `tags=["items"]` to each *path operation* because we added them to the `APIRouter`. -But we can add custom `tags` and `responses` that will be applied to a specific *path operation*: +But we can still add _more_ `tags` that will be applied to a specific *path operation*, and also some extra `responses` specific to that *path operation*: -```Python hl_lines="18-19" +```Python hl_lines="30-31" {!../../../docs_src/bigger_applications/app/routers/items.py!} ``` +!!! tip + This last path operation will have the combination of tags: `["items", "custom"]`. + + And it will also have both responses in the documentation, one for `404` and one for `403`. + ## The main `FastAPI` Now, let's see the module at `app/main.py`. @@ -122,25 +282,27 @@ Here's where you import and use the class `FastAPI`. This will be the main file in your application that ties everything together. +And as most of your logic will now live in its own specific module, the main file will be quite simple. + ### Import `FastAPI` -You import and create a `FastAPI` class as normally: +You import and create a `FastAPI` class as normally. -```Python hl_lines="1 5" +And we can even declare [global dependencies](dependencies/global-dependencies.md){.internal-link target=_blank} that will be combined with the dependencies for each `APIRouter`: + +```Python hl_lines="1 3 7" {!../../../docs_src/bigger_applications/app/main.py!} ``` ### Import the `APIRouter` -But this time we are not adding *path operations* directly with the `FastAPI` `app`. - -We import the other submodules that have `APIRouter`s: +Now we import the other submodules that have `APIRouter`s: -```Python hl_lines="3" +```Python hl_lines="5" {!../../../docs_src/bigger_applications/app/main.py!} ``` -As the file `app/routers/items.py` is part of the same Python package, we can import it using "dot notation". +As the files `app/routers/users.py` and `app/routers/items.py` are submodules that are part of the same Python package `app`, we can use a single dot `.` to import them using "relative imports". ### How the importing works @@ -156,7 +318,9 @@ Means: * look for the subpackage `routers` (the directory at `app/routers/`)... * and from it, import the submodule `items` (the file at `app/routers/items.py`) and `users` (the file at `app/routers/users.py`)... -The module `items` will have a variable `router` (`items.router`). This is the same one we created in the file `app/routers/items.py`. It's an `APIRouter`. The same for the module `users`. +The module `items` will have a variable `router` (`items.router`). This is the same one we created in the file `app/routers/items.py`, it's an `APIRouter` object. + +And then we do the same for the module `users`. We could also import them like: @@ -165,9 +329,17 @@ from app.routers import items, users ``` !!! info - The first version is a "relative import". + The first version is a "relative import": + + ```Python + from .routers import items, users + ``` + + The second version is an "absolute import": - The second version is an "absolute import". + ```Python + from app.routers import items, users + ``` To learn more about Python Packages and Modules, read the official Python documentation about Modules. @@ -188,22 +360,24 @@ The `router` from `users` would overwrite the one from `items` and we wouldn't b So, to be able to use both of them in the same file, we import the submodules directly: -```Python hl_lines="3" +```Python hl_lines="4" {!../../../docs_src/bigger_applications/app/main.py!} ``` -### Include an `APIRouter` +### Include the `APIRouter`s for `users` and `items` -Now, let's include the `router` from the submodule `users`: +Now, let's include the `router`s from the submodules `users` and `items`: -```Python hl_lines="13" +```Python hl_lines="10-11" {!../../../docs_src/bigger_applications/app/main.py!} ``` !!! info `users.router` contains the `APIRouter` inside of the file `app/routers/users.py`. -With `app.include_router()` we can add an `APIRouter` to the main `FastAPI` application. + And `items.router` contains the `APIRouter` inside of the file `app/routers/items.py`. + +With `app.include_router()` we can add each `APIRouter` to the main `FastAPI` application. It will include all the routes from that router as part of it. @@ -217,67 +391,52 @@ It will include all the routes from that router as part of it. This will take microseconds and will only happen at startup. - So it won't affect performance. + So it won't affect performance. ⚡ -### Include an `APIRouter` with a `prefix`, `tags`, `responses`, and `dependencies` +### Include an `APIRouter` with a custom `prefix`, `tags`, `responses`, and `dependencies` -Now, let's include the router from the `items` submodule. +Now, let's imagine your organization gave you the `app/internal/admin.py` file. -But, remember that we were lazy and didn't add `/items/` nor `tags` to all the *path operations*? +It contains an `APIRouter` with some admin *path operations* that your organization shares between several projects. -We can add a prefix to all the *path operations* using the parameter `prefix` of `app.include_router()`. +For this example it will be super simple. But let's say that because it is shared with other projects in the organization, we cannot modify it and add a `prefix`, `dependencies`, `tags`, etc. directly to the `APIRouter`: -As the path of each *path operation* has to start with `/`, like in: - -```Python hl_lines="1" -@router.get("/{item_id}") -async def read_item(item_id: str): - ... +```Python hl_lines="3" +{!../../../docs_src/bigger_applications/app/internal/admin.py!} ``` -...the prefix must not include a final `/`. - -So, the prefix in this case would be `/items`. - -We can also add a list of `tags` that will be applied to all the *path operations* included in this router. +But we still want to set a custom `prefix` when including the `APIRouter` so that all its *path operations* start with `/admin`, we want to secure it with the `dependencies` we already have for this project, and we want to include `tags` and `responses`. -And we can add predefined `responses` that will be included in all the *path operations* too. +We can declare all that without having to modify the original `APIRouter` by passing those parameters to `app.include_router()`: -And we can add a list of `dependencies` that will be added to all the *path operations* in the router and will be executed/solved for each request made to them. Note that, much like dependencies in *path operation decorators*, no value will be passed to your *path operation function*. - -```Python hl_lines="8-10 14-20" +```Python hl_lines="14-17" {!../../../docs_src/bigger_applications/app/main.py!} ``` -The end result is that the item paths are now: +That way, the original `APIRouter` will keep unmodified, so we can still share that same `app/internal/admin.py` file with other projects in the organization. -* `/items/` -* `/items/{item_id}` +The result is that in our app, each of the *path operations* from the `admin` module will have: -...as we intended. +* The prefix `/admin`. +* The tag `admin`. +* The dependency `get_token_header`. +* The response `418`. 🍵 -* They will be marked with a list of tags that contain a single string `"items"`. -* The *path operation* that declared a `"custom"` tag will have both tags, `items` and `custom`. - * These "tags" are especially useful for the automatic interactive documentation systems (using OpenAPI). -* All of them will include the predefined `responses`. -* The *path operation* that declared a custom `403` response will have both the predefined responses (`404`) and the `403` declared in it directly. -* All these *path operations* will have the list of `dependencies` evaluated/executed before them. - * If you also declare dependencies in a specific *path operation*, **they will be executed too**. - * The router dependencies are executed first, then the [`dependencies` in the decorator](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, and then the normal parameter dependencies. - * You can also add [`Security` dependencies with `scopes`](../advanced/security/oauth2-scopes.md){.internal-link target=_blank}. +But that will only affect that `APIRouter` in our app, not in any other code that uses it. -!!! tip - Having `dependencies` in a decorator can be used, for example, to require authentication for a whole group of *path operations*. Even if the dependencies are not added individually to each one of them. +So, for example, other projects could use the same `APIRouter` with a different authentication method. -!!! check - The `prefix`, `tags`, `responses` and `dependencies` parameters are (as in many other cases) just a feature from **FastAPI** to help you avoid code duplication. +### Include a *path operation* -!!! tip - You could also add *path operations* directly, for example with: `@app.get(...)`. +We can also add *path operations* directly to the `FastAPI` app. + +Here we do it... just to show that we can 🤷: - Apart from `app.include_router()`, in the same **FastAPI** app. +```Python hl_lines="21-23" +{!../../../docs_src/bigger_applications/app/main.py!} +``` - It would still work the same. +and it will work correctly, together with all the other *path operations* added with `app.include_router()`. !!! info "Very Technical Details" **Note**: this is a very technical detail that you probably can **just skip**. @@ -317,3 +476,13 @@ You can also use `.include_router()` multiple times with the *same* router using This could be useful, for example, to expose the same API under different prefixes, e.g. `/api/v1` and `/api/latest`. This is an advanced usage that you might not really need, but it's there in case you do. + +## Include an `APIRouter` in another + +The same way you can include an `APIRouter` in a `FastAPI` application, you can include an `APIRouter` in another `APIRouter` using: + +```Python +router.include_router(other_router) +``` + +Make sure you do it before including `router` in the `FastAPI` app, so that the *path operations* from `other_router` are also included. diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md index a52dbdfbe..a1bbcc6c7 100644 --- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md +++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md @@ -27,6 +27,11 @@ These dependencies will be executed/solved the same way normal dependencies. But It might also help avoid confusion for new developers that see an unused parameter in your code and could think it's unnecessary. +!!! info + In this example we use invented custom headers `X-Key` and `X-Token`. + + But in real cases, when implementing security, you would get more benefits from using the integrated [Security utilities (the next chapter)](../security/index.md){.internal-link target=_blank}. + ## Dependencies errors and return values You can use the same dependency *functions* you use normally. @@ -60,3 +65,7 @@ So, you can re-use a normal dependency (that returns a value) you already use so ## Dependencies for a group of *path operations* Later, when reading about how to structure bigger applications ([Bigger Applications - Multiple Files](../../tutorial/bigger-applications.md){.internal-link target=_blank}), possibly with multiple files, you will learn how to declare a single `dependencies` parameter for a group of *path operations*. + +## Global Dependencies + +Next we will see how to add dependencies to the whole `FastAPI` application, so that they apply to each *path operation*. diff --git a/docs/en/docs/tutorial/dependencies/global-dependencies.md b/docs/en/docs/tutorial/dependencies/global-dependencies.md new file mode 100644 index 000000000..bcd61d52b --- /dev/null +++ b/docs/en/docs/tutorial/dependencies/global-dependencies.md @@ -0,0 +1,17 @@ +# Global Dependencies + +For some types of applications you might want to add dependencies to the whole application. + +Similar to the way you can [add `dependencies` to the *path operation decorators*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, you can add them to the `FastAPI` application. + +In that case, they will be applied to all the *path operations* in the application: + +```Python hl_lines="15" +{!../../../docs_src/dependencies/tutorial012.py!} +``` + +And all the ideas in the section about [adding `dependencies` to the *path operation decorators*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} still apply, but in this case, to all of the *path operations* in the app. + +## Dependencies for groups of *path operations* + +Later, when reading about how to structure bigger applications ([Bigger Applications - Multiple Files](../../tutorial/bigger-applications.md){.internal-link target=_blank}), possibly with multiple files, you will learn how to declare a single `dependencies` parameter for a group of *path operations*. diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml index 2ab06113b..0f4a60070 100644 --- a/docs/en/mkdocs.yml +++ b/docs/en/mkdocs.yml @@ -81,6 +81,7 @@ nav: - tutorial/dependencies/classes-as-dependencies.md - tutorial/dependencies/sub-dependencies.md - tutorial/dependencies/dependencies-in-path-operation-decorators.md + - tutorial/dependencies/global-dependencies.md - tutorial/dependencies/dependencies-with-yield.md - Security: - tutorial/security/index.md diff --git a/docs_src/bigger_applications/app/dependencies.py b/docs_src/bigger_applications/app/dependencies.py new file mode 100644 index 000000000..267b0d3a8 --- /dev/null +++ b/docs_src/bigger_applications/app/dependencies.py @@ -0,0 +1,11 @@ +from fastapi import Header, HTTPException + + +async def get_token_header(x_token: str = Header(...)): + if x_token != "fake-super-secret-token": + raise HTTPException(status_code=400, detail="X-Token header invalid") + + +async def get_query_token(token: str): + if token != "jessica": + raise HTTPException(status_code=400, detail="No Jessica token provided") diff --git a/docs_src/bigger_applications/app/internal/__init__.py b/docs_src/bigger_applications/app/internal/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/docs_src/bigger_applications/app/internal/admin.py b/docs_src/bigger_applications/app/internal/admin.py new file mode 100644 index 000000000..99d3da86b --- /dev/null +++ b/docs_src/bigger_applications/app/internal/admin.py @@ -0,0 +1,8 @@ +from fastapi import APIRouter + +router = APIRouter() + + +@router.post("/") +async def update_admin(): + return {"message": "Admin getting schwifty"} diff --git a/docs_src/bigger_applications/app/main.py b/docs_src/bigger_applications/app/main.py index fdff13947..ae544a3aa 100644 --- a/docs_src/bigger_applications/app/main.py +++ b/docs_src/bigger_applications/app/main.py @@ -1,20 +1,23 @@ -from fastapi import Depends, FastAPI, Header, HTTPException +from fastapi import Depends, FastAPI +from .dependencies import get_query_token, get_token_header +from .internal import admin from .routers import items, users -app = FastAPI() - - -async def get_token_header(x_token: str = Header(...)): - if x_token != "fake-super-secret-token": - raise HTTPException(status_code=400, detail="X-Token header invalid") +app = FastAPI(dependencies=[Depends(get_query_token)]) app.include_router(users.router) +app.include_router(items.router) app.include_router( - items.router, - prefix="/items", - tags=["items"], + admin.router, + prefix="/admin", + tags=["admin"], dependencies=[Depends(get_token_header)], - responses={404: {"description": "Not found"}}, + responses={418: {"description": "I'm a teapot"}}, ) + + +@app.get("/") +async def root(): + return {"message": "Hello Bigger Applications!"} diff --git a/docs_src/bigger_applications/app/routers/items.py b/docs_src/bigger_applications/app/routers/items.py index de5d9b645..bde9ff4d5 100644 --- a/docs_src/bigger_applications/app/routers/items.py +++ b/docs_src/bigger_applications/app/routers/items.py @@ -1,16 +1,28 @@ -from fastapi import APIRouter, HTTPException +from fastapi import APIRouter, Depends, HTTPException -router = APIRouter() +from ..dependencies import get_token_header + +router = APIRouter( + prefix="/items", + tags=["items"], + dependencies=[Depends(get_token_header)], + responses={404: {"description": "Not found"}}, +) + + +fake_items_db = {"plumbus": {"name": "Plumbus"}, "gun": {"name": "Portal Gun"}} @router.get("/") async def read_items(): - return [{"name": "Item Foo"}, {"name": "item Bar"}] + return fake_items_db @router.get("/{item_id}") async def read_item(item_id: str): - return {"name": "Fake Specific Item", "item_id": item_id} + if item_id not in fake_items_db: + raise HTTPException(status_code=404, detail="Item not found") + return {"name": fake_items_db[item_id]["name"], "item_id": item_id} @router.put( @@ -19,6 +31,8 @@ async def read_item(item_id: str): responses={403: {"description": "Operation forbidden"}}, ) async def update_item(item_id: str): - if item_id != "foo": - raise HTTPException(status_code=403, detail="You can only update the item: foo") - return {"item_id": item_id, "name": "The Fighters"} + if item_id != "plumbus": + raise HTTPException( + status_code=403, detail="You can only update the item: plumbus" + ) + return {"item_id": item_id, "name": "The great Plumbus"} diff --git a/docs_src/bigger_applications/app/routers/users.py b/docs_src/bigger_applications/app/routers/users.py index e88b20cd1..39b3d7e7c 100644 --- a/docs_src/bigger_applications/app/routers/users.py +++ b/docs_src/bigger_applications/app/routers/users.py @@ -5,7 +5,7 @@ router = APIRouter() @router.get("/users/", tags=["users"]) async def read_users(): - return [{"username": "Foo"}, {"username": "Bar"}] + return [{"username": "Rick"}, {"username": "Morty"}] @router.get("/users/me", tags=["users"]) diff --git a/docs_src/dependencies/tutorial012.py b/docs_src/dependencies/tutorial012.py new file mode 100644 index 000000000..8f8868a55 --- /dev/null +++ b/docs_src/dependencies/tutorial012.py @@ -0,0 +1,25 @@ +from fastapi import Depends, FastAPI, Header, HTTPException + + +async def verify_token(x_token: str = Header(...)): + if x_token != "fake-super-secret-token": + raise HTTPException(status_code=400, detail="X-Token header invalid") + + +async def verify_key(x_key: str = Header(...)): + if x_key != "fake-super-secret-key": + raise HTTPException(status_code=400, detail="X-Key header invalid") + return x_key + + +app = FastAPI(dependencies=[Depends(verify_token), Depends(verify_key)]) + + +@app.get("/items/") +async def read_items(): + return [{"item": "Portal Gun"}, {"item": "Plumbus"}] + + +@app.get("/users/") +async def read_users(): + return [{"username": "Rick"}, {"username": "Morty"}] diff --git a/docs_src/openapi_callbacks/tutorial001.py b/docs_src/openapi_callbacks/tutorial001.py index dea7e89b4..f04fec4d7 100644 --- a/docs_src/openapi_callbacks/tutorial001.py +++ b/docs_src/openapi_callbacks/tutorial001.py @@ -1,7 +1,6 @@ from typing import Optional from fastapi import APIRouter, FastAPI -from fastapi.responses import JSONResponse from pydantic import BaseModel, HttpUrl app = FastAPI() @@ -23,7 +22,7 @@ class InvoiceEventReceived(BaseModel): ok: bool -invoices_callback_router = APIRouter(default_response_class=JSONResponse) +invoices_callback_router = APIRouter() @invoices_callback_router.post( diff --git a/fastapi/applications.py b/fastapi/applications.py index 24a242a4e..519dc74ae 100644 --- a/fastapi/applications.py +++ b/fastapi/applications.py @@ -2,6 +2,7 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Type, Union from fastapi import routing from fastapi.concurrency import AsyncExitStack +from fastapi.datastructures import Default, DefaultPlaceholder from fastapi.encoders import DictIntStrAny, SetIntStr from fastapi.exception_handlers import ( http_exception_handler, @@ -38,7 +39,8 @@ class FastAPI(Starlette): openapi_url: Optional[str] = "/openapi.json", openapi_tags: Optional[List[Dict[str, Any]]] = None, servers: Optional[List[Dict[str, Union[str, Any]]]] = None, - default_response_class: Type[Response] = JSONResponse, + dependencies: Optional[Sequence[Depends]] = None, + default_response_class: Type[Response] = Default(JSONResponse), docs_url: Optional[str] = "/docs", redoc_url: Optional[str] = "/redoc", swagger_ui_oauth2_redirect_url: Optional[str] = "/docs/oauth2-redirect", @@ -52,16 +54,25 @@ class FastAPI(Starlette): openapi_prefix: str = "", root_path: str = "", root_path_in_servers: bool = True, + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + callbacks: Optional[List[routing.APIRoute]] = None, + deprecated: bool = None, + include_in_schema: bool = True, **extra: Any, ) -> None: - self.default_response_class = default_response_class self._debug = debug self.state = State() self.router: routing.APIRouter = routing.APIRouter( - routes, + routes=routes, dependency_overrides_provider=self, on_startup=on_startup, on_shutdown=on_shutdown, + default_response_class=default_response_class, + dependencies=dependencies, + callbacks=callbacks, + deprecated=deprecated, + include_in_schema=include_in_schema, + responses=responses, ) self.exception_handlers = ( {} if exception_handlers is None else dict(exception_handlers) @@ -203,7 +214,9 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), name: Optional[str] = None, ) -> None: self.router.add_api_route( @@ -211,12 +224,12 @@ class FastAPI(Starlette): endpoint=endpoint, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=methods, operation_id=operation_id, @@ -227,7 +240,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, ) @@ -253,7 +266,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, ) -> Callable: def decorator(func: Callable) -> Callable: @@ -262,12 +275,12 @@ class FastAPI(Starlette): func, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=methods, operation_id=operation_id, @@ -278,7 +291,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, ) return func @@ -305,16 +318,21 @@ class FastAPI(Starlette): tags: Optional[List[str]] = None, dependencies: Optional[Sequence[Depends]] = None, responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, - default_response_class: Optional[Type[Response]] = None, + deprecated: bool = None, + include_in_schema: bool = True, + default_response_class: Type[Response] = Default(JSONResponse), + callbacks: Optional[List[routing.APIRoute]] = None, ) -> None: self.router.include_router( router, prefix=prefix, tags=tags, dependencies=dependencies, - responses=responses or {}, - default_response_class=default_response_class - or self.default_response_class, + responses=responses, + deprecated=deprecated, + include_in_schema=include_in_schema, + default_response_class=default_response_class, + callbacks=callbacks, ) def get( @@ -338,7 +356,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -346,12 +364,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -361,7 +379,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -387,7 +405,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -395,12 +413,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -410,7 +428,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -436,7 +454,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -444,12 +462,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -459,7 +477,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -485,7 +503,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -493,12 +511,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, response_model_include=response_model_include, response_model_exclude=response_model_exclude, @@ -508,7 +526,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -534,7 +552,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -542,12 +560,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -557,7 +575,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -583,7 +601,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -591,12 +609,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -606,7 +624,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -632,7 +650,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -640,12 +658,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -655,7 +673,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -681,7 +699,7 @@ class FastAPI(Starlette): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[routing.APIRoute]] = None, ) -> Callable: @@ -689,12 +707,12 @@ class FastAPI(Starlette): path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, operation_id=operation_id, response_model_include=response_model_include, @@ -704,7 +722,7 @@ class FastAPI(Starlette): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) diff --git a/fastapi/datastructures.py b/fastapi/datastructures.py index 1ee990014..1fe8ebdad 100644 --- a/fastapi/datastructures.py +++ b/fastapi/datastructures.py @@ -1,4 +1,4 @@ -from typing import Any, Callable, Iterable, Type +from typing import Any, Callable, Iterable, Type, TypeVar from starlette.datastructures import UploadFile as StarletteUploadFile @@ -13,3 +13,34 @@ class UploadFile(StarletteUploadFile): if not isinstance(v, StarletteUploadFile): raise ValueError(f"Expected UploadFile, received: {type(v)}") return v + + +class DefaultPlaceholder: + """ + You shouldn't use this class directly. + + It's used internally to recognize when a default value has been overwritten, even + if the overriden default value was truthy. + """ + + def __init__(self, value: Any): + self.value = value + + def __bool__(self) -> bool: + return bool(self.value) + + def __eq__(self, o: object) -> bool: + return isinstance(o, DefaultPlaceholder) and o.value == self.value + + +DefaultType = TypeVar("DefaultType") + + +def Default(value: DefaultType) -> DefaultType: + """ + You shouldn't use this function directly. + + It's used internally to recognize when a default value has been overwritten, even + if the overriden default value was truthy. + """ + return DefaultPlaceholder(value) # type: ignore diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py index cd1b1baad..5547cce4f 100644 --- a/fastapi/openapi/utils.py +++ b/fastapi/openapi/utils.py @@ -3,6 +3,7 @@ from enum import Enum from typing import Any, Dict, List, Optional, Sequence, Set, Tuple, Type, Union, cast from fastapi import routing +from fastapi.datastructures import DefaultPlaceholder from fastapi.dependencies.models import Dependant from fastapi.dependencies.utils import get_flat_dependant, get_flat_params from fastapi.encoders import jsonable_encoder @@ -159,8 +160,12 @@ def get_openapi_path( security_schemes: Dict[str, Any] = {} definitions: Dict[str, Any] = {} assert route.methods is not None, "Methods must be a list" - assert route.response_class, "A response class is needed to generate OpenAPI" - route_response_media_type: Optional[str] = route.response_class.media_type + if isinstance(route.response_class, DefaultPlaceholder): + current_response_class: Type[routing.Response] = route.response_class.value + else: + current_response_class = route.response_class + assert current_response_class, "A response class is needed to generate OpenAPI" + route_response_media_type: Optional[str] = current_response_class.media_type if route.include_in_schema: for method in route.methods: operation = get_openapi_operation_metadata(route=route, method=method) @@ -205,7 +210,7 @@ def get_openapi_path( and route.status_code not in STATUS_CODES_WITH_NO_BODY ): response_schema = {"type": "string"} - if lenient_issubclass(route.response_class, JSONResponse): + if lenient_issubclass(current_response_class, JSONResponse): if route.response_field: response_schema, _, _ = field_schema( route.response_field, diff --git a/fastapi/routing.py b/fastapi/routing.py index e455f81c9..53f35a4a5 100644 --- a/fastapi/routing.py +++ b/fastapi/routing.py @@ -5,6 +5,7 @@ import json from typing import Any, Callable, Dict, List, Optional, Sequence, Set, Type, Union from fastapi import params +from fastapi.datastructures import Default, DefaultPlaceholder from fastapi.dependencies.models import Dependant from fastapi.dependencies.utils import ( get_body_field, @@ -19,6 +20,7 @@ from fastapi.utils import ( create_cloned_field, create_response_field, generate_operation_id_for_path, + get_value_or_default, ) from pydantic import BaseModel from pydantic.error_wrappers import ErrorWrapper, ValidationError @@ -139,7 +141,7 @@ def get_request_handler( dependant: Dependant, body_field: Optional[ModelField] = None, status_code: int = 200, - response_class: Type[Response] = JSONResponse, + response_class: Union[Type[Response], DefaultPlaceholder] = Default(JSONResponse), response_field: Optional[ModelField] = None, response_model_include: Optional[Union[SetIntStr, DictIntStrAny]] = None, response_model_exclude: Optional[Union[SetIntStr, DictIntStrAny]] = None, @@ -152,6 +154,10 @@ def get_request_handler( assert dependant.call is not None, "dependant.call must be a function" is_coroutine = asyncio.iscoroutinefunction(dependant.call) is_body_form = body_field and isinstance(body_field.field_info, params.Form) + if isinstance(response_class, DefaultPlaceholder): + actual_response_class: Type[Response] = response_class.value + else: + actual_response_class = response_class async def app(request: Request) -> Response: try: @@ -198,7 +204,7 @@ def get_request_handler( exclude_none=response_model_exclude_none, is_coroutine=is_coroutine, ) - response = response_class( + response = actual_response_class( content=response_data, status_code=status_code, background=background_tasks, @@ -277,7 +283,9 @@ class APIRoute(routing.Route): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), dependency_overrides_provider: Optional[Any] = None, callbacks: Optional[List["APIRoute"]] = None, ) -> None: @@ -372,7 +380,7 @@ class APIRoute(routing.Route): dependant=self.dependant, body_field=self.body_field, status_code=self.status_code, - response_class=self.response_class or JSONResponse, + response_class=self.response_class, response_field=self.secure_cloned_response_field, response_model_include=self.response_model_include, response_model_exclude=self.response_model_exclude, @@ -387,14 +395,22 @@ class APIRoute(routing.Route): class APIRouter(routing.Router): def __init__( self, + *, + prefix: str = "", + tags: Optional[List[str]] = None, + dependencies: Optional[Sequence[params.Depends]] = None, + default_response_class: Type[Response] = Default(JSONResponse), + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + callbacks: Optional[List[APIRoute]] = None, routes: Optional[List[routing.BaseRoute]] = None, redirect_slashes: bool = True, default: Optional[ASGIApp] = None, dependency_overrides_provider: Optional[Any] = None, route_class: Type[APIRoute] = APIRoute, - default_response_class: Optional[Type[Response]] = None, on_startup: Optional[Sequence[Callable]] = None, on_shutdown: Optional[Sequence[Callable]] = None, + deprecated: bool = None, + include_in_schema: bool = True, ) -> None: super().__init__( routes=routes, @@ -403,6 +419,18 @@ class APIRouter(routing.Router): on_startup=on_startup, on_shutdown=on_shutdown, ) + if prefix: + assert prefix.startswith("/"), "A path prefix must start with '/'" + assert not prefix.endswith( + "/" + ), "A path prefix must not end with '/', as the routes will start with '/'" + self.prefix = prefix + self.tags: List[str] = tags or [] + self.dependencies = list(dependencies or []) or [] + self.deprecated = deprecated + self.include_in_schema = include_in_schema + self.responses = responses or {} + self.callbacks = callbacks or [] self.dependency_overrides_provider = dependency_overrides_provider self.route_class = route_class self.default_response_class = default_response_class @@ -430,24 +458,40 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), name: Optional[str] = None, route_class_override: Optional[Type[APIRoute]] = None, callbacks: Optional[List[APIRoute]] = None, ) -> None: route_class = route_class_override or self.route_class + responses = responses or {} + combined_responses = {**self.responses, **responses} + current_response_class = get_value_or_default( + response_class, self.default_response_class + ) + current_tags = self.tags.copy() + if tags: + current_tags.extend(tags) + current_dependencies = self.dependencies.copy() + if dependencies: + current_dependencies.extend(dependencies) + current_callbacks = self.callbacks.copy() + if callbacks: + current_callbacks.extend(callbacks) route = route_class( - path, + self.prefix + path, endpoint=endpoint, response_model=response_model, status_code=status_code, - tags=tags or [], - dependencies=dependencies, + tags=current_tags, + dependencies=current_dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, - deprecated=deprecated, + responses=combined_responses, + deprecated=deprecated or self.deprecated, methods=methods, operation_id=operation_id, response_model_include=response_model_include, @@ -456,11 +500,11 @@ class APIRouter(routing.Router): response_model_exclude_unset=response_model_exclude_unset, response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, - include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + include_in_schema=include_in_schema and self.include_in_schema, + response_class=current_response_class, name=name, dependency_overrides_provider=self.dependency_overrides_provider, - callbacks=callbacks, + callbacks=current_callbacks, ) self.routes.append(route) @@ -486,7 +530,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -496,12 +540,12 @@ class APIRouter(routing.Router): func, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=methods, operation_id=operation_id, @@ -512,7 +556,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -545,8 +589,11 @@ class APIRouter(routing.Router): prefix: str = "", tags: Optional[List[str]] = None, dependencies: Optional[Sequence[params.Depends]] = None, + default_response_class: Type[Response] = Default(JSONResponse), responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, - default_response_class: Optional[Type[Response]] = None, + callbacks: Optional[List[APIRoute]] = None, + deprecated: bool = None, + include_in_schema: bool = True, ) -> None: if prefix: assert prefix.startswith("/"), "A path prefix must start with '/'" @@ -566,19 +613,39 @@ class APIRouter(routing.Router): for route in router.routes: if isinstance(route, APIRoute): combined_responses = {**responses, **route.responses} + use_response_class = get_value_or_default( + route.response_class, + router.default_response_class, + default_response_class, + self.default_response_class, + ) + current_tags = [] + if tags: + current_tags.extend(tags) + if route.tags: + current_tags.extend(route.tags) + current_dependencies: List[params.Depends] = [] + if dependencies: + current_dependencies.extend(dependencies) + if route.dependencies: + current_dependencies.extend(route.dependencies) + current_callbacks = [] + if callbacks: + current_callbacks.extend(callbacks) + if route.callbacks: + current_callbacks.extend(route.callbacks) self.add_api_route( prefix + route.path, route.endpoint, response_model=route.response_model, status_code=route.status_code, - tags=(route.tags or []) + (tags or []), - dependencies=list(dependencies or []) - + list(route.dependencies or []), + tags=current_tags, + dependencies=current_dependencies, summary=route.summary, description=route.description, response_description=route.response_description, responses=combined_responses, - deprecated=route.deprecated, + deprecated=route.deprecated or deprecated or self.deprecated, methods=route.methods, operation_id=route.operation_id, response_model_include=route.response_model_include, @@ -587,11 +654,13 @@ class APIRouter(routing.Router): response_model_exclude_unset=route.response_model_exclude_unset, response_model_exclude_defaults=route.response_model_exclude_defaults, response_model_exclude_none=route.response_model_exclude_none, - include_in_schema=route.include_in_schema, - response_class=route.response_class or default_response_class, + include_in_schema=route.include_in_schema + and self.include_in_schema + and include_in_schema, + response_class=use_response_class, name=route.name, route_class_override=type(route), - callbacks=route.callbacks, + callbacks=current_callbacks, ) elif isinstance(route, routing.Route): self.add_route( @@ -635,7 +704,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -643,12 +712,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["GET"], operation_id=operation_id, @@ -659,7 +728,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -685,7 +754,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -693,12 +762,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["PUT"], operation_id=operation_id, @@ -709,7 +778,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -735,7 +804,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -743,12 +812,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["POST"], operation_id=operation_id, @@ -759,7 +828,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -785,7 +854,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -793,12 +862,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["DELETE"], operation_id=operation_id, @@ -809,7 +878,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -835,7 +904,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -843,12 +912,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["OPTIONS"], operation_id=operation_id, @@ -859,7 +928,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -885,7 +954,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -893,12 +962,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["HEAD"], operation_id=operation_id, @@ -909,7 +978,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -935,7 +1004,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -943,12 +1012,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["PATCH"], operation_id=operation_id, @@ -959,7 +1028,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) @@ -985,7 +1054,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults: bool = False, response_model_exclude_none: bool = False, include_in_schema: bool = True, - response_class: Optional[Type[Response]] = None, + response_class: Type[Response] = Default(JSONResponse), name: Optional[str] = None, callbacks: Optional[List[APIRoute]] = None, ) -> Callable: @@ -994,12 +1063,12 @@ class APIRouter(routing.Router): path=path, response_model=response_model, status_code=status_code, - tags=tags or [], + tags=tags, dependencies=dependencies, summary=summary, description=description, response_description=response_description, - responses=responses or {}, + responses=responses, deprecated=deprecated, methods=["TRACE"], operation_id=operation_id, @@ -1010,7 +1079,7 @@ class APIRouter(routing.Router): response_model_exclude_defaults=response_model_exclude_defaults, response_model_exclude_none=response_model_exclude_none, include_in_schema=include_in_schema, - response_class=response_class or self.default_response_class, + response_class=response_class, name=name, callbacks=callbacks, ) diff --git a/fastapi/utils.py b/fastapi/utils.py index d5ace9240..058956e32 100644 --- a/fastapi/utils.py +++ b/fastapi/utils.py @@ -5,6 +5,7 @@ from enum import Enum from typing import Any, Dict, Optional, Set, Type, Union, cast import fastapi +from fastapi.datastructures import DefaultPlaceholder, DefaultType from fastapi.openapi.constants import REF_PREFIX from pydantic import BaseConfig, BaseModel, create_model from pydantic.class_validators import Validator @@ -136,3 +137,21 @@ def deep_dict_update(main_dict: dict, update_dict: dict) -> None: deep_dict_update(main_dict[key], update_dict[key]) else: main_dict[key] = update_dict[key] + + +def get_value_or_default( + first_item: Union[DefaultPlaceholder, DefaultType], + *extra_items: Union[DefaultPlaceholder, DefaultType], +) -> Union[DefaultPlaceholder, DefaultType]: + """ + Pass items or `DefaultPlaceholder`s by descending priority. + + The first one to _not_ be a `DefaultPlaceholder` will be returned. + + Otherwise, the first item (a `DefaultPlaceholder`) will be returned. + """ + items = (first_item,) + extra_items + for item in items: + if not isinstance(item, DefaultPlaceholder): + return item + return first_item diff --git a/tests/test_datastructures.py b/tests/test_datastructures.py index 27c6d30b6..43f1a116c 100644 --- a/tests/test_datastructures.py +++ b/tests/test_datastructures.py @@ -1,7 +1,22 @@ import pytest from fastapi import UploadFile +from fastapi.datastructures import Default def test_upload_file_invalid(): with pytest.raises(ValueError): UploadFile.validate("not a Starlette UploadFile") + + +def test_default_placeholder_equals(): + placeholder_1 = Default("a") + placeholder_2 = Default("a") + assert placeholder_1 == placeholder_2 + assert placeholder_1.value == placeholder_2.value + + +def test_default_placeholder_bool(): + placeholder_a = Default("a") + placeholder_b = Default("") + assert placeholder_a + assert not placeholder_b diff --git a/tests/test_include_router_defaults_overrides.py b/tests/test_include_router_defaults_overrides.py new file mode 100644 index 000000000..ecfa0b2fa --- /dev/null +++ b/tests/test_include_router_defaults_overrides.py @@ -0,0 +1,6613 @@ +import pytest +from fastapi import APIRouter, Depends, FastAPI, Response +from fastapi.responses import JSONResponse +from fastapi.testclient import TestClient + + +class ResponseLevel0(JSONResponse): + media_type = "application/x-level-0" + + +class ResponseLevel1(JSONResponse): + media_type = "application/x-level-1" + + +class ResponseLevel2(JSONResponse): + media_type = "application/x-level-2" + + +class ResponseLevel3(JSONResponse): + media_type = "application/x-level-3" + + +class ResponseLevel4(JSONResponse): + media_type = "application/x-level-4" + + +class ResponseLevel5(JSONResponse): + media_type = "application/x-level-5" + + +async def dep0(response: Response): + response.headers["x-level0"] = "True" + + +async def dep1(response: Response): + response.headers["x-level1"] = "True" + + +async def dep2(response: Response): + response.headers["x-level2"] = "True" + + +async def dep3(response: Response): + response.headers["x-level3"] = "True" + + +async def dep4(response: Response): + response.headers["x-level4"] = "True" + + +async def dep5(response: Response): + response.headers["x-level5"] = "True" + + +callback_router0 = APIRouter() + + +@callback_router0.get("/") +async def callback0(level0: str): + pass # pragma: nocover + + +callback_router1 = APIRouter() + + +@callback_router1.get("/") +async def callback1(level1: str): + pass # pragma: nocover + + +callback_router2 = APIRouter() + + +@callback_router2.get("/") +async def callback2(level2: str): + pass # pragma: nocover + + +callback_router3 = APIRouter() + + +@callback_router3.get("/") +async def callback3(level3: str): + pass # pragma: nocover + + +callback_router4 = APIRouter() + + +@callback_router4.get("/") +async def callback4(level4: str): + pass # pragma: nocover + + +callback_router5 = APIRouter() + + +@callback_router5.get("/") +async def callback5(level5: str): + pass # pragma: nocover + + +app = FastAPI( + dependencies=[Depends(dep0)], + responses={ + 400: {"description": "Client error level 0"}, + 500: {"description": "Server error level 0"}, + }, + default_response_class=ResponseLevel0, + callbacks=callback_router0.routes, +) + +router2_override = APIRouter( + prefix="/level2", + tags=["level2a", "level2b"], + dependencies=[Depends(dep2)], + responses={ + 402: {"description": "Client error level 2"}, + 502: {"description": "Server error level 2"}, + }, + default_response_class=ResponseLevel2, + callbacks=callback_router2.routes, + deprecated=True, +) +router2_default = APIRouter() +router4_override = APIRouter( + prefix="/level4", + tags=["level4a", "level4b"], + dependencies=[Depends(dep4)], + responses={ + 404: {"description": "Client error level 4"}, + 504: {"description": "Server error level 4"}, + }, + default_response_class=ResponseLevel4, + callbacks=callback_router4.routes, + deprecated=True, +) +router4_default = APIRouter() + + +@app.get( + "/override1", + tags=["path1a", "path1b"], + responses={ + 401: {"description": "Client error level 1"}, + 501: {"description": "Server error level 1"}, + }, + deprecated=True, + callbacks=callback_router1.routes, + dependencies=[Depends(dep1)], + response_class=ResponseLevel1, +) +async def path1_override(level1: str): + return level1 + + +@app.get("/default1") +async def path1_default(level1: str): + return level1 + + +@router2_override.get( + "/override3", + tags=["path3a", "path3b"], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + deprecated=True, + callbacks=callback_router3.routes, + dependencies=[Depends(dep3)], + response_class=ResponseLevel3, +) +async def path3_override_router2_override(level3: str): + return level3 + + +@router2_override.get("/default3",) +async def path3_default_router2_override(level3: str): + return level3 + + +@router2_default.get( + "/override3", + tags=["path3a", "path3b"], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + deprecated=True, + callbacks=callback_router3.routes, + dependencies=[Depends(dep3)], + response_class=ResponseLevel3, +) +async def path3_override_router2_default(level3: str): + return level3 + + +@router2_default.get("/default3") +async def path3_default_router2_default(level3: str): + return level3 + + +@router4_override.get( + "/override5", + tags=["path5a", "path5b"], + responses={ + 405: {"description": "Client error level 5"}, + 505: {"description": "Server error level 5"}, + }, + deprecated=True, + callbacks=callback_router5.routes, + dependencies=[Depends(dep5)], + response_class=ResponseLevel5, +) +async def path5_override_router4_override(level5: str): + return level5 + + +@router4_override.get("/default5",) +async def path5_default_router4_override(level5: str): + return level5 + + +@router4_default.get( + "/override5", + tags=["path5a", "path5b"], + responses={ + 405: {"description": "Client error level 5"}, + 505: {"description": "Server error level 5"}, + }, + deprecated=True, + callbacks=callback_router5.routes, + dependencies=[Depends(dep5)], + response_class=ResponseLevel5, +) +async def path5_override_router4_default(level5: str): + return level5 + + +@router4_default.get("/default5",) +async def path5_default_router4_default(level5: str): + return level5 + + +router2_override.include_router( + router4_override, + prefix="/level3", + tags=["level3a", "level3b"], + dependencies=[Depends(dep3)], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + default_response_class=ResponseLevel3, + callbacks=callback_router3.routes, +) + +router2_override.include_router( + router4_default, + prefix="/level3", + tags=["level3a", "level3b"], + dependencies=[Depends(dep3)], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + default_response_class=ResponseLevel3, + callbacks=callback_router3.routes, +) + +router2_override.include_router(router4_override) + +router2_override.include_router(router4_default) + +router2_default.include_router( + router4_override, + prefix="/level3", + tags=["level3a", "level3b"], + dependencies=[Depends(dep3)], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + default_response_class=ResponseLevel3, + callbacks=callback_router3.routes, +) + +router2_default.include_router( + router4_default, + prefix="/level3", + tags=["level3a", "level3b"], + dependencies=[Depends(dep3)], + responses={ + 403: {"description": "Client error level 3"}, + 503: {"description": "Server error level 3"}, + }, + default_response_class=ResponseLevel3, + callbacks=callback_router3.routes, +) + +router2_default.include_router(router4_override) + +router2_default.include_router(router4_default) + + +app.include_router( + router2_override, + prefix="/level1", + tags=["level1a", "level1b"], + dependencies=[Depends(dep1)], + responses={ + 401: {"description": "Client error level 1"}, + 501: {"description": "Server error level 1"}, + }, + default_response_class=ResponseLevel1, + callbacks=callback_router1.routes, +) + +app.include_router( + router2_default, + prefix="/level1", + tags=["level1a", "level1b"], + dependencies=[Depends(dep1)], + responses={ + 401: {"description": "Client error level 1"}, + 501: {"description": "Server error level 1"}, + }, + default_response_class=ResponseLevel1, + callbacks=callback_router1.routes, +) + +app.include_router(router2_override) + +app.include_router(router2_default) + +client = TestClient(app) + + +def test_openapi(): + client = TestClient(app) + response = client.get("/openapi.json") + assert response.json() == openapi_schema + + +def test_level1_override(): + response = client.get("/override1?level1=foo") + assert response.json() == "foo" + assert response.headers["content-type"] == "application/x-level-1" + assert "x-level0" in response.headers + assert "x-level1" in response.headers + assert "x-level2" not in response.headers + assert "x-level3" not in response.headers + assert "x-level4" not in response.headers + assert "x-level5" not in response.headers + + +def test_level1_default(): + response = client.get("/default1?level1=foo") + assert response.json() == "foo" + assert response.headers["content-type"] == "application/x-level-0" + assert "x-level0" in response.headers + assert "x-level1" not in response.headers + assert "x-level2" not in response.headers + assert "x-level3" not in response.headers + assert "x-level4" not in response.headers + assert "x-level5" not in response.headers + + +@pytest.mark.parametrize("override1", [True, False]) +@pytest.mark.parametrize("override2", [True, False]) +@pytest.mark.parametrize("override3", [True, False]) +def test_paths_level3(override1, override2, override3): + url = "" + content_type_level = "0" + if override1: + url += "/level1" + content_type_level = "1" + if override2: + url += "/level2" + content_type_level = "2" + if override3: + url += "/override3" + content_type_level = "3" + else: + url += "/default3" + url += "?level3=foo" + response = client.get(url) + assert response.json() == "foo" + assert ( + response.headers["content-type"] == f"application/x-level-{content_type_level}" + ) + assert "x-level0" in response.headers + assert not override1 or "x-level1" in response.headers + assert not override2 or "x-level2" in response.headers + assert not override3 or "x-level3" in response.headers + + +@pytest.mark.parametrize("override1", [True, False]) +@pytest.mark.parametrize("override2", [True, False]) +@pytest.mark.parametrize("override3", [True, False]) +@pytest.mark.parametrize("override4", [True, False]) +@pytest.mark.parametrize("override5", [True, False]) +def test_paths_level5(override1, override2, override3, override4, override5): + url = "" + content_type_level = "0" + if override1: + url += "/level1" + content_type_level = "1" + if override2: + url += "/level2" + content_type_level = "2" + if override3: + url += "/level3" + content_type_level = "3" + if override4: + url += "/level4" + content_type_level = "4" + if override5: + url += "/override5" + content_type_level = "5" + else: + url += "/default5" + url += "?level5=foo" + response = client.get(url) + assert response.json() == "foo" + assert ( + response.headers["content-type"] == f"application/x-level-{content_type_level}" + ) + assert "x-level0" in response.headers + assert not override1 or "x-level1" in response.headers + assert not override2 or "x-level2" in response.headers + assert not override3 or "x-level3" in response.headers + assert not override4 or "x-level4" in response.headers + assert not override5 or "x-level5" in response.headers + + +openapi_schema = { + "openapi": "3.0.2", + "info": {"title": "FastAPI", "version": "0.1.0"}, + "paths": { + "/override1": { + "get": { + "tags": ["path1a", "path1b"], + "summary": "Path1 Override", + "operationId": "path1_override_override1_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level1", "type": "string"}, + "name": "level1", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-1": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/default1": { + "get": { + "summary": "Path1 Default", + "operationId": "path1_default_default1_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level1", "type": "string"}, + "name": "level1", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-0": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + } + }, + } + }, + "/level1/level2/override3": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "path3a", + "path3b", + ], + "summary": "Path3 Override Router2 Override", + "operationId": "path3_override_router2_override_level1_level2_override3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/default3": { + "get": { + "tags": ["level1a", "level1b", "level2a", "level2b"], + "summary": "Path3 Default Router2 Override", + "operationId": "path3_default_router2_override_level1_level2_default3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-2": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level3/level4/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level3a", + "level3b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level1_level2_level3_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level3/level4/default5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level3a", + "level3b", + "level4a", + "level4b", + ], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level1_level2_level3_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level3/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level3a", + "level3b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level1_level2_level3_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level3/default5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level3a", + "level3b", + ], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level1_level2_level3_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level4/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level1_level2_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/level4/default5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "level4a", + "level4b", + ], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level1_level2_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level2a", + "level2b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level1_level2_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level2/default5": { + "get": { + "tags": ["level1a", "level1b", "level2a", "level2b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level1_level2_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-2": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "402": {"description": "Client error level 2"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "502": {"description": "Server error level 2"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/override3": { + "get": { + "tags": ["level1a", "level1b", "path3a", "path3b"], + "summary": "Path3 Override Router2 Default", + "operationId": "path3_override_router2_default_level1_override3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/default3": { + "get": { + "tags": ["level1a", "level1b"], + "summary": "Path3 Default Router2 Default", + "operationId": "path3_default_router2_default_level1_default3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-1": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + } + }, + "/level1/level3/level4/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level3a", + "level3b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level1_level3_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level3/level4/default5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level3a", + "level3b", + "level4a", + "level4b", + ], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level1_level3_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level3/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level3a", + "level3b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level1_level3_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "403": {"description": "Client error level 3"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "503": {"description": "Server error level 3"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level3/default5": { + "get": { + "tags": ["level1a", "level1b", "level3a", "level3b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level1_level3_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + } + }, + "/level1/level4/override5": { + "get": { + "tags": [ + "level1a", + "level1b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level1_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/level4/default5": { + "get": { + "tags": ["level1a", "level1b", "level4a", "level4b"], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level1_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/override5": { + "get": { + "tags": ["level1a", "level1b", "path5a", "path5b"], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level1_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level1/default5": { + "get": { + "tags": ["level1a", "level1b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level1_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-1": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "401": {"description": "Client error level 1"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "501": {"description": "Server error level 1"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback1": { + "/": { + "get": { + "summary": "Callback1", + "operationId": "callback1__get", + "parameters": [ + { + "name": "level1", + "in": "query", + "required": True, + "schema": {"title": "Level1", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + } + }, + "/level2/override3": { + "get": { + "tags": ["level2a", "level2b", "path3a", "path3b"], + "summary": "Path3 Override Router2 Override", + "operationId": "path3_override_router2_override_level2_override3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/default3": { + "get": { + "tags": ["level2a", "level2b"], + "summary": "Path3 Default Router2 Override", + "operationId": "path3_default_router2_override_level2_default3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-2": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level3/level4/override5": { + "get": { + "tags": [ + "level2a", + "level2b", + "level3a", + "level3b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level2_level3_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level3/level4/default5": { + "get": { + "tags": [ + "level2a", + "level2b", + "level3a", + "level3b", + "level4a", + "level4b", + ], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level2_level3_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level3/override5": { + "get": { + "tags": [ + "level2a", + "level2b", + "level3a", + "level3b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level2_level3_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level3/default5": { + "get": { + "tags": ["level2a", "level2b", "level3a", "level3b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level2_level3_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level4/override5": { + "get": { + "tags": [ + "level2a", + "level2b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level2_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/level4/default5": { + "get": { + "tags": ["level2a", "level2b", "level4a", "level4b"], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level2_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/override5": { + "get": { + "tags": ["level2a", "level2b", "path5a", "path5b"], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level2_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level2/default5": { + "get": { + "tags": ["level2a", "level2b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level2_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-2": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "402": {"description": "Client error level 2"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "502": {"description": "Server error level 2"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback2": { + "/": { + "get": { + "summary": "Callback2", + "operationId": "callback2__get", + "parameters": [ + { + "name": "level2", + "in": "query", + "required": True, + "schema": {"title": "Level2", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/override3": { + "get": { + "tags": ["path3a", "path3b"], + "summary": "Path3 Override Router2 Default", + "operationId": "path3_override_router2_default_override3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/default3": { + "get": { + "summary": "Path3 Default Router2 Default", + "operationId": "path3_default_router2_default_default3_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level3", "type": "string"}, + "name": "level3", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-0": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + } + }, + } + }, + "/level3/level4/override5": { + "get": { + "tags": [ + "level3a", + "level3b", + "level4a", + "level4b", + "path5a", + "path5b", + ], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level3_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level3/level4/default5": { + "get": { + "tags": ["level3a", "level3b", "level4a", "level4b"], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level3_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "403": {"description": "Client error level 3"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "503": {"description": "Server error level 3"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level3/override5": { + "get": { + "tags": ["level3a", "level3b", "path5a", "path5b"], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_level3_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "403": {"description": "Client error level 3"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "503": {"description": "Server error level 3"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level3/default5": { + "get": { + "tags": ["level3a", "level3b"], + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_level3_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-3": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "403": {"description": "Client error level 3"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "503": {"description": "Server error level 3"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback3": { + "/": { + "get": { + "summary": "Callback3", + "operationId": "callback3__get", + "parameters": [ + { + "name": "level3", + "in": "query", + "required": True, + "schema": {"title": "Level3", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + } + }, + "/level4/override5": { + "get": { + "tags": ["level4a", "level4b", "path5a", "path5b"], + "summary": "Path5 Override Router4 Override", + "operationId": "path5_override_router4_override_level4_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "404": {"description": "Client error level 4"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "504": {"description": "Server error level 4"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/level4/default5": { + "get": { + "tags": ["level4a", "level4b"], + "summary": "Path5 Default Router4 Override", + "operationId": "path5_default_router4_override_level4_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-4": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "404": {"description": "Client error level 4"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "504": {"description": "Server error level 4"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback4": { + "/": { + "get": { + "summary": "Callback4", + "operationId": "callback4__get", + "parameters": [ + { + "name": "level4", + "in": "query", + "required": True, + "schema": {"title": "Level4", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/override5": { + "get": { + "tags": ["path5a", "path5b"], + "summary": "Path5 Override Router4 Default", + "operationId": "path5_override_router4_default_override5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-5": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "405": {"description": "Client error level 5"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + "505": {"description": "Server error level 5"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + "callback5": { + "/": { + "get": { + "summary": "Callback5", + "operationId": "callback5__get", + "parameters": [ + { + "name": "level5", + "in": "query", + "required": True, + "schema": {"title": "Level5", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, + }, + "deprecated": True, + } + }, + "/default5": { + "get": { + "summary": "Path5 Default Router4 Default", + "operationId": "path5_default_router4_default_default5_get", + "parameters": [ + { + "required": True, + "schema": {"title": "Level5", "type": "string"}, + "name": "level5", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/x-level-0": {"schema": {}}}, + }, + "400": {"description": "Client error level 0"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + "500": {"description": "Server error level 0"}, + }, + "callbacks": { + "callback0": { + "/": { + "get": { + "summary": "Callback0", + "operationId": "callback0__get", + "parameters": [ + { + "name": "level0", + "in": "query", + "required": True, + "schema": {"title": "Level0", "type": "string"}, + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + } + }, + } + }, + }, + "components": { + "schemas": { + "HTTPValidationError": { + "title": "HTTPValidationError", + "type": "object", + "properties": { + "detail": { + "title": "Detail", + "type": "array", + "items": {"$ref": "#/components/schemas/ValidationError"}, + } + }, + }, + "ValidationError": { + "title": "ValidationError", + "required": ["loc", "msg", "type"], + "type": "object", + "properties": { + "loc": { + "title": "Location", + "type": "array", + "items": {"type": "string"}, + }, + "msg": {"title": "Message", "type": "string"}, + "type": {"title": "Error Type", "type": "string"}, + }, + }, + } + }, +} diff --git a/tests/test_sub_callbacks.py b/tests/test_sub_callbacks.py index dc0e3424a..40ca1475d 100644 --- a/tests/test_sub_callbacks.py +++ b/tests/test_sub_callbacks.py @@ -1,7 +1,6 @@ from typing import Optional from fastapi import APIRouter, FastAPI -from fastapi.responses import JSONResponse from fastapi.testclient import TestClient from pydantic import BaseModel, HttpUrl @@ -24,14 +23,27 @@ class InvoiceEventReceived(BaseModel): ok: bool -invoices_callback_router = APIRouter(default_response_class=JSONResponse) +invoices_callback_router = APIRouter() @invoices_callback_router.post( "{$callback_url}/invoices/{$request.body.id}", response_model=InvoiceEventReceived, ) def invoice_notification(body: InvoiceEvent): - pass + pass # pragma: nocover + + +class Event(BaseModel): + name: str + total: float + + +events_callback_router = APIRouter() + + +@events_callback_router.get("{$callback_url}/events/{$request.body.title}") +def event_callback(event: Event): + pass # pragma: nocover subrouter = APIRouter() @@ -58,7 +70,7 @@ def create_invoice(invoice: Invoice, callback_url: Optional[HttpUrl] = None): return {"msg": "Invoice received"} -app.include_router(subrouter) +app.include_router(subrouter, callbacks=events_callback_router.routes) client = TestClient(app) @@ -110,6 +122,40 @@ openapi_schema = { }, }, "callbacks": { + "event_callback": { + "{$callback_url}/events/{$request.body.title}": { + "get": { + "summary": "Event Callback", + "operationId": "event_callback__callback_url__events___request_body_title__get", + "requestBody": { + "required": True, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Event" + } + } + }, + }, + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + } + }, "invoice_notification": { "{$callback_url}/invoices/{$request.body.id}": { "post": { @@ -149,13 +195,22 @@ openapi_schema = { }, } } - } + }, }, } } }, "components": { "schemas": { + "Event": { + "title": "Event", + "required": ["name", "total"], + "type": "object", + "properties": { + "name": {"title": "Name", "type": "string"}, + "total": {"title": "Total", "type": "number"}, + }, + }, "HTTPValidationError": { "title": "HTTPValidationError", "type": "object", @@ -225,8 +280,3 @@ def test_get(): ) assert response.status_code == 200, response.text assert response.json() == {"msg": "Invoice received"} - - -def test_dummy_callback(): - # Just for coverage - invoice_notification({}) diff --git a/tests/test_tutorial/test_bigger_applications/test_main.py b/tests/test_tutorial/test_bigger_applications/test_main.py index 5a5ad1b84..3670e25cf 100644 --- a/tests/test_tutorial/test_bigger_applications/test_main.py +++ b/tests/test_tutorial/test_bigger_applications/test_main.py @@ -11,32 +11,48 @@ openapi_schema = { "paths": { "/users/": { "get": { + "tags": ["users"], + "summary": "Read Users", + "operationId": "read_users_users__get", + "parameters": [ + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + } + ], "responses": { "200": { "description": "Successful Response", "content": {"application/json": {"schema": {}}}, - } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, }, - "tags": ["users"], - "summary": "Read Users", - "operationId": "read_users_users__get", } }, "/users/me": { "get": { - "responses": { - "200": { - "description": "Successful Response", - "content": {"application/json": {"schema": {}}}, - } - }, "tags": ["users"], "summary": "Read User Me", "operationId": "read_user_me_users_me_get", - } - }, - "/users/{username}": { - "get": { + "parameters": [ + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + } + ], "responses": { "200": { "description": "Successful Response", @@ -53,6 +69,10 @@ openapi_schema = { }, }, }, + } + }, + "/users/{username}": { + "get": { "tags": ["users"], "summary": "Read User", "operationId": "read_user_users__username__get", @@ -62,14 +82,15 @@ openapi_schema = { "schema": {"title": "Username", "type": "string"}, "name": "username", "in": "path", - } + }, + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + }, ], - } - }, - "/items/": { - "get": { "responses": { - "404": {"description": "Not found"}, "200": { "description": "Successful Response", "content": {"application/json": {"schema": {}}}, @@ -85,27 +106,33 @@ openapi_schema = { }, }, }, + } + }, + "/items/": { + "get": { "tags": ["items"], "summary": "Read Items", "operationId": "read_items_items__get", "parameters": [ + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + }, { "required": True, "schema": {"title": "X-Token", "type": "string"}, "name": "x-token", "in": "header", - } + }, ], - } - }, - "/items/{item_id}": { - "get": { "responses": { - "404": {"description": "Not found"}, "200": { "description": "Successful Response", "content": {"application/json": {"schema": {}}}, }, + "404": {"description": "Not found"}, "422": { "description": "Validation Error", "content": { @@ -117,6 +144,10 @@ openapi_schema = { }, }, }, + } + }, + "/items/{item_id}": { + "get": { "tags": ["items"], "summary": "Read Item", "operationId": "read_item_items__item_id__get", @@ -127,6 +158,12 @@ openapi_schema = { "name": "item_id", "in": "path", }, + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + }, { "required": True, "schema": {"title": "X-Token", "type": "string"}, @@ -134,15 +171,12 @@ openapi_schema = { "in": "header", }, ], - }, - "put": { "responses": { - "404": {"description": "Not found"}, - "403": {"description": "Operation forbidden"}, "200": { "description": "Successful Response", "content": {"application/json": {"schema": {}}}, }, + "404": {"description": "Not found"}, "422": { "description": "Validation Error", "content": { @@ -154,7 +188,9 @@ openapi_schema = { }, }, }, - "tags": ["custom", "items"], + }, + "put": { + "tags": ["items", "custom"], "summary": "Update Item", "operationId": "update_item_items__item_id__put", "parameters": [ @@ -164,6 +200,12 @@ openapi_schema = { "name": "item_id", "in": "path", }, + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + }, { "required": True, "schema": {"title": "X-Token", "type": "string"}, @@ -171,11 +213,108 @@ openapi_schema = { "in": "header", }, ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "404": {"description": "Not found"}, + "403": {"description": "Operation forbidden"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, }, }, + "/admin/": { + "post": { + "tags": ["admin"], + "summary": "Update Admin", + "operationId": "update_admin_admin__post", + "parameters": [ + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + }, + { + "required": True, + "schema": {"title": "X-Token", "type": "string"}, + "name": "x-token", + "in": "header", + }, + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "418": {"description": "I'm a teapot"}, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + }, + "/": { + "get": { + "summary": "Root", + "operationId": "root__get", + "parameters": [ + { + "required": True, + "schema": {"title": "Token", "type": "string"}, + "name": "token", + "in": "query", + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + }, }, "components": { "schemas": { + "HTTPValidationError": { + "title": "HTTPValidationError", + "type": "object", + "properties": { + "detail": { + "title": "Detail", + "type": "array", + "items": {"$ref": "#/components/schemas/ValidationError"}, + } + }, + }, "ValidationError": { "title": "ValidationError", "required": ["loc", "msg", "type"], @@ -190,49 +329,64 @@ openapi_schema = { "type": {"title": "Error Type", "type": "string"}, }, }, - "HTTPValidationError": { - "title": "HTTPValidationError", - "type": "object", - "properties": { - "detail": { - "title": "Detail", - "type": "array", - "items": {"$ref": "#/components/schemas/ValidationError"}, - } - }, - }, } }, } +no_jessica = { + "detail": [ + { + "loc": ["query", "token"], + "msg": "field required", + "type": "value_error.missing", + }, + ] +} + + @pytest.mark.parametrize( "path,expected_status,expected_response,headers", [ - ("/users", 200, [{"username": "Foo"}, {"username": "Bar"}], {}), - ("/users/foo", 200, {"username": "foo"}, {}), - ("/users/me", 200, {"username": "fakecurrentuser"}, {}), ( - "/items", + "/users?token=jessica", + 200, + [{"username": "Rick"}, {"username": "Morty"}], + {}, + ), + ("/users", 422, no_jessica, {}), + ("/users/foo?token=jessica", 200, {"username": "foo"}, {}), + ("/users/foo", 422, no_jessica, {}), + ("/users/me?token=jessica", 200, {"username": "fakecurrentuser"}, {}), + ("/users/me", 422, no_jessica, {}), + ( + "/items?token=jessica", 200, - [{"name": "Item Foo"}, {"name": "item Bar"}], + {"plumbus": {"name": "Plumbus"}, "gun": {"name": "Portal Gun"}}, {"X-Token": "fake-super-secret-token"}, ), + ("/items", 422, no_jessica, {"X-Token": "fake-super-secret-token"}), ( - "/items/bar", + "/items/plumbus?token=jessica", 200, - {"name": "Fake Specific Item", "item_id": "bar"}, + {"name": "Plumbus", "item_id": "plumbus"}, {"X-Token": "fake-super-secret-token"}, ), - ("/items", 400, {"detail": "X-Token header invalid"}, {"X-Token": "invalid"}), + ("/items/plumbus", 422, no_jessica, {"X-Token": "fake-super-secret-token"}), ( - "/items/bar", + "/items?token=jessica", 400, {"detail": "X-Token header invalid"}, {"X-Token": "invalid"}, ), ( - "/items", + "/items/bar?token=jessica", + 400, + {"detail": "X-Token header invalid"}, + {"X-Token": "invalid"}, + ), + ( + "/items?token=jessica", 422, { "detail": [ @@ -246,7 +400,7 @@ openapi_schema = { {}, ), ( - "/items/bar", + "/items/plumbus?token=jessica", 422, { "detail": [ @@ -259,6 +413,8 @@ openapi_schema = { }, {}, ), + ("/?token=jessica", 200, {"message": "Hello Bigger Applications!"}, {}), + ("/", 422, no_jessica, {}), ("/openapi.json", 200, openapi_schema, {}), ], ) @@ -273,11 +429,16 @@ def test_put_no_header(): assert response.status_code == 422, response.text assert response.json() == { "detail": [ + { + "loc": ["query", "token"], + "msg": "field required", + "type": "value_error.missing", + }, { "loc": ["header", "x-token"], "msg": "field required", "type": "value_error.missing", - } + }, ] } @@ -289,12 +450,30 @@ def test_put_invalid_header(): def test_put(): - response = client.put("/items/foo", headers={"X-Token": "fake-super-secret-token"}) + response = client.put( + "/items/plumbus?token=jessica", headers={"X-Token": "fake-super-secret-token"} + ) assert response.status_code == 200, response.text - assert response.json() == {"item_id": "foo", "name": "The Fighters"} + assert response.json() == {"item_id": "plumbus", "name": "The great Plumbus"} def test_put_forbidden(): - response = client.put("/items/bar", headers={"X-Token": "fake-super-secret-token"}) + response = client.put( + "/items/bar?token=jessica", headers={"X-Token": "fake-super-secret-token"} + ) assert response.status_code == 403, response.text - assert response.json() == {"detail": "You can only update the item: foo"} + assert response.json() == {"detail": "You can only update the item: plumbus"} + + +def test_admin(): + response = client.post( + "/admin/?token=jessica", headers={"X-Token": "fake-super-secret-token"} + ) + assert response.status_code == 200, response.text + assert response.json() == {"message": "Admin getting schwifty"} + + +def test_admin_invalid_header(): + response = client.post("/admin/", headers={"X-Token": "invalid"}) + assert response.status_code == 400, response.text + assert response.json() == {"detail": "X-Token header invalid"} diff --git a/tests/test_tutorial/test_dependencies/test_tutorial012.py b/tests/test_tutorial/test_dependencies/test_tutorial012.py new file mode 100644 index 000000000..ada83c626 --- /dev/null +++ b/tests/test_tutorial/test_dependencies/test_tutorial012.py @@ -0,0 +1,209 @@ +from fastapi.testclient import TestClient + +from docs_src.dependencies.tutorial012 import app + +client = TestClient(app) + +openapi_schema = { + "openapi": "3.0.2", + "info": {"title": "FastAPI", "version": "0.1.0"}, + "paths": { + "/items/": { + "get": { + "summary": "Read Items", + "operationId": "read_items_items__get", + "parameters": [ + { + "required": True, + "schema": {"title": "X-Token", "type": "string"}, + "name": "x-token", + "in": "header", + }, + { + "required": True, + "schema": {"title": "X-Key", "type": "string"}, + "name": "x-key", + "in": "header", + }, + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + }, + "/users/": { + "get": { + "summary": "Read Users", + "operationId": "read_users_users__get", + "parameters": [ + { + "required": True, + "schema": {"title": "X-Token", "type": "string"}, + "name": "x-token", + "in": "header", + }, + { + "required": True, + "schema": {"title": "X-Key", "type": "string"}, + "name": "x-key", + "in": "header", + }, + ], + "responses": { + "200": { + "description": "Successful Response", + "content": {"application/json": {"schema": {}}}, + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + }, + }, + }, + } + }, + }, + "components": { + "schemas": { + "HTTPValidationError": { + "title": "HTTPValidationError", + "type": "object", + "properties": { + "detail": { + "title": "Detail", + "type": "array", + "items": {"$ref": "#/components/schemas/ValidationError"}, + } + }, + }, + "ValidationError": { + "title": "ValidationError", + "required": ["loc", "msg", "type"], + "type": "object", + "properties": { + "loc": { + "title": "Location", + "type": "array", + "items": {"type": "string"}, + }, + "msg": {"title": "Message", "type": "string"}, + "type": {"title": "Error Type", "type": "string"}, + }, + }, + } + }, +} + + +def test_openapi_schema(): + response = client.get("/openapi.json") + assert response.status_code == 200, response.text + assert response.json() == openapi_schema + + +def test_get_no_headers_items(): + response = client.get("/items/") + assert response.status_code == 422, response.text + assert response.json() == { + "detail": [ + { + "loc": ["header", "x-token"], + "msg": "field required", + "type": "value_error.missing", + }, + { + "loc": ["header", "x-key"], + "msg": "field required", + "type": "value_error.missing", + }, + ] + } + + +def test_get_no_headers_users(): + response = client.get("/users/") + assert response.status_code == 422, response.text + assert response.json() == { + "detail": [ + { + "loc": ["header", "x-token"], + "msg": "field required", + "type": "value_error.missing", + }, + { + "loc": ["header", "x-key"], + "msg": "field required", + "type": "value_error.missing", + }, + ] + } + + +def test_get_invalid_one_header_items(): + response = client.get("/items/", headers={"X-Token": "invalid"}) + assert response.status_code == 400, response.text + assert response.json() == {"detail": "X-Token header invalid"} + + +def test_get_invalid_one_users(): + response = client.get("/users/", headers={"X-Token": "invalid"}) + assert response.status_code == 400, response.text + assert response.json() == {"detail": "X-Token header invalid"} + + +def test_get_invalid_second_header_items(): + response = client.get( + "/items/", headers={"X-Token": "fake-super-secret-token", "X-Key": "invalid"} + ) + assert response.status_code == 400, response.text + assert response.json() == {"detail": "X-Key header invalid"} + + +def test_get_invalid_second_header_users(): + response = client.get( + "/users/", headers={"X-Token": "fake-super-secret-token", "X-Key": "invalid"} + ) + assert response.status_code == 400, response.text + assert response.json() == {"detail": "X-Key header invalid"} + + +def test_get_valid_headers_items(): + response = client.get( + "/items/", + headers={ + "X-Token": "fake-super-secret-token", + "X-Key": "fake-super-secret-key", + }, + ) + assert response.status_code == 200, response.text + assert response.json() == [{"item": "Portal Gun"}, {"item": "Plumbus"}] + + +def test_get_valid_headers_users(): + response = client.get( + "/users/", + headers={ + "X-Token": "fake-super-secret-token", + "X-Key": "fake-super-secret-key", + }, + ) + assert response.status_code == 200, response.text + assert response.json() == [{"username": "Rick"}, {"username": "Morty"}]