From 6f45f437099c743f5adb8fd7268fe41a768a7a6d Mon Sep 17 00:00:00 2001 From: dkreeft <37153972+dkreeft@users.noreply.github.com> Date: Thu, 29 Jul 2021 15:10:22 +0000 Subject: [PATCH] =?utf8?q?=E2=9C=A8=20Add=20additonal=20OpenAPI=20metadata?= =?utf8?q?=20parameters=20to=20`FastAPI`=20class,=20shown=20on=20the=20aut?= =?utf8?q?omatic=20API=20docs=20UI=20(#1812)?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Co-authored-by: Marcelo Trylesinski Co-authored-by: dkreeft Co-authored-by: Sebastián Ramírez --- .../en/docs/img/tutorial/metadata/image01.png | Bin 38068 -> 90062 bytes docs/en/docs/tutorial/metadata.md | 23 +++++++----- docs_src/metadata/tutorial001.py | 33 +++++++++++++++--- fastapi/applications.py | 9 +++++ fastapi/openapi/utils.py | 11 +++++- .../test_metadata/test_tutorial001.py | 22 ++++++++---- 6 files changed, 79 insertions(+), 19 deletions(-) diff --git a/docs/en/docs/img/tutorial/metadata/image01.png b/docs/en/docs/img/tutorial/metadata/image01.png index e9800d532f072ddda5e99a23e5449dd1cabd5e68..b7708a3fd98ad2170d880781896623ec8ed80204 100644 GIT binary patch literal 90062 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⪙6ziEE``II;Ag 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%0D%?G&;zjG?$)Oy7+?(B7EazRq-tDMR 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 (bbb>7 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 diff --git a/docs/en/docs/tutorial/metadata.md b/docs/en/docs/tutorial/metadata.md index 7ec3054218..78f17031a1 100644 --- a/docs/en/docs/tutorial/metadata.md +++ b/docs/en/docs/tutorial/metadata.md @@ -2,21 +2,28 @@ You can customize several metadata configurations in your **FastAPI** application. -## Title, description, and version +## Metadata for API -You can set the: +You can set the following fields that are used in the OpenAPI specification and the automatic API docs UIs: -* **Title**: used as your API's title/name, in OpenAPI and the automatic API docs UIs. -* **Description**: the description of your API, in OpenAPI and the automatic API docs UIs. -* **Version**: the version of your API, e.g. `v2` or `2.5.0`. - * Useful for example if you had a previous version of the application, also using OpenAPI. +| Parameter | Type | Description | +|------------|------|-------------| +| `title` | `str` | The title of the API. | +| `description` | `str` | A short description of the API. It can use Markdown. | +| `version` | `string` | The version of the API. This is the version of your own application, not of OpenAPI. For example `2.5.0`. | +| `terms_of_service` | `str` | A URL to the Terms of Service for the API. If provided, this has to be a URL. | +| `contact` | `dict` | The contact information for the exposed API. It can contain several fields.

contact fields
ParameterTypeDescription
namestrThe identifying name of the contact person/organization.
urlstrThe URL pointing to the contact information. MUST be in the format of a URL.
emailstrThe email address of the contact person/organization. MUST be in the format of an email address.
| +| `license_info` | `dict` | The license information for the exposed API. It can contain several fields.
license_info fields
ParameterTypeDescription
namestrREQUIRED (if a license_info is set). The license name used for the API.
urlstrA URL to the license used for the API. MUST be in the format of a URL.
| -To set them, use the parameters `title`, `description`, and `version`: +You can set them as follows: -```Python hl_lines="4-6" +```Python hl_lines="3-16 19-31" {!../../../docs_src/metadata/tutorial001.py!} ``` +!!! tip + You can write Markdown in the `description` field and it will be rendered in the output. + With this configuration, the automatic API docs would look like: diff --git a/docs_src/metadata/tutorial001.py b/docs_src/metadata/tutorial001.py index 16bab8a0c0..3fba9e7d1b 100644 --- a/docs_src/metadata/tutorial001.py +++ b/docs_src/metadata/tutorial001.py @@ -1,12 +1,37 @@ from fastapi import FastAPI +description = """ +ChimichangApp API helps you do awesome stuff. 🚀 + +## Items + +You can **read items**. + +## Users + +You will be able to: + +* **Create users** (_not implemented_). +* **Read users** (_not implemented_). +""" + app = FastAPI( - title="My Super Project", - description="This is a very fancy project, with auto docs for the API and everything", - version="2.5.0", + title="ChimichangApp", + description=description, + version="0.0.1", + terms_of_service="http://example.com/terms/", + contact={ + "name": "Deadpoolio the Amazing", + "url": "http://x-force.example.com/contact/", + "email": "dp@x-force.example.com", + }, + license_info={ + "name": "Apache 2.0", + "url": "https://www.apache.org/licenses/LICENSE-2.0.html", + }, ) @app.get("/items/") async def read_items(): - return [{"name": "Foo"}] + return [{"name": "Katana"}] diff --git a/fastapi/applications.py b/fastapi/applications.py index 3f78238d60..b013e7b46a 100644 --- a/fastapi/applications.py +++ b/fastapi/applications.py @@ -55,6 +55,9 @@ class FastAPI(Starlette): ] = None, on_startup: Optional[Sequence[Callable[[], Any]]] = None, on_shutdown: Optional[Sequence[Callable[[], Any]]] = None, + terms_of_service: Optional[str] = None, + contact: Optional[Dict[str, Union[str, Any]]] = None, + license_info: Optional[Dict[str, Union[str, Any]]] = None, openapi_prefix: str = "", root_path: str = "", root_path_in_servers: bool = True, @@ -97,6 +100,9 @@ class FastAPI(Starlette): self.title = title self.description = description self.version = version + self.terms_of_service = terms_of_service + self.contact = contact + self.license_info = license_info self.servers = servers or [] self.openapi_url = openapi_url self.openapi_tags = openapi_tags @@ -132,6 +138,9 @@ class FastAPI(Starlette): version=self.version, openapi_version=self.openapi_version, description=self.description, + terms_of_service=self.terms_of_service, + contact=self.contact, + license_info=self.license_info, routes=self.routes, tags=self.openapi_tags, servers=self.servers, diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py index 8dbe3902b1..604ba5b006 100644 --- a/fastapi/openapi/utils.py +++ b/fastapi/openapi/utils.py @@ -362,10 +362,19 @@ def get_openapi( routes: Sequence[BaseRoute], tags: Optional[List[Dict[str, Any]]] = None, servers: Optional[List[Dict[str, Union[str, Any]]]] = None, + terms_of_service: Optional[str] = None, + contact: Optional[Dict[str, Union[str, Any]]] = None, + license_info: Optional[Dict[str, Union[str, Any]]] = None, ) -> Dict[str, Any]: - info = {"title": title, "version": version} + info: Dict[str, Any] = {"title": title, "version": version} if description: info["description"] = description + if terms_of_service: + info["termsOfService"] = terms_of_service + if contact: + info["contact"] = contact + if license_info: + info["license"] = license_info output: Dict[str, Any] = {"openapi": openapi_version, "info": info} if servers: output["servers"] = servers diff --git a/tests/test_tutorial/test_metadata/test_tutorial001.py b/tests/test_tutorial/test_metadata/test_tutorial001.py index aae79dcc4c..b7281e2935 100644 --- a/tests/test_tutorial/test_metadata/test_tutorial001.py +++ b/tests/test_tutorial/test_metadata/test_tutorial001.py @@ -7,21 +7,31 @@ client = TestClient(app) openapi_schema = { "openapi": "3.0.2", "info": { - "title": "My Super Project", - "version": "2.5.0", - "description": "This is a very fancy project, with auto docs for the API and everything", + "title": "ChimichangApp", + "description": "\nChimichangApp API helps you do awesome stuff. 🚀\n\n## Items\n\nYou can **read items**.\n\n## Users\n\nYou will be able to:\n\n* **Create users** (_not implemented_).\n* **Read users** (_not implemented_).\n", + "termsOfService": "http://example.com/terms/", + "contact": { + "name": "Deadpoolio the Amazing", + "url": "http://x-force.example.com/contact/", + "email": "dp@x-force.example.com", + }, + "license": { + "name": "Apache 2.0", + "url": "https://www.apache.org/licenses/LICENSE-2.0.html", + }, + "version": "0.0.1", }, "paths": { "/items/": { "get": { + "summary": "Read Items", + "operationId": "read_items_items__get", "responses": { "200": { "description": "Successful Response", "content": {"application/json": {"schema": {}}}, } }, - "summary": "Read Items", - "operationId": "read_items_items__get", } } }, @@ -37,4 +47,4 @@ def test_openapi_schema(): def test_items(): response = client.get("/items/") assert response.status_code == 200, response.text - assert response.json() == [{"name": "Foo"}] + assert response.json() == [{"name": "Katana"}] -- 2.47.3