{"repo":"parvez3019/go-swagger3","free":true,"listed":false,"github":"https://github.com/parvez3019/go-swagger3","clone":"git clone https://github.com/parvez3019/go-swagger3.git","description":"Swagger 3.0 implementation for go","language":"Go","stars":148,"topics":["go","go-swagger","go-swag","go-documentation","documentation","open-source","library","openapi-specification","openapi3","swagger3"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"Demo Click here for Youtube Demo Link go-swagger3 Generate OpenAPI Specification v3 from Go godoc @ annotations and struct tags. OpenAPI 3-first, with swag-class DX: @Accept / @Produce , per-operation security, generics, composition, framework UI adapters, and go-swagger3 fmt . Migrating from swaggo/swag? See docs/MIGRATION FROM SWAG.md. AI agent skills Copy these into Claude / Cursor projects so agents can annotate existing Go APIs and generate OpenAPI 3 specs with go-swagger3: Agent Source Copy to ------- -------- --------- Claude Code agent-skills/claude/SKILL.md .claude/skills/go-swagger3-docs/SKILL.md Cursor agent-skills/cursor/cursor rules.mdc .cursor/rules/go-swagger3.mdc Table of content - 1. Install - 2. Documentation Generation - 3. Serving Swagger UI - Supported Web Frameworks - 4. Usage - Service Description - Handler functions - Title And Description - Parameter - Header - Header Parameters - Response Header - Response - Resource & Tag - Route - Enums - 5. Security - 6. Limitations - 7. References - Examples - Migration from swag 1. Install 2. Documentation Generation Using binary Go to the folder where is main.go in shell go-swagger3 fmt -d ./ shell // go.mod and main file are in the same directory docker run -t --rm -v $(pwd):/app -w /app parvez3019/go-swagger3:latest --module-path . --output oas.json --schema-without-pkg --generate-yaml true // go.mod and main file are in the different directory docker run -t --rm -v $(pwd):/app -w /app parvez3019/go-swagger3:","default_branch":null,"files":null,"tree":[],"storefront":"/r/parvez3019","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/parvez3019/go-swagger3/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}