This module is part of the Apache Sling project.
It provides additional Maven Enforcer rules.
Prerequisites: maven-enforcer-plugin
3.0.0 or newer
Checks that the runtime classpath (e.g. used by Maven Plugins via the Plugin Classloader or by the Appassembler Maven Plugin's assemble
goal) contains all provided dependencies.
As those are not transitively inherited they need to be declared explicitly in the pom.xml of the using Maven project.
The check assumes semantic versioning, i.e. for provided dependencies without a version range all compatible runtime dependencies are accepted (i.e. ones that share groupId, artifactId, classifier and extension, and have the same major version and minor version which is equal or higher to the one of the provided dependency.
All parameters are optional.
excludes
- a list of dependencies to skip. Their transitive dependencies are not evaluated either. The format is <groupId>[:<artifactId>[:<extension>[:<classifier>]]]
. Wild cards (*
) may be used to replace an entire part of a section. Examples:org.apache.maven
(everything with the given group)org.apache.maven:myArtifact
org.apache.maven:*:jar
includeOptionalDependencies
- whether to include optional dependencies in the check. Either true
or false
. By default no optional dependencies are checked.includeDirectDependencies
- whether to include direct (provided) dependencies in the check. Either true
or false
. By default no direct provided dependencies are checked, i.e. only transitive ones are considered.<project> [...] <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-enforcer-plugin</artifactId> <version>3.0.0</version> <dependencies> <dependency> <groupId>org.apache.sling</groupId> <artifactId>maven-enforcer-rules</artifactId> <version>LATEST</version> </dependency> </dependencies> <executions> <execution> <id>enforce-complete-runtime-classpath</id> <goals> <goal>enforce</goal> </goals> <configuration> <rules> <requireProvidedDependenciesInRuntimeClasspath implementation="org.apache.sling.maven.enforcer.RequireProvidedDependenciesInRuntimeClasspath"> <excludes> <exclude>javax.servlet:javax.servlet-api</exclude> </excludes> </requireProvidedDependenciesInRuntimeClasspath> </rules> </configuration> </execution> </executions> </plugin> </plugins> </build> [...] </project>
Checks that all dependencies have an explicitly declared scope in the non-effective pom (i.e. without taking inheritance or dependency management into account). Useful when the scope is no longer part of the dependencyManagement
or in general to force making developers a distinct decision (e.g. prevents the default scope compile being used for test dependencies by accident).
This rule does not support any parameters.
<project> [...] <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-enforcer-plugin</artifactId> <version>3.0.0</version> <dependencies> <dependency> <groupId>org.apache.sling</groupId> <artifactId>maven-enforcer-rules</artifactId> <version>LATEST</version> </dependency> </dependencies> <executions> <execution> <id>require-explicit-dependency-scope</id> <goals> <goal>enforce</goal> </goals> <configuration> <rules> <requireExplicitDependencyScope implementation="org.apache.sling.maven.enforcer.RequireExplicitDependencyScope" /> </rules> </configuration> </execution> </executions> </plugin> </plugins> </build> [...] </project>