From a85aa125d24acb225b7b722bb4f3e331a21ec267 Mon Sep 17 00:00:00 2001
From: John Riebold <jmriebold@gmail.com>
Date: Sun, 16 Jan 2022 11:26:24 -0800
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Enable=20configuring=20Swagger=20UI?=
 =?UTF-8?q?=20parameters=20(#2568)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Artem Ivanov <artem@worklife.io>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/en/docs/advanced/extending-openapi.md    |  79 ++++++++++++++++++
 .../tutorial/extending-openapi/image02.png    | Bin 0 -> 11292 bytes
 .../tutorial/extending-openapi/image03.png    | Bin 0 -> 11176 bytes
 .../tutorial/extending-openapi/image04.png    | Bin 0 -> 11180 bytes
 docs_src/extending_openapi/tutorial003.py     |   8 ++
 docs_src/extending_openapi/tutorial004.py     |   8 ++
 docs_src/extending_openapi/tutorial005.py     |   8 ++
 fastapi/applications.py                       |   3 +
 fastapi/openapi/docs.py                       |  22 +++--
 .../test_tutorial003.py                       |  41 +++++++++
 .../test_tutorial004.py                       |  44 ++++++++++
 .../test_tutorial005.py                       |  44 ++++++++++
 12 files changed, 251 insertions(+), 6 deletions(-)
 create mode 100644 docs/en/docs/img/tutorial/extending-openapi/image02.png
 create mode 100644 docs/en/docs/img/tutorial/extending-openapi/image03.png
 create mode 100644 docs/en/docs/img/tutorial/extending-openapi/image04.png
 create mode 100644 docs_src/extending_openapi/tutorial003.py
 create mode 100644 docs_src/extending_openapi/tutorial004.py
 create mode 100644 docs_src/extending_openapi/tutorial005.py
 create mode 100644 tests/test_tutorial/test_extending_openapi/test_tutorial003.py
 create mode 100644 tests/test_tutorial/test_extending_openapi/test_tutorial004.py
 create mode 100644 tests/test_tutorial/test_extending_openapi/test_tutorial005.py

diff --git a/docs/en/docs/advanced/extending-openapi.md b/docs/en/docs/advanced/extending-openapi.md
index d8d280ba67276..d1b14bc003fde 100644
--- a/docs/en/docs/advanced/extending-openapi.md
+++ b/docs/en/docs/advanced/extending-openapi.md
@@ -233,3 +233,82 @@ Now, to be able to test that everything works, create a *path operation*:
 Now, you should be able to disconnect your WiFi, go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page.
 
 And even without Internet, you would be able to see the docs for your API and interact with it.
+
+## Configuring Swagger UI
+
+You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
+
+To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
+
+`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.
+
+FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.
+
+### Disable Syntax Highlighting
+
+For example, you could disable syntax highlighting in Swagger UI.
+
+Without changing the settings, syntax highlighting is enabled by default:
+
+<img src="/img/tutorial/extending-openapi/image02.png">
+
+But you can disable it by setting `syntaxHighlight` to `False`:
+
+```Python hl_lines="3"
+{!../../../docs_src/extending_openapi/tutorial003.py!}
+```
+
+...and then Swagger UI won't show the syntax highlighting anymore:
+
+<img src="/img/tutorial/extending-openapi/image03.png">
+
+### Change the Theme
+
+The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
+
+```Python hl_lines="3"
+{!../../../docs_src/extending_openapi/tutorial004.py!}
+```
+
+That configuration would change the syntax highlighting color theme:
+
+<img src="/img/tutorial/extending-openapi/image04.png">
+
+### Change Default Swagger UI Parameters
+
+FastAPI includes some default configuration parameters appropriate for most of the use cases.
+
+It includes these default configurations:
+
+```Python
+{!../../../fastapi/openapi/docs.py[ln:7-13]!}
+```
+
+You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
+
+For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
+
+```Python hl_lines="3"
+{!../../../docs_src/extending_openapi/tutorial005.py!}
+```
+
+### Other Swagger UI Parameters
+
+To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
+
+### JavaScript-only settings
+
+Swagger UI also allows other configurations to be **JavaScript-only** objects (for example, JavaScript functions).
+
+FastAPI also includes these JavaScript-only `presets` settings:
+
+```JavaScript
+presets: [
+    SwaggerUIBundle.presets.apis,
+    SwaggerUIBundle.SwaggerUIStandalonePreset
+]
+```
+
+These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.
+
+If you need to use JavaScript-only configurations like those, you can use one of the methods above. Override all the Swagger UI *path operation* and manually write any JavaScript you need.
diff --git a/docs/en/docs/img/tutorial/extending-openapi/image02.png b/docs/en/docs/img/tutorial/extending-openapi/image02.png
new file mode 100644
index 0000000000000000000000000000000000000000..91453fb56f687b99fc725afa0a7fa07eb1955137
GIT binary patch
literal 11292
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
CFY9su

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/extending-openapi/image03.png b/docs/en/docs/img/tutorial/extending-openapi/image03.png
new file mode 100644
index 0000000000000000000000000000000000000000..e45a77d5190713df21b288629791065c392bc098
GIT binary patch
literal 11176
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

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/extending-openapi/image04.png b/docs/en/docs/img/tutorial/extending-openapi/image04.png
new file mode 100644
index 0000000000000000000000000000000000000000..394d2bb431ab5eadaa919087ce1618f996bd829e
GIT binary patch
literal 11180
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
JQ+@j4e*yi6sxbfn

literal 0
HcmV?d00001

diff --git a/docs_src/extending_openapi/tutorial003.py b/docs_src/extending_openapi/tutorial003.py
new file mode 100644
index 0000000000000..6c24ce75838b1
--- /dev/null
+++ b/docs_src/extending_openapi/tutorial003.py
@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI(swagger_ui_parameters={"syntaxHighlight": False})
+
+
+@app.get("/users/{username}")
+async def read_user(username: str):
+    return {"message": f"Hello {username}"}
diff --git a/docs_src/extending_openapi/tutorial004.py b/docs_src/extending_openapi/tutorial004.py
new file mode 100644
index 0000000000000..cc569ce450617
--- /dev/null
+++ b/docs_src/extending_openapi/tutorial004.py
@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI(swagger_ui_parameters={"syntaxHighlight.theme": "obsidian"})
+
+
+@app.get("/users/{username}")
+async def read_user(username: str):
+    return {"message": f"Hello {username}"}
diff --git a/docs_src/extending_openapi/tutorial005.py b/docs_src/extending_openapi/tutorial005.py
new file mode 100644
index 0000000000000..b4449f5c6aea5
--- /dev/null
+++ b/docs_src/extending_openapi/tutorial005.py
@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI(swagger_ui_parameters={"deepLinking": False})
+
+
+@app.get("/users/{username}")
+async def read_user(username: str):
+    return {"message": f"Hello {username}"}
diff --git a/fastapi/applications.py b/fastapi/applications.py
index 0c25026e2bb1e..d71d4190abc10 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -65,6 +65,7 @@ def __init__(
         callbacks: Optional[List[BaseRoute]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
+        swagger_ui_parameters: Optional[Dict[str, Any]] = None,
         **extra: Any,
     ) -> None:
         self._debug: bool = debug
@@ -120,6 +121,7 @@ def __init__(
         self.redoc_url = redoc_url
         self.swagger_ui_oauth2_redirect_url = swagger_ui_oauth2_redirect_url
         self.swagger_ui_init_oauth = swagger_ui_init_oauth
+        self.swagger_ui_parameters = swagger_ui_parameters
         self.extra = extra
         self.dependency_overrides: Dict[Callable[..., Any], Callable[..., Any]] = {}
 
@@ -174,6 +176,7 @@ async def swagger_ui_html(req: Request) -> HTMLResponse:
                     title=self.title + " - Swagger UI",
                     oauth2_redirect_url=oauth2_redirect_url,
                     init_oauth=self.swagger_ui_init_oauth,
+                    swagger_ui_parameters=self.swagger_ui_parameters,
                 )
 
             self.add_route(self.docs_url, swagger_ui_html, include_in_schema=False)
diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py
index fd22e4e8c167d..1be90d188fade 100644
--- a/fastapi/openapi/docs.py
+++ b/fastapi/openapi/docs.py
@@ -4,6 +4,14 @@
 from fastapi.encoders import jsonable_encoder
 from starlette.responses import HTMLResponse
 
+swagger_ui_default_parameters = {
+    "dom_id": "#swagger-ui",
+    "layout": "BaseLayout",
+    "deepLinking": True,
+    "showExtensions": True,
+    "showCommonExtensions": True,
+}
+
 
 def get_swagger_ui_html(
     *,
@@ -14,7 +22,11 @@ def get_swagger_ui_html(
     swagger_favicon_url: str = "https://fastapi.tiangolo.com/img/favicon.png",
     oauth2_redirect_url: Optional[str] = None,
     init_oauth: Optional[Dict[str, Any]] = None,
+    swagger_ui_parameters: Optional[Dict[str, Any]] = None,
 ) -> HTMLResponse:
+    current_swagger_ui_parameters = swagger_ui_default_parameters.copy()
+    if swagger_ui_parameters:
+        current_swagger_ui_parameters.update(swagger_ui_parameters)
 
     html = f"""
     <!DOCTYPE html>
@@ -34,19 +46,17 @@ def get_swagger_ui_html(
         url: '{openapi_url}',
     """
 
+    for key, value in current_swagger_ui_parameters.items():
+        html += f"{json.dumps(key)}: {json.dumps(jsonable_encoder(value))},\n"
+
     if oauth2_redirect_url:
         html += f"oauth2RedirectUrl: window.location.origin + '{oauth2_redirect_url}',"
 
     html += """
-        dom_id: '#swagger-ui',
-        presets: [
+    presets: [
         SwaggerUIBundle.presets.apis,
         SwaggerUIBundle.SwaggerUIStandalonePreset
         ],
-        layout: "BaseLayout",
-        deepLinking: true,
-        showExtensions: true,
-        showCommonExtensions: true
     })"""
 
     if init_oauth:
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial003.py b/tests/test_tutorial/test_extending_openapi/test_tutorial003.py
new file mode 100644
index 0000000000000..0184dd9f8384b
--- /dev/null
+++ b/tests/test_tutorial/test_extending_openapi/test_tutorial003.py
@@ -0,0 +1,41 @@
+from fastapi.testclient import TestClient
+
+from docs_src.extending_openapi.tutorial003 import app
+
+client = TestClient(app)
+
+
+def test_swagger_ui():
+    response = client.get("/docs")
+    assert response.status_code == 200, response.text
+    assert (
+        '"syntaxHighlight": false' in response.text
+    ), "syntaxHighlight should be included and converted to JSON"
+    assert (
+        '"dom_id": "#swagger-ui"' in response.text
+    ), "default configs should be preserved"
+    assert "presets: [" in response.text, "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.presets.apis," in response.text
+    ), "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.SwaggerUIStandalonePreset" in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"layout": "BaseLayout",' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"deepLinking": true,' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showExtensions": true,' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showCommonExtensions": true,' in response.text
+    ), "default configs should be preserved"
+
+
+def test_get_users():
+    response = client.get("/users/foo")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"message": "Hello foo"}
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial004.py b/tests/test_tutorial/test_extending_openapi/test_tutorial004.py
new file mode 100644
index 0000000000000..4f7615126a0cd
--- /dev/null
+++ b/tests/test_tutorial/test_extending_openapi/test_tutorial004.py
@@ -0,0 +1,44 @@
+from fastapi.testclient import TestClient
+
+from docs_src.extending_openapi.tutorial004 import app
+
+client = TestClient(app)
+
+
+def test_swagger_ui():
+    response = client.get("/docs")
+    assert response.status_code == 200, response.text
+    assert (
+        '"syntaxHighlight": false' not in response.text
+    ), "not used parameters should not be included"
+    assert (
+        '"syntaxHighlight.theme": "obsidian"' in response.text
+    ), "parameters with middle dots should be included in a JSON compatible way"
+    assert (
+        '"dom_id": "#swagger-ui"' in response.text
+    ), "default configs should be preserved"
+    assert "presets: [" in response.text, "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.presets.apis," in response.text
+    ), "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.SwaggerUIStandalonePreset" in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"layout": "BaseLayout",' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"deepLinking": true,' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showExtensions": true,' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showCommonExtensions": true,' in response.text
+    ), "default configs should be preserved"
+
+
+def test_get_users():
+    response = client.get("/users/foo")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"message": "Hello foo"}
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial005.py b/tests/test_tutorial/test_extending_openapi/test_tutorial005.py
new file mode 100644
index 0000000000000..24aeb93db32ec
--- /dev/null
+++ b/tests/test_tutorial/test_extending_openapi/test_tutorial005.py
@@ -0,0 +1,44 @@
+from fastapi.testclient import TestClient
+
+from docs_src.extending_openapi.tutorial005 import app
+
+client = TestClient(app)
+
+
+def test_swagger_ui():
+    response = client.get("/docs")
+    assert response.status_code == 200, response.text
+    assert (
+        '"deepLinking": false,' in response.text
+    ), "overridden configs should be preserved"
+    assert (
+        '"deepLinking": true' not in response.text
+    ), "overridden configs should not include the old value"
+    assert (
+        '"syntaxHighlight": false' not in response.text
+    ), "not used parameters should not be included"
+    assert (
+        '"dom_id": "#swagger-ui"' in response.text
+    ), "default configs should be preserved"
+    assert "presets: [" in response.text, "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.presets.apis," in response.text
+    ), "default configs should be preserved"
+    assert (
+        "SwaggerUIBundle.SwaggerUIStandalonePreset" in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"layout": "BaseLayout",' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showExtensions": true,' in response.text
+    ), "default configs should be preserved"
+    assert (
+        '"showCommonExtensions": true,' in response.text
+    ), "default configs should be preserved"
+
+
+def test_get_users():
+    response = client.get("/users/foo")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"message": "Hello foo"}