{"id":15068919,"url":"https://github.com/kbuntrock/openapi-maven-plugin","last_synced_at":"2025-07-27T12:05:22.222Z","repository":{"id":37941758,"uuid":"478978281","full_name":"kbuntrock/openapi-maven-plugin","owner":"kbuntrock","description":"Generate openapi documentation for SpringMVC or JaxRS/JakartaRS projects.","archived":false,"fork":false,"pushed_at":"2025-05-21T21:50:32.000Z","size":1252,"stargazers_count":26,"open_issues_count":27,"forks_count":16,"subscribers_count":5,"default_branch":"dev","last_synced_at":"2025-05-21T22:37:38.940Z","etag":null,"topics":["compilation","jakartars","java","java11","java17","java8","jax-rs","jaxrs","maven-plugin","openapi","spring-mvc"],"latest_commit_sha":null,"homepage":"https://kbuntrock.github.io/openapi-maven-plugin/","language":"Java","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/kbuntrock.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,"zenodo":null}},"created_at":"2022-04-07T12:37:22.000Z","updated_at":"2025-05-21T21:50:36.000Z","dependencies_parsed_at":"2024-02-05T21:48:01.629Z","dependency_job_id":"eaacb4eb-3086-4af4-afd4-5fe2d72fb8a1","html_url":"https://github.com/kbuntrock/openapi-maven-plugin","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/kbuntrock/openapi-maven-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbuntrock%2Fopenapi-maven-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbuntrock%2Fopenapi-maven-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbuntrock%2Fopenapi-maven-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbuntrock%2Fopenapi-maven-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kbuntrock","download_url":"https://codeload.github.com/kbuntrock/openapi-maven-plugin/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbuntrock%2Fopenapi-maven-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267354581,"owners_count":24073796,"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","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"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":["compilation","jakartars","java","java11","java17","java8","jax-rs","jaxrs","maven-plugin","openapi","spring-mvc"],"created_at":"2024-09-25T01:39:44.132Z","updated_at":"2025-07-27T12:05:22.216Z","avatar_url":"https://github.com/kbuntrock.png","language":"Java","readme":"# Openapi maven plugin\n\n[![Maven Central](https://img.shields.io/maven-central/v/io.github.kbuntrock/openapi-maven-plugin.svg?label=Maven%20Central)](https://central.sonatype.com/artifact/io.github.kbuntrock/openapi-maven-plugin)\n[![CircleCI](https://circleci.com/gh/kbuntrock/openapi-maven-plugin/tree/dev.svg?style=shield)](https://circleci.com/gh/kbuntrock/openapi-maven-plugin/tree/dev)\n![Coverage](../badges/jacoco.svg)\n![GitHub](https://img.shields.io/github/license/kbuntrock/openapi-maven-plugin?color=blue)\n\nThe openapi maven plugin analyse Rest controller java classes and generate the corresponding openapi 3.0.3 documentation. It supports Spring MVC, Javax RS and Jakarta RS annotations.\n\nIt is compatible from jdk8 to at least jdk21 (IT tests are run on jdk 8, 11, 17 and 21).\n\nThe plugin generate the documentation using the compiled classes + the source code of the project.\n\nDoing this process during the building phase of a project has several advantages compared to other methods:\n- the source code of the project can be parsed to extract javadoc comments and enrich the generated documentation. There is no need of a third party annotation library for the sole purpose of keeping comments available at runtime. Your code stay pure and you don't duplicate information.\n- no extra dependency in your jar/war. No need to monitor another library for vulnerabilities.\n- implementating interfaces or abstract classes is not a requirement. The documentation can be generated from a module referencing only interfaces; which will be later in the build chain implemented in one or several other modules.\n- usually faster than launching an app / running the integration test phase\n\nNumerous configuration options are available.\n\nOne can mention : \n- possibility to generate several documentations with different configurations\n- \"white list\" / \"black list\" mecanism on scanned classes / methods\n- addition of infos not found in the code (security, licence, ...)\n- defining a \"loopback operation name\", used by some code generation tools (see [here](https://loopback.io/doc/en/lb4/Decorators_openapi.html) and [here](https://github.com/cyclosproject/ng-openapi-gen) ).\n...\n\nFull documentation is located [here](https://kbuntrock.github.io/openapi-maven-plugin) and is available in english or french.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbuntrock%2Fopenapi-maven-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkbuntrock%2Fopenapi-maven-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbuntrock%2Fopenapi-maven-plugin/lists"}