|
| 1 | +[![][badge-license]][oap-license] |
| 2 | + |
1 | 3 |  |
2 | 4 |
|
| 5 | + |
3 | 6 | # openapi-processor-api |
4 | 7 |
|
5 | | -This library provides a simple api for any openapi-processor-* library. By implementing this api it |
| 8 | +This library provides the api for an openapi-processor-* library. By implementing this api it |
6 | 9 | will automatically work with the openapi-processor [gradle plugin][oap-gradle]. |
7 | 10 |
|
| 11 | +# Documentation |
8 | 12 |
|
9 | | -# implementing the api |
10 | | - |
11 | | -To make an openapi-processor available to the openapi-processor-gradle plugin it has to |
12 | | - |
13 | | -- implement the [`OpenApiProcessor`][oap-api] interface. |
14 | | - |
15 | | - The gradle plugin uses the name provided by the api to configure the processor and to provide a |
16 | | - task to run it. |
17 | | - |
18 | | -- and provide a `META-INF/services/com.github.hauner.openapi.api.OpenApiProcessor` property file in |
19 | | - the resources with the class name of the implementing class. |
20 | | - |
21 | | -# example implementations |
22 | | - |
23 | | -For examples see the implementations of |
24 | | - |
25 | | -*[openapi-processor-spring][oap-spring]* |
26 | | - |
27 | | -- [`SpringProcessor`][oap-spring-api-impl] (the entry point of the openapi-processor-spring) |
28 | | - implements the api interface |
29 | | -- and the corresponding [services property][oap-spring-api-props] file in the resources. |
30 | | - |
31 | | -*[openapi-processor-json][oap-json]* |
32 | | - |
33 | | -- [`JsonProcessor`][oap-json-api-impl] (the entry point of the openapi-processor-json) |
34 | | - implements the api interface |
35 | | -- and the corresponding [services property][oap-json-api-props] file in the resources. |
36 | | - |
37 | | - |
38 | | -[oap-api]: https://github.com/hauner/openapi-processor-api/tree/master/src/main/java/com/github/hauner/openapi/api/OpenApiGeneratr.java |
39 | | -[oap-gradle]: https://github.com/hauner/openapi-generatr-gradle |
40 | | - |
41 | | -[oap-spring]: https://github.com/hauner/openapi-generatr-spring |
42 | | -[oap-spring-api-impl]: https://github.com/hauner/openapi-generatr-spring/blob/master/src/main/groovy/com/github/hauner/openapi/spring/generatr/SpringGeneratr.groovy |
43 | | -[oap-spring-api-props]: https://github.com/hauner/openapi-generatr-spring/blob/master/src/main/resources/META-INF/services/com.github.hauner.openapi.api.OpenApiGeneratr |
44 | | - |
45 | | -[oap-json]: https://github.com/hauner/openapi-generatr-json |
46 | | -[oap-json-api-impl]: https://github.com/hauner/openapi-generatr-json/blob/master/src/main/groovy/com/github/hauner/openapi/spring/generatr/JsonGeneratr.groovy |
47 | | -[oap-json-api-props]: https://github.com/hauner/openapi-generatr-json/blob/master/src/main/resources/META-INF/services/com.github.hauner.openapi.api.OpenApiGeneratr |
| 13 | +See [here][oap-docs]. |
48 | 14 |
|
| 15 | +[badge-license]: https://img.shields.io/badge/License-Apache%202.0-blue.svg?labelColor=313A42 |
| 16 | +[badge-ci]: https://github.com/hauner/openapi-processor-api/workflows/ci/badge.svg |
| 17 | +[oap-docs]: https://hauner.github.com/openapi-processor/api/current/index.html |
| 18 | +[oap-gradle]: https://hauner.github.com/openapi-processor/gradle/current/index.html |
| 19 | +[oap-license]: https://github.com/hauner/openapi-processor-api/blob/master/LICENSE |
0 commit comments