PW-7045: Model generation workflow (#809)

* PW-7045: Model generator

* PW-7045: Generate models workflow

* PW-7045: Link to spec source

* PW-7045: Use @AdyenAutomationBot

* PW-7045: Generate models only for classic payments

Other services need more more work on schemas, templates and dependencies.

* PW-7045: Remove PR event

Author: michaelpaul

.github/workflows/models.yml

@@ -0,0 +1,30 @@
+name: Java Models
+
+on: [ workflow_dispatch ]
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    name: Generate Models
+    steps:
+      - uses: actions/checkout@v3
+      - run: make models
+      - name: Set PR variables
+        id: vars
+        run: |
+          cd target/spec
+          echo ::set-output name=pr_title::"Update models"
+          echo ::set-output name=pr_body::"OpenAPI spec or templates produced new models on $(date +%d-%m-%Y) \
+            by [commit](https://github.com/Adyen/adyen-openapi/commit/$(git rev-parse HEAD))."
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          token: ${{ secrets.ADYEN_AUTOMATION_BOT_ACCESS_TOKEN }}
+          committer: ${{ secrets.ADYEN_AUTOMATION_BOT_EMAIL }}
+          author: ${{ secrets.ADYEN_AUTOMATION_BOT_EMAIL }}
+          base: develop
+          branch: automation/models
+          title: ${{ steps.vars.outputs.pr_title }}
+          body: ${{ steps.vars.outputs.pr_body }}
+          add-paths: |
+            src/main/java/com/adyen/model

.openapi-generator-ignore

@@ -1,3 +1,3 @@
 # These models cannot properly represent additional data, a `Map<String, String>` is used instead
-src/main/java/com/adyen/model/payments/AdditionalData*
-src/main/java/com/adyen/model/payments/ResponseAdditionalData*
+target/out/src/main/java/com/adyen/model/payments/AdditionalData*
+target/out/src/main/java/com/adyen/model/payments/ResponseAdditionalData*

Makefile

@@ -0,0 +1,74 @@
+openapi-generator-version:=6.0.1
+openapi-generator-url:=https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/$(openapi-generator-version)/openapi-generator-cli-$(openapi-generator-version).jar
+openapi-generator-jar:=target/openapi-generator-cli.jar
+openapi-generator-cli:=java -jar $(openapi-generator-jar)
+
+generator:=java
+library:=okhttp-gson
+services:=payments
+models:=src/main/java/com/adyen/model
+output:=target/out
+
+
+# Generate models (for each service)
+models: $(services)
+
+binlookup: spec=BinLookupService-v52
+checkout: spec=CheckoutService-v69
+storedValue: spec=StoredValueService-v46
+posterminalmanagement: spec=TfmAPIService-v1
+payments: spec=PaymentService-v68
+recurring: spec=RecurringService-v68
+payout: spec=PayoutService-v68
+management: spec=ManagementService-v1
+balanceplatform: spec=BalancePlatformService-v2
+transfers: spec=TransferService-v3
+# Classic Platforms
+marketpay/account: spec=AccountService-v6
+marketpay/fund: spec=FundService-v6
+marketpay/configuration: spec=NotificationConfigurationService-v6
+marketpay/webhooks: spec=MarketPayNotificationService-v6
+hop: spec=HopService-v6
+
+$(services): target/spec $(openapi-generator-jar)
+	rm -rf $(models)/$@ $(output)
+	$(openapi-generator-cli) generate \
+		-i target/spec/json/$(spec).json \
+		-g $(generator) \
+		-t templates \
+		-o $(output) \
+		--ignore-file-override ./.openapi-generator-ignore \
+		--skip-validate-spec \
+		--model-package $(subst /,.,com.adyen.model.$@) \
+		--library $(library) \
+		--global-property models \
+		--global-property modelDocs=false \
+		--global-property modelTests=false \
+		--additional-properties=dateLibrary=legacy
+	mv $(output)/$(models)/$@ $(models)/$@
+
+
+# Checkout spec (and patch version)
+target/spec:
+	git clone https://github.com/Adyen/adyen-openapi.git target/spec
+	perl -i -pe's/"openapi" : "3.[0-9].[0-9]"/"openapi" : "3.0.0"/' target/spec/json/*.json
+
+
+# Extract templates (copy them for modifications)
+templates: $(openapi-generator-jar)
+	$(openapi-generator-cli) author template -g $(generator) --library $(library) -o target/templates
+
+
+# Download the generator
+$(openapi-generator-jar):
+	wget --quiet -o /dev/null $(openapi-generator-url) -O $(openapi-generator-jar)
+
+
+# Discard generated artifacts and changed models
+clean:
+	rm -rf $(output)
+	git checkout $(models)
+	git clean -f -d $(models)
+
+
+.PHONY: templates models $(services)

pom.xml

@@ -25,6 +25,7 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <swagger-core-version>1.6.5</swagger-core-version>
     </properties>
     <scm>
         <connection>scm:git:[email protected]:Adyen/adyen-java-api-library.git</connection>
@@ -137,7 +138,6 @@
                 <version>3.2.0</version>
                 <configuration>
                     <configLocation>checkstyle.xml</configLocation>
-                    <encoding>UTF-8</encoding>
                     <consoleOutput>true</consoleOutput>
                     <failsOnError>true</failsOnError>
                 </configuration>
@@ -231,5 +231,17 @@
             <artifactId>swagger-annotations</artifactId>
             <version>2.2.2</version>
         </dependency>
+        <!-- Generated model annotations -->
+        <dependency>
+            <groupId>io.swagger</groupId>
+            <artifactId>swagger-annotations</artifactId>
+            <version>${swagger-core-version}</version>
+        </dependency>
+        <!-- @Nullable annotation -->
+        <dependency>
+            <groupId>com.google.code.findbugs</groupId>
+            <artifactId>jsr305</artifactId>
+            <version>3.0.2</version>
+        </dependency>
     </dependencies>
 </project>