{"id":26032711,"url":"https://github.com/apache/geronimo-openapi","last_synced_at":"2025-04-09T18:51:09.163Z","repository":{"id":65979362,"uuid":"138131643","full_name":"apache/geronimo-openapi","owner":"apache","description":"Apache Geronimo Microprofile OpenAPI Implementation","archived":false,"fork":false,"pushed_at":"2022-11-15T23:31:23.000Z","size":343,"stargazers_count":11,"open_issues_count":2,"forks_count":16,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-03T04:16:55.896Z","etag":null,"topics":["geronimo","http","java","javaee","network-server","web-framework"],"latest_commit_sha":null,"homepage":"https://geronimo.apache.org/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-21T06:56:06.000Z","updated_at":"2022-11-26T12:05:20.000Z","dependencies_parsed_at":"2023-02-19T19:31:18.590Z","dependency_job_id":null,"html_url":"https://github.com/apache/geronimo-openapi","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-openapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-openapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-openapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-openapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/geronimo-openapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247899690,"owners_count":21014941,"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":["geronimo","http","java","javaee","network-server","web-framework"],"created_at":"2025-03-06T22:50:29.801Z","updated_at":"2025-04-09T18:51:09.117Z","avatar_url":"https://github.com/apache.png","language":"Java","readme":"= Geronimo Microprofile OpenAPI\n\n== Implementation\n\n=== Artifact\n\n[source,xml]\n----\n\u003cparent\u003e\n  \u003cgroupId\u003eorg.apache.geronimo\u003c/groupId\u003e\n  \u003cartifactId\u003egeronimo-openapi\u003c/artifactId\u003e\n  \u003cversion\u003e${openapi.version}\u003c/version\u003e\n\u003c/parent\u003e\n----\n\n=== Dependencies\n\n1. JAX-RS+Servlet\n2. CDI (optional if used as a library)\n3. JSONB (for JSON support)\n4. Jackson+YAML extension (for YAML support)\n\n== Maven Plugin\n\nYou can define the maven plugin to generate at build time the `openapi.json` file.\nThen the runtime is able to load it directly and merge it with the current runtime.\nThe big advantage is to be able to use it without the runtime for documentation purposes.\n\nHere is how to define it:\n\n[source,xml]\n----\n\u003cplugin\u003e\n  \u003cgroupId\u003eorg.apache.geronimo\u003c/groupId\u003e\n  \u003cartifactId\u003egeronimo-openapi-maven-plugin\u003c/artifactId\u003e\n  \u003cversion\u003e${openapi.version}\u003c/version\u003e\n  \u003cexecutions\u003e\n    \u003cexecution\u003e\n      \u003cid\u003egenerate-openapi.json\u003c/id\u003e\n      \u003cgoals\u003e\n        \u003cgoal\u003eopenapi.json\u003c/goal\u003e\n      \u003c/goals\u003e\n      \u003cconfiguration\u003e\n        \u003capplication\u003ecom.test.MyApp\u003c/application\u003e\n        \u003cendpointClasses\u003e\n          \u003cendpointClass\u003ecom.test.SomeEndpoint\u003c/endpointClass\u003e\n          \u003cendpointClass\u003ecom.test.SomeOtherEndpoint\u003c/endpointClass\u003e\n        \u003c/endpointClasses\u003e\n        \u003cinfo\u003e\n          \u003cversion\u003e1\u003c/version\u003e\n          \u003ctitle\u003eMy Title\u003c/title\u003e\n          \u003cdescription\u003eBla Bla\u003c/description\u003e\n        \u003c/info\u003e\n      \u003c/configuration\u003e\n    \u003c/execution\u003e\n  \u003c/executions\u003e\n\u003c/plugin\u003e\n----\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fgeronimo-openapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fgeronimo-openapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fgeronimo-openapi/lists"}