Skip to content

Commit 07abdf1

Browse files
committed
renamed project in docs
1 parent 461730a commit 07abdf1

20 files changed

Lines changed: 99 additions & 220 deletions

docs/Gemfile.lock

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ GEM
1616
colorator (1.1.0)
1717
commonmarker (0.17.13)
1818
ruby-enum (~> 0.5)
19-
concurrent-ruby (1.1.5)
19+
concurrent-ruby (1.1.6)
2020
dnsruby (1.61.3)
2121
addressable (~> 2.5)
2222
em-websocket (0.5.1)
@@ -204,9 +204,9 @@ GEM
204204
jekyll-seo-tag (~> 2.1)
205205
minitest (5.14.0)
206206
multipart-post (2.1.1)
207-
nokogiri (1.10.7)
207+
nokogiri (1.10.8)
208208
mini_portile2 (~> 2.4.0)
209-
octokit (4.15.0)
209+
octokit (4.16.0)
210210
faraday (>= 0.9)
211211
sawyer (~> 0.8.0, >= 0.5.3)
212212
pathutil (0.16.2)

docs/_config.yml

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
title: openapi-generatr-spring
1+
title: openapi-processor-spring
22

33
description: >-
4-
an openapi generatr for spring-boot
4+
an openapi-processor for spring-boot
55
66
url: "https://hauner.github.io"
7-
baseurl: "/openapi-generatr-spring/"
7+
baseurl: "/openapi-processor-spring"
88

99
twitter_username: "@MartinHauner"
1010
github_username: hauner
@@ -17,14 +17,20 @@ exclude:
1717
- api.md
1818
- gradle-obsolete.md
1919

20+
include:
21+
- ../images
22+
2023
##
2124
## "just-the-docs" theme options
2225
##
2326
search_enabled: true
2427
search_tokenizer_separator: /[\s/]+/
2528

29+
# logo, replaces the title
30+
logo: "../images/openapi-processor-spring@1280x200.png"
31+
2632
aux_links:
27-
openapi-generatr-spring:
28-
- //github.com/hauner/openapi-generatr-spring
33+
openapi-processor-spring:
34+
- //github.com/hauner/openapi-processor-spring
2935

3036
#footer_content:

docs/api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: default
3-
title: Generatr API
3+
title: Processor API
44
nav_order: 20
55
---
66

@@ -10,7 +10,7 @@ nav_order: 20
1010
todo
1111
{: .label .label-yellow }
1212

13-
describe the generatr api
13+
describe the processor api
1414

1515
## table of contents
1616
{: .no_toc .text-delta }

docs/gradle-obsolete.md

Lines changed: 0 additions & 133 deletions
This file was deleted.

docs/gradle.md

Lines changed: 28 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,17 @@ nav_order: 9
77
# Using Gradle
88
{: .no_toc }
99

10-
Note: this page is for the gradle plugin since version '1.0.0.M5'. The new plugin provides proper
11-
up-to-date checking (it does not re-run the generatr when the api yaml is unchanged) and uses a
10+
Note: this page is for the gradle plugin since version '1.0.0.M6'. The new plugin provides proper
11+
up-to-date checking (it does not re-run the processor when the api yaml is unchanged) and uses a
1212
simpler configuration.
1313
{: .note .info .mb-6}
1414

1515

16-
The [openapi-generatr-gradle][generatr-gradle] is currently the only way to run a **openapi-generatr.**
16+
The [openapi-processor-gradle][oap-gradle] is currently the only tool to run a **openapi-processor**.
1717

1818
To use it in a gradle project the gradle file of the project requires a few additional instructions.
19-
The following sections describe how to activate & configure **generatr-spring** in a `build.gradle` file.
19+
The following sections describe how to activate & configure **openapi-processor-spring** in a
20+
`build.gradle` file.
2021
{: .mb-6 }
2122

2223
## table of contents
@@ -28,26 +29,26 @@ The following sections describe how to activate & configure **generatr-spring**
2829

