Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mvrilo/go-redoc
go-redoc is an embedded OpenAPI/Swagger documentation ui for Go using ReDoc
https://github.com/mvrilo/go-redoc
documentation echo fiber gin go golang http openapi redoc swagger
Last synced: 24 days ago
JSON representation
go-redoc is an embedded OpenAPI/Swagger documentation ui for Go using ReDoc
- Host: GitHub
- URL: https://github.com/mvrilo/go-redoc
- Owner: mvrilo
- License: mit
- Created: 2021-02-07T20:10:45.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-20T09:54:23.000Z (about 1 month ago)
- Last Synced: 2024-04-20T10:37:12.443Z (about 1 month ago)
- Topics: documentation, echo, fiber, gin, go, golang, http, openapi, redoc, swagger
- Language: Go
- Homepage:
- Size: 941 KB
- Stars: 60
- Watchers: 4
- Forks: 27
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-go - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
- awesome-go-cn - go-redoc - redoc) (第三方api / 实用程序/Miscellaneous)
- awesome-go-stars - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
- awesome-go-cn - go-redoc - redoc) (第三方api / 实用程序/Miscellaneous)
- awesome-go - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
- awesome-go-with-stars - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
- awesome-go - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
- awesome-go - go-redoc - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). (Third-party APIs / Utility/Miscellaneous)
README
# go-redoc
[](https://godoc.org/github.com/mvrilo/go-redoc)
[](https://goreportcard.com/report/github.com/mvrilo/go-redoc?_=1)
`go-redoc` is an embedded OpenAPI documentation ui for Go using [ReDoc](https://github.com/ReDocly/redoc) and Go's [1.16+'s embed package](https://golang.org/pkg/embed/), with middleware implementations for: `net/http`, `gin`, `fiber`, and `echo`.
The template is based on the ReDoc's [bundle template](https://github.com/ReDocly/redoc/blob/master/cli/template.hbs) with the script already placed in the html instead of depending on a CDN.
This package does not generate openapi spec file. Check [this example](_examples/gen) for using code generation with swag.
## Usage
```go
import "github.com/mvrilo/go-redoc"
...
doc := redoc.Redoc{
Title: "Example API",
Description: "Example API Description",
SpecFile: "./openapi.json", // "./openapi.yaml"
SpecPath: "/openapi.json", // "/openapi.yaml"
DocsPath: "/docs",
}
```
- `net/http`
```go
import (
"net/http"
"github.com/mvrilo/go-redoc"
)
...
http.ListenAndServe(address, doc.Handler())
```
- `gin`
```go
import (
"github.com/gin-gonic/gin"
"github.com/mvrilo/go-redoc"
ginredoc "github.com/mvrilo/go-redoc/gin"
)
...
r := gin.New()
r.Use(ginredoc.New(doc))
```
- `echo`
```go
import (
"github.com/labstack/echo/v4"
"github.com/mvrilo/go-redoc"
echoredoc "github.com/mvrilo/go-redoc/echo"
)
...
r := echo.New()
r.Use(echoredoc.New(doc))
```
- `fiber`
```go
import (
"github.com/gofiber/fiber/v2"
"github.com/mvrilo/go-redoc"
fiberredoc "github.com/mvrilo/go-redoc/fiber"
)
...
r := fiber.New()
r.Use(fiberredoc.New(doc))
```
See [examples](/_examples)