go-redoc - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #llm #android #machine-learning #rust #nodejs #vue #awesome-list #mcp #openai #open-source

go-redoc

(★ 95)

go-redoc is an embedded OpenAPI/Swagger documentation ui for Go using ReDoc

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yaml
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- - go.mod
  - go.sum
  - main.go
  - Makefile
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- - go.mod
  - go.sum
  - main.go
  - openapi.json
- index.html
- redoc.standalone.js
- echo.go
- go.mod
- go.sum
- fiber.go
- go.mod
- go.sum
- gin.go
- go.mod
- go.sum
- go.mod
- go.sum
- iris.go
- spec.json
.gitignore
go.mod
go.sum
LICENSE
Makefile
README.md
redoc.go
redoc_test.go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# go-redoc

[![GoDoc](https://godoc.org/github.com/mvrilo/go-redoc?status.svg)](https://godoc.org/github.com/mvrilo/go-redoc)
[![Go Report Card](https://goreportcard.com/badge/github.com/mvrilo/go-redoc?_=1)](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`, `echo`, and `iris`.

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))
```

- `iris`

```go
import (
	"github.com/kataras/iris/v12"
	"github.com/mvrilo/go-redoc"
	irisdoc "github.com/mvrilo/go-redoc/iris"
)

...

app := iris.New()
app.Use(irisdoc.New(doc))
```

See [examples](/_examples)