feat: Update Gradle and Maven readmes #998

Author: Ronald Holshausen

provider/pact-jvm-provider-gradle/README.md

@@ -328,16 +328,17 @@ The following project properties can be specified with `-Pproperty=value` on the
 
 |Property|Description|
 |--------|-----------|
-|pact.showStacktrace|This turns on stacktrace printing for each request. It can help with diagnosing network errors|
-|pact.showFullDiff|This turns on displaying the full diff of the expected versus actual bodies|
-|pact.filter.consumers|Comma seperated list of consumer names to verify|
-|pact.filter.description|Only verify interactions whose description match the provided regular expression|
-|pact.filter.providerState|Only verify interactions whose provider state match the provided regular expression. An empty string matches interactions that have no state|
-|pact.verifier.publishResults|Publishing of verification results will be skipped unless this property is set to 'true'|
-|pact.matching.wildcard|Enables matching of map values ignoring the keys when this property is set to 'true'|
-|pact.verifier.disableUrlPathDecoding|Disables decoding of request paths|
-|pact.pactbroker.httpclient.usePreemptiveAuthentication|Enables preemptive authentication with the pact broker when set to `true`|
-|pact.provider.tag|Sets the provider tag to push before publishing verification results|
+|`pact.showStacktrace`|This turns on stacktrace printing for each request. It can help with diagnosing network errors|
+|`pact.showFullDiff`|This turns on displaying the full diff of the expected versus actual bodies|
+|`pact.filter.consumers`|Comma seperated list of consumer names to verify|
+|`pact.filter.description`|Only verify interactions whose description match the provided regular expression|
+|`pact.filter.providerState`|Only verify interactions whose provider state match the provided regular expression. An empty string matches interactions that have no state|
+|`pact.filter.pacturl`|This filter allows just the just the changed pact specified in a webhook to be run. It should be used in conjunction with `pact.filter.consumers` |
+|`pact.verifier.publishResults`|Publishing of verification results will be skipped unless this property is set to 'true'|
+|`pact.matching.wildcard`|Enables matching of map values ignoring the keys when this property is set to 'true'|
+|`pact.verifier.disableUrlPathDecoding`|Disables decoding of request paths|
+|`pact.pactbroker.httpclient.usePreemptiveAuthentication`|Enables preemptive authentication with the pact broker when set to `true`|
+|`pact.provider.tag`|Sets the provider tag to push before publishing verification results|
 
 ## Provider States
 
@@ -574,6 +575,20 @@ pact {
 
 Preemptive Authentication can be enabled by setting the `pact.pactbroker.httpclient.usePreemptiveAuthentication` property to `true`.
 
+### Allowing just the changed pact specified in a webhook to be verified [4.0.6+]
+
+When a consumer publishes a new version of a pact file, the Pact broker can fire off a webhook with the URL of the changed 
+pact file. To allow only the changed pact file to be verified, you can override the URL by using the `pact.filter.consumers`
+and `pact.filter.pacturl` project properties.
+
+For example, running:
+
+```console
+gradle pactVerify -Ppact.filter.consumers='Foo Web Client' -Ppact.filter.pacturl=https://test.pact.dius.com.au/pacts/provider/Activity%20Service/consumer/Foo%20Web%20Client/version/1.0.1
+```  
+
+will only run the verification for Foo Web Client with the given pact file URL.
+
 ## Verifying pact files from a S3 bucket
 
 Pact files stored in an S3 bucket can be verified by using an S3 URL to the pact file. I.e.,

provider/pact-jvm-provider-maven/README.md

@@ -247,15 +247,16 @@ The following plugin properties can be specified with `-Dproperty=value` on the
 
 |Property|Description|
 |--------|-----------|
-|pact.showStacktrace|This turns on stacktrace printing for each request. It can help with diagnosing network errors|
-|pact.showFullDiff|This turns on displaying the full diff of the expected versus actual bodies|
-|pact.filter.consumers|Comma separated list of consumer names to verify|
-|pact.filter.description|Only verify interactions whose description match the provided regular expression|
-|pact.filter.providerState|Only verify interactions whose provider state match the provided regular expression. An empty string matches interactions that have no state|
-|pact.verifier.publishResults|Publishing of verification results will be skipped unless this property is set to `true` [version 3.5.18+]|
-|pact.matching.wildcard|Enables matching of map values ignoring the keys when this property is set to `true`|
-|pact.verifier.disableUrlPathDecoding|Disables decoding of request paths|
-|pact.pactbroker.httpclient.usePreemptiveAuthentication|Enables preemptive authentication with the pact broker when set to `true`|
+|`pact.showStacktrace`|This turns on stacktrace printing for each request. It can help with diagnosing network errors|
+|`pact.showFullDiff`|This turns on displaying the full diff of the expected versus actual bodies|
+|`pact.filter.consumers`|Comma separated list of consumer names to verify|
+|`pact.filter.description`|Only verify interactions whose description match the provided regular expression|
+|`pact.filter.providerState`|Only verify interactions whose provider state match the provided regular expression. An empty string matches interactions that have no state|
+|`pact.filter.pacturl`|This filter allows just the just the changed pact specified in a webhook to be run. It should be used in conjunction with `pact.filter.consumers`|
+|`pact.verifier.publishResults`|Publishing of verification results will be skipped unless this property is set to `true` [version 3.5.18+]|
+|`pact.matching.wildcard`|Enables matching of map values ignoring the keys when this property is set to `true`|
+|`pact.verifier.disableUrlPathDecoding`|Disables decoding of request paths|
+|`pact.pactbroker.httpclient.usePreemptiveAuthentication`|Enables preemptive authentication with the pact broker when set to `true`|
 
 Example in the configuration section:
 
@@ -423,6 +424,20 @@ Here is how you configure the plugin to use bearer token authentication for veri
 Preemptive Authentication can be enabled by setting the `pact.pactbroker.httpclient.usePreemptiveAuthentication` Java
 system property to `true`.
 
+### Allowing just the changed pact specified in a webhook to be verified [4.0.6+]
+
+When a consumer publishes a new version of a pact file, the Pact broker can fire off a webhook with the URL of the changed 
+pact file. To allow only the changed pact file to be verified, you can override the URL by using the `pact.filter.consumers`
+and `pact.filter.pacturl` Java system properties.
+
+For example, running:
+
+```console
+mvn pact:verify -Dpact.filter.consumers='Foo Web Client' -Dpact.filter.pacturl=https://test.pact.dius.com.au/pacts/provider/Activity%20Service/consumer/Foo%20Web%20Client/version/1.0.1
+```  
+
+will only run the verification for Foo Web Client with the given pact file URL.
+
 #### Using the Maven servers configuration
 
 You can use the servers setup in the Maven settings. To do this, setup a server as per the