Command line tool parses go files with swagger annotations and creates markdown file with API specs.
Usage of swamd:
-o, --o string Output file to write API specifications to. (default "api_spec.md")
-p, --p string Target path to parse Go files from. (default ".")
From
// CreateCourse creates course
//
// @Summary Creates course
// @Description create course
// @Tags courses
// @Accept json
// @Produce plain/text
// @Param request body CourseCreateRequest true "course create params"
// @Success 200 {string} string "Course unique identifier"
// @Router /courses [post]
To
[POST] | /courses |
---|---|
summary | Creates course |
description | create course |
Tags | courses |
Accept | json |
Produce | plain/text |
Params | request body {CourseCreateRequest} required โ "course create params" |
Responses | 200 {string} string "Course unique identifier" |