2930
# adding the plugin
3031

31-
The [openapi-generatr-gradle][generatr-gradle] plugin is activated (like any other gradle plugin) in
32+
The [openapi-processor-gradle][oap-gradle] plugin is activated (like any other gradle plugin) in
3233
the `plugins` configuration:
3334

3435
plugins {
3536
....
36-
// add generatr-gradle plugin
37-
id 'com.github.hauner.openapi-generatr' version '<version>'
37+
// add openapi-processor-gradle plugin
38+
id 'com.github.hauner.openapi-processor' version '<version>'
3839
}
3940
4041
41-
# configuring generatr-spring
42+
# configuring openapi-processor-spring
4243

43-
The plugin will add an `openapiGeneratr` configuration block that is used to configure the generatrs.
44-
Configuration for a specific generatr is placed inside it using the generatr name as configuration
44+
The plugin will add an `openapiProcessor` configuration block that is used to configure the processors.
45+
Configuration for a specific processor is placed inside it using the processor name as configuration
4546
block name.
4647

47-
openapiGeneratr {
48+
openapiProcessor {
4849

4950
spring {
50-
generatr 'com.github.hauner.openapi:openapi-generatr-spring:<version>'
51+
processor 'com.github.hauner.openapi:openapi-processor-spring:<version>'
5152
apiPath "$projectDir/src/api/openapi.yaml"
5253
targetDir "$projectDir/build/openapi"
5354
mapping "$projectDir/openapi-mapping.yaml"
@@ -56,20 +57,20 @@ block name.
5657

5758
}
5859

59-
- `generatr`: (**required**) the generatr dependency. This works in the same way as adding a dependency
60+
- `processor`: (**required**) the generatr dependency. This works in the same way as adding a dependency
6061
to a configuration in the gradle `dependencies` block. It is given here to avoid un-wanted side effects
6162
on the build dependencies of the project.
6263

63-
- `apiPath`: (**required**) the path to the `openapi.yaml` file and the main input for the generatr. If
64-
set in the top level block it will be used for all configured generatrs.
64+
- `apiPath`: (**required**) the path to the `openapi.yaml` file and the main input for the processor. If
65+
set in the top level block it will be used for all configured processors.
6566

6667
- `targetDir`: (**required**) the output folder for generating interfaces & models. This is the parent
6768
of the `packageName` folder tree. It is recommended to set this to a subfolder of gradle's standard `build`
6869
directory so it is cleared by the `clean` task and does not pollute the sources directory.
6970

70-
See [running the generatr][docs-running] how to include the `targetDir` in compilation & packing.
71+
See [running the processor][docs-running] how to include the `targetDir` in compilation & packing.
7172

72-
- `mapping`: (**required**, since 1.0.0.M6) provides the generatr mapping options. This is a path
73+
- `mapping`: (**required**, since 1.0.0.M6) provides the processor mapping options. This is a path
7374
to yaml file. See [Configuration][docs-configuration] for a description of the mapping yaml. This replaces
7475
the `typeMappings` option.
7576

@@ -100,13 +101,13 @@ directory so it is cleared by the `clean` task and does not pollute the sources
100101
[Configuration][docs-configuration].
101102
{: .mb-5 }
102103

103-
# running generatr-spring
104+
# running processor-spring
104105

105-
The plugin will add a gradle task `generateSpring` to run the generatr.
106+
The plugin will add a gradle task `processSpring` to run the processor.
106107

107-
To automatically generate & compile the generatr output two additional configurations are required.
108+
To automatically generate & compile the processor output two additional configurations are required.
108109

109-
- the `sourceSets` are extended to include the generatr output (assuming a java project):
110+
- the `sourceSets` are extended to include the processor output (assuming a java project):
110111

111112
sourceSets {
112113
main {
@@ -118,17 +119,17 @@ To automatically generate & compile the generatr output two additional configura
118119
}
119120

120121

121-
- and the `compileJava` task gets a dependency on `generateSpring` so it runs before compilation (again,
122+
- and the `compileJava` task gets a dependency on `processSpring` so it runs before compilation (again,
122123
assuming a java project):
123124

124125
// generate api before compiling
125-
compileJava.dependsOn ('generateSpring')
126+
compileJava.dependsOn ('processSpring')
126127

127128
Adding automatic compilation in this way will also automatically include the generated files into the
128129
`jar` build artifact.
129130

130131

131-
[generatr-gradle]: https://github.com/hauner/openapi-generatr-gradle
132-
[docs-mapping]: /openapi-generatr-spring/mapping/
133-
[docs-configuration]: /openapi-generatr-spring/generatr/configuration.html
134-
[docs-running]: #running-generatr-spring
132+
[oap-gradle]: https://github.com/hauner/openapi-processor-gradle
133+
[docs-mapping]: /openapi-processor-spring/mapping/
134+
[docs-configuration]: /openapi-processor-spring/generatr/configuration.html
135+
[docs-running]: #running-processor-spring

docs/howto/global-array-mapping.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ parent: HowTo's
55
nav_order: 1
66
---
77

8-
# generatr: map openapi array (globally) to a java collection type
8+
# processor: map openapi array (globally) to a java collection type
99

1010
By default the OpenAPI `array` is mapped to a simple java array. It is possible to change that default
1111
mapping for example to `java.util.Collection` by adding a type mapping to the [`mapping.yaml`][docs-mapping].
@@ -28,7 +28,7 @@ Given the following openapi.yaml fragment:
2828
type: string
2929
```
3030
31-
the generatr will create the following endpoint interface:
31+
the processor will create the following endpoint interface:
3232
3333
```java
3434
@GetMapping(path = "/array", produces = {"application/json"});
@@ -56,13 +56,13 @@ will change the generated endpoint to:
5656

5757
using the `array`s `items` property as the generic parameter of `Collection`.
5858

59-
The generatr needs to know the given collection type to generate proper java code so we can't simply
60-
add a random collection type. The generatr does currently recognize the following types:
59+
The processor needs to know the given collection type to generate proper java code so we can't simply
60+
add a random collection type. The processor does currently recognize the following types:
6161

6262
- `java.util.Collection`
6363
- `java.util.List`
6464
- `java.util.Set`
6565

6666

6767

68-
[docs-mapping]: /openapi-generatr-spring/mapping/
68+
[docs-mapping]: /openapi-processor-spring/mapping/

docs/howto/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ has_children: true
77

88
# HowTo's
99

10-
This section collects some small examples how to configure the generatr to achieve the expected output.
10+
This section collects some small examples how to configure the processor to achieve the expected output.

docs/howto/pageable-page-mapping.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ parent: HowTo's
55
nav_order: 5
66
---
77

8-
# generatr: using Spring Pageable & Page
8+
# processor: using Spring Pageable & Page
99

1010
The given (lengthy) openapi yaml example describes a pageable api in two variations. The `/page`
1111
endpoint uses named objects and the second endpoint `/page-inline` uses inline objects to describe
@@ -111,7 +111,7 @@ components:
111111
- $ref: '#/components/schemas/StringContent'
112112
```
113113
114-
The generatr does create a proper interface with both endpoints if we provide a type mappings for the
114+
The processor does create a proper interface with both endpoints if we provide a type mappings for the
115115
`Pageable` and `Page` types.
116116

117117
Here is the java code we expect:
@@ -168,5 +168,5 @@ Usually you would use the first variation using named objects so they can be re-
168168
In that case you will only need the global type mapping of `Pageable` and the `StringPage`. Note that
169169
the `StringPage` uses a generic parameter.
170170

171-
Worth mentioning is that the generatr will not generate model classes for the openapi types `Pageable`,
171+
Worth mentioning is that the processor will not generate model classes for the openapi types `Pageable`,
172172
`Page`, `StringContent` or `StringPage`.

0 commit comments

Comments
 (0)