{"adoption": {"forks": 1550, "observed_at": "2026-08-28T04:11:00.352091+00:00", "stars": 12994}, "canonical_url": "https://ross.abutalabs.com/products/swag", "card": {"archived": false, "artifact_type": "cli-tool", "description": "Automatically generate RESTful API documentation with Swagger 2.0 for Go.", "domain": ["developer-tools", "apis", "documentation", "web-development"], "enriched": true, "function": ["api-documentation", "documentation", "cli", "developer-tools"], "health_score": 96, "homepage": null, "language": "Go", "license": "MIT", "license_family": "permissive", "maturity": "stable", "member_repos": ["swaggo/swag", "swaggo/gin-swagger"], "name": "swag", "platform": ["go", "cli", "cross-platform"], "pushed_at": "2026-08-18T18:04:17+00:00", "repo": "swaggo/swag", "stars": 12994, "tags": ["swagger", "openapi", "swagger-ui", "gin", "code-generation", "annotations", "rest-api"], "topics": ["golang", "swagger", "swagger2", "annotations", "openapi"], "urls": [], "use_cases": ["generate swagger docs from go comments", "document a gin rest api", "serve swagger ui for a go backend", "auto-generate openapi spec for go project", "keep api documentation in sync with code", "add swagger annotations to go handlers"], "what_it_is": "Swag converts Go source code annotations into Swagger 2.0 (OpenAPI) documentation, with a CLI generator and integrations for popular Go web frameworks like Gin. It lets developers keep API docs alongside their handlers and serve them via Swagger UI.", "when_to_avoid": ["you need OpenAPI 3.x support specifically", "your API is not written in Go", "you prefer spec-first (design-first) workflows writing OpenAPI by hand"], "when_to_choose": ["you write Go web APIs and want docs generated from code comments", "you use Gin, Echo, or other supported Go frameworks and want Swagger UI integration", "you want OpenAPI/Swagger 2.0 specs without hand-writing YAML"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/repos/swaggo/swag", "repo": "swaggo/swag", "role": "main", "score": 78}, {"path": "/repos/swaggo/gin-swagger", "repo": "swaggo/gin-swagger", "role": "plugin", "score": 66}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:11:00.352091+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T17:13:36.940104+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9c4625551d9c0f9c5699144d6a2b04378cdb102fd38fb457d6d345ce7617c111", "fetched_at": "2026-08-28T04:11:00.352091+00:00", "kind": "readme", "missing": false, "url": "https://github.com/swaggo/swag"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 98, "longevity": 100, "rhythm": 41}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3371, "days_push": 15, "days_rel": 236, "gap_med": 103.0, "n_releases_24m": 5}, "score": 78, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}