{"id":26786162,"url":"https://github.com/derekahn/swaggen","last_synced_at":"2026-04-28T08:36:13.192Z","repository":{"id":47999241,"uuid":"144618969","full_name":"derekahn/swaggen","owner":"derekahn","description":"🤖Swagger code generator for organized and maintainable swagger documentations.","archived":false,"fork":false,"pushed_at":"2022-12-10T20:36:17.000Z","size":171,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-29T11:36:00.379Z","etag":null,"topics":["code-generator","documentation-tool","node","swagger"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/derekahn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-13T18:34:02.000Z","updated_at":"2020-08-10T15:34:25.000Z","dependencies_parsed_at":"2023-01-26T10:47:11.220Z","dependency_job_id":null,"html_url":"https://github.com/derekahn/swaggen","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/derekahn/swaggen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derekahn%2Fswaggen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derekahn%2Fswaggen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derekahn%2Fswaggen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derekahn%2Fswaggen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/derekahn","download_url":"https://codeload.github.com/derekahn/swaggen/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derekahn%2Fswaggen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32373512,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-generator","documentation-tool","node","swagger"],"created_at":"2025-03-29T11:35:51.868Z","updated_at":"2026-04-28T08:36:13.141Z","avatar_url":"https://github.com/derekahn.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Swaggen\n\nSwagger code generator for organized and maintainable swagger documentations.\n\n## Example ping.doc.js (copy pasta):\n\n```javascript\nconst tags = [\n  {\n    name: 'ping',\n    description: 'ping the world',\n  },\n];\n\nconst paths = {\n  ping: {\n    get: {\n      summary: 'A simple GET to our example app',\n      description: '/ping returns a string',\n      tags: ['ping'],\n      produces: ['application/json'],\n      parameters: [],\n      responses: {\n        200: {\n          description: 'Successful GET',\n          schema: {\n            type: 'object',\n            properties: {\n              foo: {\n                type: 'string',\n                example: 'hello 🌎',\n              },\n              bar: {\n                type: 'integer',\n                example: 55,\n              },\n              baz: {\n                type: 'boolean',\n                example: true,\n              },\n            },\n          },\n        },\n      },\n    },\n  },\n};\n\nconst definitions = {};\n\nmodule.exports = { tags, paths, definitions };\n```\n\n## Usage:\n\n```shell\n$ yarn; cd example \u0026\u0026 yarn;\n\n# in root of swaggen/\n$ yarn docs route=example/routes/ping\n\n# copy the example config above ☝\n$ vim example/routes/ping/docs/ping.doc.js\n\n# start example app and go to localhost:8080/swagger\n$ cd example/ \u0026\u0026 yarn start\n\n```\n\n## TODO\n* [ ]  convert to NPM 📦\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderekahn%2Fswaggen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderekahn%2Fswaggen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderekahn%2Fswaggen/lists"}