fix: dump spec as a JSON (#467)

kemingy · web-flow · commit 8bf17159ff8f · 2025-12-15T17:36:20.000Z
Signed-off-by: Keming &lt;kemingy94@gmail.com&gt;
diff --git a/spectree/config.py b/spectree/config.py
@@ -154,6 +154,7 @@ def openapi_info(self) -> Dict[str, str]:
                 "license",
             },
             exclude_none=True,
+            mode="json",
         )
         if info.get("terms_of_service") is not None:
             info["termsOfService"] = info.pop("terms_of_service")
diff --git a/spectree/page.py b/spectree/page.py
@@ -23,7 +23,7 @@
     </head>
     <body>
         <redoc spec-url='{spec_url}'></redoc>
-        <script type="module" src="https://cdn.redoc.ly/redoc/v2.5.1/bundles/redoc.standalone.js"> </script>
+        <script src="https://unpkg.com/redoc@v2.5.1/bundles/redoc.standalone.js"> </script>
     </body>
 </html>""",
     # https://swagger.io
diff --git a/spectree/plugins/falcon_plugin.py b/spectree/plugins/falcon_plugin.py
@@ -14,7 +14,7 @@
 except ImportError:
     from io import BytesIO as CachedFile  # type: ignore[assignment]
 
-from falcon import MEDIA_JSON, http_status_to_code
+from falcon import MEDIA_HTML, MEDIA_JSON, http_status_to_code
 from falcon import Request as FalconRequest
 from falcon import Response as FalconResponse
 from falcon.asgi import Request as FalconASGIRequest
@@ -82,16 +82,17 @@ def __init__(self, spec: Mapping[str, str]):
         self.spec = spec
 
     def on_get(self, _: Any, resp: Any):
+        resp.content_type = MEDIA_JSON
         resp.media = self.spec
 
 
 class DocPage:
     def __init__(self, html: str, **kwargs: Any):
-        self.page = html.format(**kwargs)
+        self.page = html.format(**kwargs).encode("utf-8")
 
     def on_get(self, _: Any, resp: Any):
-        resp.content_type = "text/html"
-        resp.text = self.page
+        resp.content_type = MEDIA_HTML
+        resp.data = self.page
 
 
 class OpenAPIAsgi(OpenAPI):
diff --git a/uv.lock b/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -154,6 +154,7 @@ def openapi_info(self) -> Dict[str, str]:`
`154`	`154`	`"license",`
`155`	`155`	`},`
`156`	`156`	`exclude_none=True,`
	`157`	`+ mode="json",`
`157`	`158`	`)`
`158`	`159`	`if info.get("terms_of_service") is not None:`
`159`	`160`	`info["termsOfService"] = info.pop("terms_of_service")`