Skip to content

Command line tool to publish OpenApi specs to SwaggerHub

License

Notifications You must be signed in to change notification settings

mijailr/swaggergo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Swagger GO

This tiny commandline tool allows you to publish to SwaggerHub using environment variables or parameters with the SwaggerHub credentials and API path.

The purpose of this application is to simplify the process of publishing new definitions from deploy pipelines like Buldkite, CircleCI, Github Actions, Jenkins, etc.

How to use

From your pipeline you just need to have the latest release on the $PATH of the runner or agent.

You can download the precompiled version:

wget https://github.com/mijailr/swaggergo/releases/latest/download/swaggergo

Simple usage:

swaggergo path/to/openapi.yml --type yml --oas 3.0.0 --api mijailr/sample-api --access-token [...]

With environment variables:

export SWAGGERHUB_ACCESS_TOKEN="..."
export SWAGGERHUB_API="..."
swaggergo --file path/to/openapi.yml --type yml

Thanks to

This tiny command line tool is inspired on github-release from Buildkite.