go-swagger toolkit

Swagger 2.0 describes your API's for you, so you don't have to

swagger.json generation

 

The toolkit has a command that will let you generate a swagger spec document from your code. The command integrates with go doc comments, and makes use of structs when it needs to know of types.

9 Nov 2015

Generate an API client

 

The toolkit has a command that will let you generate a client.

23 Oct 2015

Generate a server for a swagger spec

 

The toolkit has a command that will let you generate a docker friendly server with support for TLS. You can configure it through environment variables that are commonly used on PaaS services.

22 Nov 2015

Validate a swagger spec

 

The toolkit has a command to validate swagger specifications for you. It includes a full json-schema validator and adds a bunch of extra validations on top of that to ensure the spec is as valid as possible, so that there are no surprises.

22 Oct 2015

Untyped API server

 

The toolkit supports serving a swagger spec with untyped data. This means that it uses mostly interface{} as params to each operation and as result type. It does allow you to serve a spec up quickly. This is one of the building blocks required to serve up stub API’s and to generate a test server with predictable responses.

22 Nov 2015

What is go-swagger

 

There are 3 axis along which your API and its documentation tend to evolve. This toolkit aims to support you along all 3 axis and remove the repetitive nature of writing what is essentially boilerplate code for faster iteration times.

21 Oct 2015