swgui

README

Swagger UI

Package swgui (Swagger UI) provides HTTP handler to serve Swagger UI. All assets are embedded in Go source code, so just build and run.

V3

Static assets for v3 are built from Swagger UI v3.52.5.

CDN-based v3cdn uses Swagger UI v3.52.4.

V4

Static assets for v4 are built from Swagger UI v4.18.1.

CDN-based v4cdn uses Swagger UI v4.18.1.

V5

Static assets for v5 are built from Swagger UI v5.0.0-alpha.0.

CDN-based v4cdn uses Swagger UI v5.0.0-alpha.0.

How to use

package main

import (
	"net/http"

	"github.com/swaggest/swgui/v3emb" // For go1.16 or later.
	// "github.com/swaggest/swgui/v3" // For go1.15 and below.
)

func main() {
	http.Handle("/", v3.NewHandler("My API", "/swagger.json", "/"))
	http.ListenAndServe(":8080", nil)
}

If you use go1.16 or later, you can import natively embedded assets with "github.com/swaggest/swgui/v3emb", it may help to lower application memory usage.

Use CDN for assets

In order to reduce binary size you can import github.com/swaggest/swgui/v3cdn to use CDN hosted assets.

Also you can use swguicdn build tag to enable CDN mode for github.com/swaggest/swgui/v3 import.

Be aware that CDN mode may be considered inappropriate for security or networking reasons.

Run as standalone server

Install swgui-server

go get github.com/swaggest/swgui/...

Start server

swgui-server -port 8080

Documentation

Overview

Package swgui provide a http FileSystem handler for swagger UI interface

How to generate asset files:

1. Install tools:

go get -u github.com/shurcooL/vfsgen

2. Generate file:

At root folder, run command:

go generate

Index

• type Config

Types

type Config

type Config struct {
	Title       string `json:"title"`          // Title of index file.
	SwaggerJSON string `json:"swaggerJsonUrl"` // URL to openapi.json/swagger.json document specification.
	BasePath    string `json:"basePath"`       // Base URL to docs.

	ShowTopBar         bool              `json:"showTopBar"`         // Show navigation top bar, hidden by default.
	HideCurl           bool              `json:"hideCurl"`           // Hide curl code snippet.
	JsonEditor         bool              `json:"jsonEditor"`         // Enable visual json editor support (experimental, can fail with complex schemas).
	PreAuthorizeApiKey map[string]string `json:"preAuthorizeApiKey"` // Map of security name to key value.

	// SettingsUI contains keys and plain javascript values of SwaggerUIBundle configuration.
	// Overrides default values.
	// See https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/ for available options.
	SettingsUI map[string]string `json:"-"`
}

Config is used for Swagger UI handler configuration.