This maven plugin allows to validate yaml and json files.
<plugin>
<groupId>com.github.sylvainlaurent.maven</groupId>
<artifactId>swagger-validator-maven-plugin</artifactId>
<version>...</version>
<executions>
<execution>
<id>validate</id>
<phase>validate</phase>
<goals>
<goal>validate</goal>
</goals>
<configuration>
<failOnErrors>true</failOnErrors>
<includes>
<include>src/main/resources/swagger-*.yml</include>
<include>src/main/resources/swagger-*.json</include>
<!-- other <include> may be added -->
</includes>
<excludes>
<exclude>src/main/resources/swagger-do-not-validate*.yml</exclude>
<!-- <exclude> is optional, others may be added -->
</excludes>
<!-- package names where custom validators are located -->
<customModelValidatorsPackage>com.example.validators</customValidatorsPackage>
<customPathValidatorsPackage>com.example.validators</customPathValidatorsPackage>
</configuration>
</execution>
</executions>
<dependencies>
<!-- dependency with custom validators -->
<dependency>
<groupId>com.example</groupId>
<artifactId>custom-validators</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</plugin>
Validation failures make the build fail but default. You can change this by setting <failOnErrors>false</failOnErrors>
.
You can add your custom validators and provide plugin with them. Extend from ModelValidatorTemplate or PathValidatorTemplate classes for writing your validators and override necessary validation methods. See ReferenceValidator and PathValidator as examples.
Requires java 1.8.
The source code is available on GitHub : https://github.com/sylvainlaurent/swagger-validator-maven-plugin
Use Maven and a JDK >=8, and run mvn clean verify
in the root directory of the git repository.
mvn release:prepare release:perform
and answer the questions about version number.
Then push the commits and tags to github.
This software is licensed under the Apache Sotware License version 2.0, see LICENSE.txt.