https://github.com/nerzal/atreugo-swagger

swagger handler for atreugo
https://github.com/nerzal/atreugo-swagger

api-documentation atreugo documentation swag swagger swaggo

Last synced: 10 months ago
JSON representation

swagger handler for atreugo

• Host: GitHub
• URL: https://github.com/nerzal/atreugo-swagger
• Owner: Nerzal
• License: apache-2.0
• Created: 2020-02-23T17:51:46.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-08-25T16:35:43.000Z (almost 3 years ago)
• Last Synced: 2025-04-03T03:32:53.516Z (about 1 year ago)
• Topics: api-documentation, atreugo, documentation, swag, swagger, swaggo
• Language: Go
• Homepage:
• Size: 13.6 MB
• Stars: 7
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# atreugo-swagger

[![codebeat badge](https://codebeat.co/badges/103ada91-026a-4027-b450-1a0ccbf8ce9a)](https://codebeat.co/projects/github-com-nerzal-atreugo-swagger-master)

[![Go Report Card](https://goreportcard.com/badge/github.com/Nerzal/atreugo-swagger)](https://goreportcard.com/report/github.com/Nerzal/atreugo-swagger)

[![Go Doc](https://godoc.org/github.com/Nerzal/atreugo-swagger?status.svg)](https://godoc.org/github.com/Nerzal/atreugo-swagger)

[![Build Status](https://github.com/Nerzal/atreugo-swagger/workflows/Tests/badge.svg)](https://github.com/Nerzal/atreugo-swagger/actions?query=branch%3Amaster+event%3Apush)

[![GitHub release](https://img.shields.io/github/tag/Nerzal/atreugo-swagger.svg)](https://GitHub.com/Nerzal/atreugo-swagger/releases/)

[![codecov](https://codecov.io/gh/Nerzal/atreugo-swagger/branch/master/graph/badge.svg)](https://codecov.io/gh/Nerzal/atreugo-swagger)

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FNerzal%2Fatreugo-swagger.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2FNerzal%2Fatreugo-swagger?ref=badge_shield)

atreugo handler that serves swagger files. 

Works with [swaggo](https://github.com/swaggo/swag)

swagger files are from: [swaggofiles](https://github.com/swaggo/files)

## atreugo v11 support

Use atreugo-swagger v2.0.1 and above for atreugo v11 support

## Paths

Serves swagger documentation under index.html

Serves redoc documentation under redoc.html

## Example

```go

package main

import (

	atreugoswagger "github.com/Nerzal/atreugo-swagger/v3"

	_ "github.com/Nerzal/atreugo-swagger/example/docs" // docs is generated by Swag CLI, you have to import it.

	"github.com/savsgio/atreugo/v11"

)

// @title Swagger Example API

// @version 1.0

// @description This is a sample server Petstore server.

// @termsOfService http://swagger.io/terms/

// @contact.name API Support

// @contact.url http://www.swagger.io/support

// @contact.email support@swagger.io

// @license.name Apache 2.0

// @license.url http://www.apache.org/licenses/LICENSE-2.0.html

// @host petstore.swagger.io

// @BasePath /v2

func main() {

	config := &atreugo.Config{

		Addr: "0.0.0.0:1337",

	}

	a := atreugo.New(config)

	// This will server all swagger files under the /docs/* path.

	a.GET("/docs/*doc", atreugoswagger.AtreugoWrapHandler(atreugoswagger.Title("Test Title")))

	// Start the server

	err := a.ListenAndServe()

	if err != nil {

		panic(err)

	}

}

```