Fork me on GitHub

spring-cloud-contract:convert

Full name:

org.springframework.cloud:spring-cloud-contract-maven-plugin:2.0.0.RELEASE:convert

Description:

Convert Spring Cloud Contract Verifier contracts into WireMock stubs mappings.

This goal allows you to generate `stubs-jar` or execute `spring-cloud-contract:run` with generated WireMock mappings.

Attributes:

Optional Parameters

Name Type Since Description
contractDependency Dependency - (no description)
User property is: contractDependency.
contractsDirectory File - Directory containing Spring Cloud Contract Verifier contracts written using the GroovyDSL
Default value is: ${project.basedir}/src/test/resources/contracts.
User property is: spring.cloud.contract.verifier.contractsDirectory.
contractsMode StubRunnerProperties$StubsMode - Picks the mode in which stubs will be found and registered
Default value is: CLASSPATH.
User property is: contractsMode.
contractsPath String - The path in the JAR with all the contracts where contracts for this particular service lay. If not provided will be resolved to groupid/artifactid. Example:

If groupid is com.example and artifactid is service then the resolved path will be /com/example/artifactid
User property is: contractsPath.
contractsProperties Map - Map of properties that can be passed to custom StubDownloaderBuilder
User property is: contractsProperties.
contractsRepositoryPassword String - The password to be used to connect to the repo with contracts.
User property is: contractsRepositoryPassword.
contractsRepositoryProxyHost String - The proxy host to be used to connect to the repo with contracts.
User property is: contractsRepositoryProxyHost.
contractsRepositoryProxyPort Integer - The proxy port to be used to connect to the repo with contracts.
User property is: contractsRepositoryProxyPort.
contractsRepositoryUrl String - The URL from which a JAR containing the contracts should get downloaded. If not provided but artifactid / coordinates notation was provided then the current Maven's build repositories will be taken into consideration
User property is: contractsRepositoryUrl.
contractsRepositoryUsername String - The user name to be used to connect to the repo with contracts.
User property is: contractsRepositoryUsername.
contractsSnapshotCheckSkip boolean - If true then will not assert whether a stub / contract JAR was downloaded from local or remote location
Default value is: false.
User property is: contractsSnapshotCheckSkip.
deleteStubsAfterTest boolean - If set to false will NOT delete stubs from a temporary folder after running tests
Default value is: true.
User property is: deleteStubsAfterTest.
destination File - (no description)
Default value is: ${basedir}.
User property is: stubsDirectory.
excludeBuildFolders boolean - If true then any file laying in a path that contains build or target will get excluded in further processing.
Default value is: false.
User property is: excludeBuildFolders.
skip boolean - (no description)
Default value is: false.
User property is: spring.cloud.contract.verifier.skip.
source File - Directory containing contracts written using the GroovyDSL

This parameter is only used when goal is executed outside of maven project.


Default value is: ${basedir}.
User property is: contractsDirectory.
stubsDirectory File - Directory where the generated WireMock stubs from Groovy DSL should be placed. You can then mention them in your packaging task to create jar with stubs
Default value is: ${project.build.directory}/stubs/.

Parameter Details

contractDependency:

(no description)
  • Type: org.apache.maven.model.Dependency
  • Required: No
  • User Property: contractDependency

contractsDirectory:

Directory containing Spring Cloud Contract Verifier contracts written using the GroovyDSL
  • Type: java.io.File
  • Required: No
  • User Property: spring.cloud.contract.verifier.contractsDirectory
  • Default: ${project.basedir}/src/test/resources/contracts

contractsMode:

Picks the mode in which stubs will be found and registered
  • Type: org.springframework.cloud.contract.stubrunner.spring.StubRunnerProperties$StubsMode
  • Required: No
  • User Property: contractsMode
  • Default: CLASSPATH

contractsPath:

The path in the JAR with all the contracts where contracts for this particular service lay. If not provided will be resolved to groupid/artifactid. Example:

If groupid is com.example and artifactid is service then the resolved path will be /com/example/artifactid
  • Type: java.lang.String
  • Required: No
  • User Property: contractsPath

contractsProperties:

Map of properties that can be passed to custom StubDownloaderBuilder
  • Type: java.util.Map
  • Required: No
  • User Property: contractsProperties

contractsRepositoryPassword:

The password to be used to connect to the repo with contracts.
  • Type: java.lang.String
  • Required: No
  • User Property: contractsRepositoryPassword

contractsRepositoryProxyHost:

The proxy host to be used to connect to the repo with contracts.
  • Type: java.lang.String
  • Required: No
  • User Property: contractsRepositoryProxyHost

contractsRepositoryProxyPort:

The proxy port to be used to connect to the repo with contracts.
  • Type: java.lang.Integer
  • Required: No
  • User Property: contractsRepositoryProxyPort

contractsRepositoryUrl:

The URL from which a JAR containing the contracts should get downloaded. If not provided but artifactid / coordinates notation was provided then the current Maven's build repositories will be taken into consideration
  • Type: java.lang.String
  • Required: No
  • User Property: contractsRepositoryUrl

contractsRepositoryUsername:

The user name to be used to connect to the repo with contracts.
  • Type: java.lang.String
  • Required: No
  • User Property: contractsRepositoryUsername

contractsSnapshotCheckSkip:

If true then will not assert whether a stub / contract JAR was downloaded from local or remote location
  • Type: boolean
  • Required: No
  • User Property: contractsSnapshotCheckSkip
  • Default: false

deleteStubsAfterTest:

If set to false will NOT delete stubs from a temporary folder after running tests
  • Type: boolean
  • Required: No
  • User Property: deleteStubsAfterTest
  • Default: true

destination:

(no description)
  • Type: java.io.File
  • Required: No
  • User Property: stubsDirectory
  • Default: ${basedir}

excludeBuildFolders:

If true then any file laying in a path that contains build or target will get excluded in further processing.
  • Type: boolean
  • Required: No
  • User Property: excludeBuildFolders
  • Default: false

skip:

(no description)
  • Type: boolean
  • Required: No
  • User Property: spring.cloud.contract.verifier.skip
  • Default: false

source:

Directory containing contracts written using the GroovyDSL

This parameter is only used when goal is executed outside of maven project.

  • Type: java.io.File
  • Required: No
  • User Property: contractsDirectory
  • Default: ${basedir}

stubsDirectory:

Directory where the generated WireMock stubs from Groovy DSL should be placed. You can then mention them in your packaging task to create jar with stubs
  • Type: java.io.File
  • Required: No
  • Default: ${project.build.directory}/stubs/