{"id":21684699,"url":"https://github.com/openapi-tools/gradle-swagger-plugin","last_synced_at":"2025-03-20T11:27:08.357Z","repository":{"id":90863606,"uuid":"102495384","full_name":"openapi-tools/gradle-swagger-plugin","owner":"openapi-tools","description":"Gradle plugin for generating OpenAPI specification using Swagger","archived":false,"fork":false,"pushed_at":"2018-10-06T09:58:49.000Z","size":109,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-25T12:07:03.538Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Groovy","has_issues":false,"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/openapi-tools.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-09-05T15:00:46.000Z","updated_at":"2022-10-06T04:35:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"66716562-60a2-4873-aec1-0145127b3b7d","html_url":"https://github.com/openapi-tools/gradle-swagger-plugin","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi-tools%2Fgradle-swagger-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi-tools%2Fgradle-swagger-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi-tools%2Fgradle-swagger-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi-tools%2Fgradle-swagger-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openapi-tools","download_url":"https://codeload.github.com/openapi-tools/gradle-swagger-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244602943,"owners_count":20479730,"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":[],"created_at":"2024-11-25T16:16:49.339Z","updated_at":"2025-03-20T11:27:08.338Z","avatar_url":"https://github.com/openapi-tools.png","language":"Groovy","readme":"# Overview\n\n[![Build Status](https://travis-ci.org/Bankdata/gradle-swagger-plugin.svg?branch=master)](https://travis-ci.org/Bankdata/gradle-swagger-plugin)\n\nThis Gradle plugin is created to generate OpenAPI documentation from a JAX-RS based project using\n[Swagger](https://github.com/swagger-api/swagger-core).\n\n\n# Usage\n\nApplying the plugin to your project the generation will run Swagger to generate OpenAPI documentation\nafter classes are compiled. Applying this plugin will also imply applying the Java plugin. A minimal\nconfiguration is as follows.\n\n```groovy\nbuildscript {\n    dependencies {\n        classpath (group: 'dk.bankdata.gradle.swagger', name: 'gradle-swagger-plugin', version: '2.0.0')\n    }\n}\n\napply plugin: 'dk.bankdata.swagger'\n\nswagger {\n    resourcePackages = ['dk.bankdata.service.example']\n}\n```\n\nIt is possible to configure most of the general properties of the OpenAPI document with\nthe configuration in the build file. This implies using variable from the build file\nif applicable.\n\n```groovy\nbuildscript {\n    dependencies {\n        classpath (group: 'dk.bankdata.gradle.swagger', name: 'gradle-swagger-plugin', version: '2.0.0')\n    }\n}\n\napply plugin: 'dk.bankdata.swagger'\n\nswagger {\n    resourcePackages = ['dk.bankdata.gradle.swagger.example']\n    servers = [\n            {\n                url = \"https://api.bankdata.dk\"\n                description = \"production\"\n            }\n    ]\n    info {\n        title = 'Swagger Plugin Full'\n        version = '1.0.0'\n        description = 'This service does...'\n        termsOfService = 'Terms'\n        contact {\n            name = 'Bankdata'\n            url = 'https://www.bankdata.dk'\n            email = 'bankdata@e.mail'\n        }\n        license {\n            name = 'MIT'\n            url = 'http://mit'\n        }\n    }\n}\n```\n\n\n\n# Acknowledgements\n\nThe Gradle Swagger Plugin is inspired by the [Swagger Maven Plugin](https://github.com/openapi-tools/swagger-maven-plugin)\nand also the [Swagger Gradle Plugin](https://github.com/gigaSproule/swagger-gradle-plugin). However this plugin\nwas created with the specific purpose of using as much of the core Swagger modules as possible.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi-tools%2Fgradle-swagger-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenapi-tools%2Fgradle-swagger-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi-tools%2Fgradle-swagger-plugin/lists"}