{"id":14986644,"url":"https://github.com/farhatmo/express-swaggerize","last_synced_at":"2026-01-31T06:31:15.252Z","repository":{"id":87178388,"uuid":"87736496","full_name":"farhatmo/express-swaggerize","owner":"farhatmo","description":"Amazing package for swagger-ui + express","archived":false,"fork":false,"pushed_at":"2017-08-07T08:14:00.000Z","size":418,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-26T12:26:29.920Z","etag":null,"topics":["express","express-middleware","jsdoc","swagger","swagger-api","swagger-specification","swagger-ui","yaml-parser"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/farhatmo.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-09T20:19:48.000Z","updated_at":"2018-11-20T09:44:34.000Z","dependencies_parsed_at":"2023-03-03T17:00:29.939Z","dependency_job_id":null,"html_url":"https://github.com/farhatmo/express-swaggerize","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"b6bc4860542782c61d3f50359de1291e45cef1aa"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farhatmo%2Fexpress-swaggerize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farhatmo%2Fexpress-swaggerize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farhatmo%2Fexpress-swaggerize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farhatmo%2Fexpress-swaggerize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/farhatmo","download_url":"https://codeload.github.com/farhatmo/express-swaggerize/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244836045,"owners_count":20518368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["express","express-middleware","jsdoc","swagger","swagger-api","swagger-specification","swagger-ui","yaml-parser"],"created_at":"2024-09-24T14:13:16.590Z","updated_at":"2026-01-31T06:31:15.241Z","avatar_url":"https://github.com/farhatmo.png","language":"HTML","readme":"# Express-Swaggerize\n\nThe project provides a middleware to integrate swagger-ui based on comments in the javascript code. The idea is to solve the common issues with connecting many package in order to get an automatic process for generating documentation from the comments in the source code.\nIt's used with the middleware express. Please visit the [issue tracker][project-issues] to see what issues we are aware of and what features/enhancements we are working on.\n\n\n## Supported Swagger Versions\n\n* [1.2][swagger-docs-v1_2]\n* [2.0][swagger-docs-v2_0]\n\n\u003c!--\n## Installation Node.js\n\nInstallation for Node.js applications can be done via [NPM][npm].\n\n```\nnpm install express-swaggerize --save\n```--\u003e\n\n## Quick Start\n\n**express-swaggerize** used with express and parse the sources files (for the specification ) in order de define a swagger api.\n\n```javascript\n\n  var swaggerize = require('express-swaggerize');\n\n  var app = express();\n\n  var options = {\n    // Import swaggerDefinitions\n    swaggerDefinition: {\n      info: { // API informations (required)\n        title: 'Swagger', // Title (required)\n        version: '1.0.0', // Version (required)\n        description: 'A sample API made with \u003c3' // Description (optional)\n      },\n      host: 'localhost:3000', // Host (optional)\n      basePath: '/api', // Base path (optional)\n      securityDefinitions: { // security definition (optional)\n        token: {\n          type: 'apiKey', \n          name: 'Authorization',\n          in: 'header'\n        }\n      }\n    },\n    // Path to the API docs\n    apiPaths: [path.resolve('./routes/*.routes.js'), path.resolve('./models/*.model.js')]\n  };\n\n  // Initialize express swagger object\n  var swagger = swaggerize(options);\n\n  // Affect the swagger express routes to '/v2/api'\n  app.use('/v2/api', swagger);\n\n```\n\n## Contributing\n\nWe welcome pull requests from the community! Feel free to propose new features as PR in order to improve this package.\n\n\n\n[project-issues]: https://github.com/farhatmo/express-swaggerize/issues\n[swagger]: http://swagger.io/\n[swagger-docs-v1_2]: https://github.com/swagger-api/swagger-spec/blob/master/versions/1.2.md\n[swagger-docs-v2_0]: https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md\n[swagger-ui]: https://github.com/swagger-api/swagger-ui","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarhatmo%2Fexpress-swaggerize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarhatmo%2Fexpress-swaggerize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarhatmo%2Fexpress-swaggerize/lists"}