Skip to content

Expose OpenAPI version selector in Swagger UI #83

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
eviltester merged 1 commit into from
Jul 26, 2026
Merged

Expose OpenAPI version selector in Swagger UI #83

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion ...n/java/uk/co/compendiumdev/thingifier/adapter/httpserver/ThingifierAutoDocGenRouting.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,6 @@ public ThingifierAutoDocGenRouting(
openApi31Path,
openApi32Path,
docsPath,
swaggerDownloadPath,
swaggerUiPath)
.html();
});
Expand Down
12 changes: 4 additions & 8 deletions thingifier/src/main/java/uk/co/compendiumdev/thingifier/swaggerizer/SwaggerUiPage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@ public final class SwaggerUiPage {
private final String openApi31Url;
private final String openApi32Url;
private final String docsUrl;
private final String downloadUrl;
private final String canonicalUrl;

public SwaggerUiPage(
Expand All @@ -32,7 +31,6 @@ public SwaggerUiPage(
final String openApi31Url,
final String openApi32Url,
final String docsUrl,
final String downloadUrl,
final String canonicalUrl) {
this.apiDefn = apiDefn;
this.guiManagement = guiManagement;
Expand All @@ -41,7 +39,6 @@ public SwaggerUiPage(
this.openApi31Url = openApi31Url;
this.openApi32Url = openApi32Url;
this.docsUrl = docsUrl;
this.downloadUrl = downloadUrl;
this.canonicalUrl = canonicalUrl;
}

Expand All @@ -57,10 +54,6 @@ public String html() {
html.append("<p>");
html.append("<a href='").append(escapeHtmlAttribute(docsUrl)).append("'>API Docs</a>");
html.append(" | ");
html.append("<a href='")
.append(escapeHtmlAttribute(downloadUrl))
.append("'>Download OpenAPI JSON</a>");
html.append(" | ");
html.append("<a href='")
.append(escapeHtmlAttribute(openApi31Url))
.append("'>OpenAPI 3.1 JSON</a>");
Expand Down Expand Up @@ -146,7 +139,10 @@ private String lightThemeCss() {
".swagger-ui-page h1{margin-bottom:.25em;}",
".swagger-ui-page #swagger-ui{margin-top:1em;}",
".swagger-ui{background:#fff;color:#222;color-scheme:light;}",
".swagger-ui .topbar{display:none;}",
".swagger-ui .topbar{background:#f7f7f7!important;border:1px solid #d7d7d7;"
+ "border-radius:4px;margin:1em 0;padding:8px 0;}",
".swagger-ui .topbar-wrapper{align-items:center;}",
".swagger-ui .topbar a span{color:#222!important;}",
".swagger-ui .wrapper,.swagger-ui .scheme-container,"
+ ".swagger-ui section.models,.swagger-ui .model-box,"
+ ".swagger-ui .opblock,.swagger-ui .opblock .opblock-summary,"
Expand Down
3 changes: 2 additions & 1 deletion thingifier/src/test/java/uk/co/compendiumdev/thingifier/swaggerizer/SwaggerUiPageTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@ void includesCopyForAiAssetsAndOpenApiConfiguration() {
"/mirror/docs/openapi-3.1.json",
"/mirror/docs/openapi-3.2.json",
"/mirror/docs",
"/mirror/docs/swagger",
"/mirror/docs/swagger-ui")
.html();

Expand All @@ -33,5 +32,7 @@ void includesCopyForAiAssetsAndOpenApiConfiguration() {
Assertions.assertTrue(html.contains("/mirror/docs/openapi-3.1.json"));
Assertions.assertTrue(html.contains("/mirror/docs/openapi-3.2.json"));
Assertions.assertTrue(html.contains("\"urls.primaryName\": \"OpenAPI 3.1 default\""));
Assertions.assertFalse(html.contains("Download OpenAPI JSON"));
Assertions.assertFalse(html.contains(".swagger-ui .topbar{display:none;}"));
}
}
Loading