Add validate Mojo to Maven Plugin

modules/openapi-generator-maven-plugin/pom.xml

@@ -30,6 +30,11 @@
             <version>${maven.version}</version>
             <scope>provided</scope>
         </dependency>
+        <dependency>
+        <groupId>org.apache.maven.shared</groupId>
+        <artifactId>maven-shared-utils</artifactId>
+        <version>3.3.4</version>
+    </dependency>
         <dependency>
             <groupId>org.apache.maven</groupId>
             <artifactId>maven-artifact</artifactId>
@@ -102,7 +107,12 @@
             <version>4.8.0</version>
             <scope>test</scope>
         </dependency>
-
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-core</artifactId>
+            <version>${mockito.version}</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <pluginManagement>
@@ -174,6 +184,10 @@
                             <failIfNoProjects>true</failIfNoProjects>
                             <postBuildHookScript>verify</postBuildHookScript>
                             <streamLogsOnFailures>true</streamLogsOnFailures>
+                            <pomIncludes>
+                                <pomInclude>*/pom.xml</pomInclude>
+                                <pomInclude>validate-harness/*/pom.xml</pomInclude>
+                            </pomIncludes>
                         </configuration>
                         <dependencies>
                             <dependency>

modules/openapi-generator-maven-plugin/src/it/validate-harness/cli-comma-separated-override/invoker.properties

@@ -0,0 +1,3 @@
+invoker.goals = validate
+invoker.systemProperties = openapi.generator.inputSpec=valid_api.yaml,unused_model_api.yaml
+invoker.buildResult = success

modules/openapi-generator-maven-plugin/src/it/validate-harness/cli-comma-separated-override/pom.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools.it</groupId>
+    <artifactId>cli-comma-separated-override</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>@project.version@</version>
+            </plugin>
+        </plugins>
+    </build>
+</project>

modules/openapi-generator-maven-plugin/src/it/validate-harness/cli-comma-separated-override/unused_model_api.yaml

@@ -0,0 +1,27 @@
+openapi: 3.0.3
+info:
+  title: API with Style Recommendations
+  version: 1.0.0
+  description: Valid spec syntax, but contains an isolated component model that triggers an unused schema warning.
+paths:
+  /users:
+    get:
+      summary: Get active users
+      operationId: getUsers
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: string
+components:
+  schemas:
+    UnusedModel:
+      type: object
+      properties:
+        legacyField:
+          type: integer
+          description: This model is declared but never referenced anywhere in any operation or path parameter.

modules/openapi-generator-maven-plugin/src/it/validate-harness/cli-comma-separated-override/valid_api.yaml

@@ -0,0 +1,25 @@
+openapi: 3.0.3
+info:
+  title: Healthy Test API
+  version: 1.0.0
+  description: A completely valid specification with no errors or recommendations.
+paths:
+  /ping:
+    get:
+      summary: Simple healthcheck endpoint
+      operationId: pingCheck
+      responses:
+        '200':
+          description: Server is operational
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pong'
+components:
+  schemas:
+    Pong:
+      type: object
+      properties:
+        status:
+          type: string
+          example: healthy

modules/openapi-generator-maven-plugin/src/it/validate-harness/input-directory-merge/invoker.properties

@@ -0,0 +1,2 @@
+invoker.goals = validate
+invoker.buildResult = success

modules/openapi-generator-maven-plugin/src/it/validate-harness/input-directory-merge/pom.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools.it</groupId>
+    <artifactId>input-directory-merge</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>@project.version@</version>
+                <executions>
+                    <execution>
+                        <phase>validate</phase>
+                        <goals>
+                            <goal>validate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpecRootDirectory>${project.basedir}/specs</inputSpecRootDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

modules/openapi-generator-maven-plugin/src/it/validate-harness/input-directory-merge/specs/part1.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+info:
+  title: Part 1
+  version: 1.0.0
+paths:
+  /part1:
+    get:
+      responses:
+        '200':
+          description: OK

modules/openapi-generator-maven-plugin/src/it/validate-harness/input-directory-merge/specs/part2.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+info:
+  title: Part 2
+  version: 1.0.0
+paths:
+  /part2:
+    get:
+      responses:
+        '200':
+          description: OK

modules/openapi-generator-maven-plugin/src/it/validate-harness/multi-file-xml-list/api_first.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+info:
+  title: First XML API Element
+  version: 1.0.0
+paths:
+  /first:
+    get:
+      responses:
+        '200':
+          description: OK

modules/openapi-generator-maven-plugin/src/it/validate-harness/multi-file-xml-list/api_second.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+info:
+  title: Second XML API Element
+  version: 1.0.0
+paths:
+  /second:
+    get:
+      responses:
+        '200':
+          description: OK

modules/openapi-generator-maven-plugin/src/it/validate-harness/multi-file-xml-list/invoker.properties

@@ -0,0 +1,2 @@
+invoker.goals = validate
+invoker.buildResult = success

modules/openapi-generator-maven-plugin/src/it/validate-harness/multi-file-xml-list/pom.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools.it</groupId>
+    <artifactId>multi-file-xml-list</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>@project.version@</version>
+                <executions>
+                    <execution>
+                        <phase>validate</phase>
+                        <goals>
+                            <goal>validate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>
+                                <param>api_first.yaml</param>
+                                <param>api_second.yaml</param>
+                            </inputSpec>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

modules/openapi-generator-maven-plugin/src/it/validate-harness/strict-spec-failure/invalid_api.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+info:
+  title: Completely Broken Spec
+  # Missing required 'version' field!
+paths:
+  /broken-endpoint:
+    get:
+      responses:
+        # Invalid response code type syntax or completely missing details
+        'invalid_code':

modules/openapi-generator-maven-plugin/src/it/validate-harness/strict-spec-failure/invoker.properties

@@ -0,0 +1,3 @@
+invoker.goals = validate
+# Mandate that the plugin properly drops the build execution lifecycle hammer!
+invoker.buildResult = failure

modules/openapi-generator-maven-plugin/src/it/validate-harness/strict-spec-failure/pom.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools.it</groupId>
+    <artifactId>strict-spec-failure</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>@project.version@</version>
+                <executions>
+                    <execution>
+                        <phase>validate</phase>
+                        <goals>
+                            <goal>validate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>invalid_api.yaml</inputSpec>
+                            <strictSpec>true</strictSpec> </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

modules/openapi-generator-maven-plugin/src/it/validate-harness/strict-spec-failure/verify.groovy

@@ -0,0 +1,16 @@
+import java.io.*
+
+// 1. Locate the build log file
+File logFile = new File(basedir, "build.log")
+assert logFile.exists() : "The build.log file was not found!"
+
+String logContent = logFile.text
+
+// 2. Assert the true root cause strings
+// Check for the exact exception message thrown by the Mojo wrapper
+assert logContent.contains("Validation has error(s). See above for the details.") : "Build failed, but not due to the expected validation exception wrapper!"
+
+// Check for the swagger/openapi parser's structural complaint about our broken yaml
+assert logContent.contains("attribute info.version is missing") || logContent.contains("missing") : "The logs do not contain the specific OpenAPI specification structural violations!"
+
+return true