pact_broker-client 1.41.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b929ba48b8f21f7cafeb339e925fac9ecf7a4a83cd3392f5170c769c725998c3
-  data.tar.gz: 1b50eef690671dfdf9a78f1bb8da0f2f1e58cf380b199a554b5a9e770d40a825
+  metadata.gz: fde8c782e40832e6e989a59a78e0bdedf62d117ceb4e44d322fe38e3911ff714
+  data.tar.gz: be91210f775ccf15d2bf49a2cecf3aebf1fc68133b87b5343224d75153b28254
 SHA512:
-  metadata.gz: e527702e1d7d9cc3644f3c4db48c7e02060435699b0104f9048ab6142228475405fac9abea025c713bbf8a3a15b71660a56973515b72464814ff8dee62518289
-  data.tar.gz: 0b81d80a4ab02de7f7d71a7e5c991a6e322731c1803c7c85fd0b53379d92f4739e3296c0acd76cf528567b14147fb3743c352322104da46e4064116bc531514b
+  metadata.gz: 31ec264efd314d6cc03059f2eddfc5f0a842055e79c3d68fcbe20896619b6469aad06aa57e26c60585727d94443d7f5fd6e11626c14775e0dadb7fba63afbbe8
+  data.tar.gz: 1b78604dfa9f2860523432eea37d4943b7f222b685238ca60d0a8605e87afd42398f02568ddfd35ee330e3b055738db07a3331e800bc4ef839e63a1e2f6c26e5

data/.github/workflows/test.yml

@@ -21,3 +21,24 @@ jobs:
           ruby-version: ${{ matrix.ruby_version }}
       - run: "bundle install"
       - run: "bundle exec rake"
+  pact:
+    runs-on: "ubuntu-latest"
+    continue-on-error: true
+    strategy:
+      fail-fast: false
+      matrix:
+        feature: ["", "publish_contracts", "deployments"]
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "2.7"
+      - run: "bundle install"
+      - run: |
+          rm -rf spec/pacts/*
+          bundle exec rspec spec/service_providers/
+          bundle exec rake pact:publish:pactflow
+        env:
+          PACT_BROKER_TOKEN: ${{ secrets.PACTFLOW_PACT_OSS_TOKEN }}
+          PACT_BROKER_FEATURES: ${{ matrix.feature }}
+          TEST_FEATURE: ${{ matrix.feature }}

data/CHANGELOG.md

@@ -1,3 +1,60 @@
+<a name="v1.46.0"></a>
+### v1.46.0 (2021-06-24)
+
+#### Features
+
+* support specifying team UUID when creating a webhook in Pactflow	 ([c4201e1](/../../commit/c4201e1))
+
+<a name="v1.45.0"></a>
+### v1.45.0 (2021-06-16)
+
+#### Features
+
+* **can-i-deploy**
+  * allow dry-run to be enabled by setting ACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true	 ([0562436](/../../commit/0562436))
+  * add --dry-run option	 ([9d90c79](/../../commit/9d90c79))
+
+* add record-support-ended (feature toggled off)	 ([8f6b593](/../../commit/8f6b593))
+* update record-undeployment (feature toggled off)	 ([0c0dd15](/../../commit/0c0dd15))
+* update record-undeployment (feature toggled off)	 ([93046d5](/../../commit/93046d5))
+
+<a name="v1.44.0"></a>
+### v1.44.0 (2021-06-09)
+
+#### Features
+
+* add record-undeployment (feature toggled off)	 ([951d334](/../../commit/951d334))
+* add describe-environment command	 ([cd11ebb](/../../commit/cd11ebb))
+* add record-release (feature toggled off)	 ([e32e4e5](/../../commit/e32e4e5))
+
+#### Bug Fixes
+
+* hardcode file requires Fixes: https://github.com/pact-foundation/pact_broker-client/issues/88	 ([581f2fd](/../../commit/581f2fd))
+
+<a name="v1.43.0"></a>
+### v1.43.0 (2021-06-03)
+
+#### Features
+
+* enable --ignore option for can-i-deploy without a feature toggle	 ([bcc9dfe](/../../commit/bcc9dfe))
+
+<a name="v1.42.0"></a>
+### v1.42.0 (2021-05-31)
+
+#### Features
+
+* add list-pacticipants	 ([fc8ce3b](/../../commit/fc8ce3b))
+* add --display-name to create-or-update-pacticipant	 ([76f323b](/../../commit/76f323b))
+* add backtrace to error output when verbose is true	 ([abf1ef0](/../../commit/abf1ef0))
+* add list-environments and describe-environment	 ([4472d48](/../../commit/4472d48))
+* add delete-environment	 ([361eed1](/../../commit/361eed1))
+* add update-environment command	 ([95276cd](/../../commit/95276cd))
+* add create-environment command	 ([a9fab50](/../../commit/a9fab50))
+
+#### Bug Fixes
+
+* stop long values in columns from being truncated	 ([18063fd](/../../commit/18063fd))
+
 <a name="v1.41.0"></a>
 ### v1.41.0 (2021-05-25)
 

data/README.md

@@ -78,28 +78,45 @@ Usage:
   pact-broker can-i-deploy -a, --pacticipant=PACTICIPANT -b, --broker-base-url=BROKER_BASE_URL
 
 Options:
-  -a, --pacticipant=PACTICIPANT            # The pacticipant name. Use once for each pacticipant being checked.
-  -e, [--version=VERSION]                  # The pacticipant version. Must be entered after the --pacticipant that it relates to.
-  -l, [--latest=[TAG]]                     # Use the latest pacticipant version. Optionally specify a TAG to use the latest version with the specified tag.
-      [--to=TAG]                           # This is too hard to explain in a short sentence. Look at the examples.
-  -b, --broker-base-url=BROKER_BASE_URL    # The base URL of the Pact Broker
-  -u, [--broker-username=BROKER_USERNAME]  # Pact Broker basic auth username
-  -p, [--broker-password=BROKER_PASSWORD]  # Pact Broker basic auth password
-  -k, [--broker-token=BROKER_TOKEN]        # Pact Broker bearer token
-  -o, [--output=OUTPUT]                    # json or table
-                                           # Default: table
-  -v, [--verbose], [--no-verbose]          # Verbose output. Default: false
-      [--retry-while-unknown=TIMES]        # The number of times to retry while there is an unknown verification result (ie. the provider verification is likely still running)
-                                           # Default: 0
-      [--retry-interval=SECONDS]           # The time between retries in seconds. Use in conjuction with --retry-while-unknown
-                                           # Default: 10
-
-Description:
-  Returns exit code 0 or 1, indicating whether or not the specified pacticipant versions are compatible. Prints out the relevant
-  pact/verification details.
-
-  The environment variables PACT_BROKER_BASE_URL, PACT_BROKER_BASE_URL_USERNAME and PACT_BROKER_BASE_URL_PASSWORD may be used
-  instead of their respective command line options.
+  -a, --pacticipant=PACTICIPANT
+                # The pacticipant name. Use once for each pacticipant being checked.
+  -e, [--version=VERSION]
+                # The pacticipant version. Must be entered after the --pacticipant that it relates to.
+      [--ignore=IGNORE]
+                # The pacticipant name to ignore. Use once for each pacticipant being ignored.
+                A specific version can be ignored by also specifying a --version after the
+                pacticipant name option.
+  -l, [--latest=[TAG]]
+                # Use the latest pacticipant version. Optionally specify a TAG to use the
+                latest version with the specified tag.
+      [--to=TAG]
+                # This is too hard to explain in a short sentence. Look at the examples.
+  -o, [--output=OUTPUT]
+                # json or table
+
+                # Default: table
+      [--retry-while-unknown=TIMES]
+                # The number of times to retry while there is an unknown verification result
+                (ie. the provider verification is likely still running)
+
+                # Default: 0
+      [--retry-interval=SECONDS]
+                # The time between retries in seconds. Use in conjuction with --retry-while-unknown
+
+                # Default: 10
+      [--dry-run], [--no-dry-run]
+                # When enabled, always exits process with a success code. Can also be enabled by setting
+                the environment variable PACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true.
+  -b, --broker-base-url=BROKER_BASE_URL
+                # The base URL of the Pact Broker
+  -u, [--broker-username=BROKER_USERNAME]
+                # Pact Broker basic auth username
+  -p, [--broker-password=BROKER_PASSWORD]
+                # Pact Broker basic auth password
+  -k, [--broker-token=BROKER_TOKEN]
+                # Pact Broker bearer token
+  -v, [--verbose], [--no-verbose]
+                # Verbose output. Default: false
 ```
 
 Returns exit code 0 or 1, indicating whether or not the specified application (pacticipant) versions are compatible (ie. safe to deploy). Prints out the relevant pact/verification details, indicating any missing or failed verification results.
@@ -218,27 +235,19 @@ Usage:
 
 Options:
   -X, --request=METHOD
-            # HTTP method
+            # Webhook HTTP method
   -H, [--header=one two three]
-            # Header
+            # Webhook Header
   -d, [--data=DATA]
-            # Data
+            # Webhook payload (file or string)
   -u, [--user=USER]
-            # Basic auth username and password eg. username:password
+            # Webhook basic auth username and password eg. username:password
       [--consumer=CONSUMER]
             # Consumer name
       [--provider=PROVIDER]
             # Provider name
-  -b, --broker-base-url=BROKER_BASE_URL
-            # The base URL of the Pact Broker
-      [--broker-username=BROKER_USERNAME]
-            # Pact Broker basic auth username
-  -p, [--broker-password=BROKER_PASSWORD]
-            # Pact Broker basic auth password
-  -k, [--broker-token=BROKER_TOKEN]
-            # Pact Broker bearer token
       [--description=DESCRIPTION]
-            # The description of the webhook
+            # Webhook description
       [--contract-content-changed], [--no-contract-content-changed]
             # Trigger this webhook when the pact content changes
       [--contract-published], [--no-contract-published]
@@ -249,6 +258,16 @@ Options:
             # Trigger this webhook when a failed provider verification result is published
       [--provider-verification-succeeded], [--no-provider-verification-succeeded]
             # Trigger this webhook when a successful provider verification result is published
+      [--team-uuid=UUID]
+            # UUID of the Pactflow team to which the webhook should be assigned (Pactflow only)
+  -b, --broker-base-url=BROKER_BASE_URL
+            # The base URL of the Pact Broker
+  -u, [--broker-username=BROKER_USERNAME]
+            # Pact Broker basic auth username
+  -p, [--broker-password=BROKER_PASSWORD]
+            # Pact Broker basic auth password
+  -k, [--broker-token=BROKER_TOKEN]
+            # Pact Broker bearer token
   -v, [--verbose], [--no-verbose]
             # Verbose output. Default: false
 
@@ -266,27 +285,19 @@ Usage:
 
 Options:
   -X, --request=METHOD
-            # HTTP method
+            # Webhook HTTP method
   -H, [--header=one two three]
-            # Header
+            # Webhook Header
   -d, [--data=DATA]
-            # Data
+            # Webhook payload (file or string)
   -u, [--user=USER]
-            # Basic auth username and password eg. username:password
+            # Webhook basic auth username and password eg. username:password
       [--consumer=CONSUMER]
             # Consumer name
       [--provider=PROVIDER]
             # Provider name
-  -b, --broker-base-url=BROKER_BASE_URL
-            # The base URL of the Pact Broker
-      [--broker-username=BROKER_USERNAME]
-            # Pact Broker basic auth username
-  -p, [--broker-password=BROKER_PASSWORD]
-            # Pact Broker basic auth password
-  -k, [--broker-token=BROKER_TOKEN]
-            # Pact Broker bearer token
       [--description=DESCRIPTION]
-            # The description of the webhook
+            # Webhook description
       [--contract-content-changed], [--no-contract-content-changed]
             # Trigger this webhook when the pact content changes
       [--contract-published], [--no-contract-published]
@@ -297,6 +308,16 @@ Options:
             # Trigger this webhook when a failed provider verification result is published
       [--provider-verification-succeeded], [--no-provider-verification-succeeded]
             # Trigger this webhook when a successful provider verification result is published
+      [--team-uuid=UUID]
+            # UUID of the Pactflow team to which the webhook should be assigned (Pactflow only)
+  -b, --broker-base-url=BROKER_BASE_URL
+            # The base URL of the Pact Broker
+  -u, [--broker-username=BROKER_USERNAME]
+            # Pact Broker basic auth username
+  -p, [--broker-password=BROKER_PASSWORD]
+            # Pact Broker basic auth password
+  -k, [--broker-token=BROKER_TOKEN]
+            # Pact Broker bearer token
   -v, [--verbose], [--no-verbose]
             # Verbose output. Default: false
       --uuid=UUID

data/doc/pacts/markdown/Pact Broker Client - Pact Broker.md

@@ -30,8 +30,6 @@
 
 * [A request for the index resource](#a_request_for_the_index_resource_given_the_pb:pacticipant-version_relation_exists_in_the_index_resource) given the pb:pacticipant-version relation exists in the index resource
 
-* [A request for the index resource](#a_request_for_the_index_resource_given_the_pb:publish-contracts_relations_exists_in_the_index_resource) given the pb:publish-contracts relations exists in the index resource
-
 * [A request for the index resource with the webhook relation](#a_request_for_the_index_resource_with_the_webhook_relation)
 
 * [A request for the list of the latest pacts from all consumers for the Pricing Service'](#a_request_for_the_list_of_the_latest_pacts_from_all_consumers_for_the_Pricing_Service'_given_a_latest_pact_between_Condor_and_the_Pricing_Service_exists) given a latest pact between Condor and the Pricing Service exists
@@ -66,6 +64,8 @@
 
 * [A request to create a webhook with every possible event type](#a_request_to_create_a_webhook_with_every_possible_event_type_given_the_'Pricing_Service'_and_'Condor'_already_exist_in_the_pact-broker) given the 'Pricing Service' and 'Condor' already exist in the pact-broker
 
+* [A request to determine if Bar can be deployed with all Foo tagged prod, ignoring the verification for Foo version 3.4.5](#a_request_to_determine_if_Bar_can_be_deployed_with_all_Foo_tagged_prod,_ignoring_the_verification_for_Foo_version_3.4.5_given_provider_Bar_version_4.5.6_has_a_successful_verification_for_Foo_version_1.2.3_tagged_prod_and_a_failed_verification_for_version_3.4.5_tagged_prod) given provider Bar version 4.5.6 has a successful verification for Foo version 1.2.3 tagged prod and a failed verification for version 3.4.5 tagged prod
+
 * [A request to get the Pricing Service](#a_request_to_get_the_Pricing_Service_given_the_'Pricing_Service'_already_exists_in_the_pact-broker) given the 'Pricing Service' already exists in the pact-broker
 
 * [A request to get the Pricing Service](#a_request_to_get_the_Pricing_Service_given_the_'Pricing_Service'_does_not_exist_in_the_pact-broker) given the 'Pricing Service' does not exist in the pact-broker
@@ -84,8 +84,6 @@
 
 * [A request to publish a pact with method put](#a_request_to_publish_a_pact_with_method_put_given_the_'Pricing_Service'_and_'Condor'_already_exist_in_the_pact-broker,_and_Condor_already_has_a_pact_published_for_version_1.3.0) given the 'Pricing Service' and 'Condor' already exist in the pact-broker, and Condor already has a pact published for version 1.3.0
 
-* [A request to publish contracts](#a_request_to_publish_contracts)
-
 * [A request to register the repository URL of a pacticipant](#a_request_to_register_the_repository_URL_of_a_pacticipant_given_the_'Pricing_Service'_already_exists_in_the_pact-broker) given the 'Pricing Service' already exists in the pact-broker
 
 * [A request to register the repository URL of a pacticipant](#a_request_to_register_the_repository_URL_of_a_pacticipant_given_the_'Pricing_Service'_does_not_exist_in_the_pact-broker) given the 'Pricing Service' does not exist in the pact-broker
@@ -683,33 +681,6 @@ Pact Broker will respond with:
   }
 }
 ```
-<a name="a_request_for_the_index_resource_given_the_pb:publish-contracts_relations_exists_in_the_index_resource"></a>
-Given **the pb:publish-contracts relations exists in the index resource**, upon receiving **a request for the index resource** from Pact Broker Client, with
-```json
-{
-  "method": "GET",
-  "path": "/",
-  "headers": {
-    "Accept": "application/hal+json"
-  }
-}
-```
-Pact Broker will respond with:
-```json
-{
-  "status": 200,
-  "headers": {
-    "Content-Type": "application/hal+json;charset=utf-8"
-  },
-  "body": {
-    "_links": {
-      "pb:publish-contracts": {
-        "href": "http://localhost:1234/HAL-REL-PLACEHOLDER-PB-PUBLISH-CONTRACTS"
-      }
-    }
-  }
-}
-```
 <a name="a_request_for_the_index_resource_with_the_webhook_relation"></a>
 Upon receiving **a request for the index resource with the webhook relation** from Pact Broker Client, with
 ```json
@@ -1454,6 +1425,83 @@ Pact Broker will respond with:
   }
 }
 ```
+<a name="a_request_to_determine_if_Bar_can_be_deployed_with_all_Foo_tagged_prod,_ignoring_the_verification_for_Foo_version_3.4.5_given_provider_Bar_version_4.5.6_has_a_successful_verification_for_Foo_version_1.2.3_tagged_prod_and_a_failed_verification_for_version_3.4.5_tagged_prod"></a>
+Given **provider Bar version 4.5.6 has a successful verification for Foo version 1.2.3 tagged prod and a failed verification for version 3.4.5 tagged prod**, upon receiving **a request to determine if Bar can be deployed with all Foo tagged prod, ignoring the verification for Foo version 3.4.5** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/matrix",
+  "query": "q%5B%5D%5Bpacticipant%5D=Bar&q%5B%5D%5Bversion%5D=4.5.6&q%5B%5D%5Bpacticipant%5D=Foo&q%5B%5D%5Btag%5D=prod&latestby=cvpv&ignore%5B%5D%5Bpacticipant%5D=Foo&ignore%5B%5D%5Bversion%5D=3.4.5"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/hal+json;charset=utf-8"
+  },
+  "body": {
+    "summary": {
+      "deployable": true,
+      "ignored": 1
+    },
+    "notices": [
+      {
+        "text": "some notice",
+        "type": "info"
+      }
+    ],
+    "matrix": [
+      {
+        "consumer": {
+          "name": "Foo",
+          "version": {
+            "number": "1.2.3"
+          }
+        },
+        "provider": {
+          "name": "Bar",
+          "version": {
+            "number": "4.5.6"
+          }
+        },
+        "verificationResult": {
+          "success": true,
+          "_links": {
+            "self": {
+              "href": "http://result"
+            }
+          }
+        }
+      },
+      {
+        "consumer": {
+          "name": "Foo",
+          "version": {
+            "number": "3.4.5"
+          }
+        },
+        "provider": {
+          "name": "Bar",
+          "version": {
+            "number": "4.5.6"
+          }
+        },
+        "verificationResult": {
+          "success": false,
+          "_links": {
+            "self": {
+              "href": "http://result"
+            }
+          }
+        },
+        "ignored": true
+      }
+    ]
+  }
+}
+```
 <a name="a_request_to_get_the_Pricing_Service_given_the_&#39;Pricing_Service&#39;_already_exists_in_the_pact-broker"></a>
 Given **the 'Pricing Service' already exists in the pact-broker**, upon receiving **a request to get the Pricing Service** from Pact Broker Client, with
 ```json
@@ -1806,76 +1854,6 @@ Pact Broker will respond with:
   }
 }
 ```
-<a name="a_request_to_publish_contracts"></a>
-Upon receiving **a request to publish contracts** from Pact Broker Client, with
-```json
-{
-  "method": "POST",
-  "path": "/HAL-REL-PLACEHOLDER-PB-PUBLISH-CONTRACTS",
-  "headers": {
-    "Content-Type": "application/json",
-    "Accept": "application/hal+json"
-  },
-  "body": {
-    "pacticipantName": "Foo",
-    "pacticipantVersionNumber": "5556b8149bf8bac76bc30f50a8a2dd4c22c85f30",
-    "branch": "main",
-    "tags": [
-      "dev"
-    ],
-    "buildUrl": "http://build",
-    "contracts": [
-      {
-        "consumerName": "Foo",
-        "providerName": "Bar",
-        "specification": "pact",
-        "contentType": "application/json",
-        "content": "eyJjb25zdW1lciI6eyJuYW1lIjoiRm9vIn0sInByb3ZpZGVyIjp7Im5hbWUiOiJCYXIifSwiaW50ZXJhY3Rpb25zIjpbeyJkZXNjcmlwdGlvbiI6ImFuIGV4YW1wbGUgcmVxdWVzdCIsInByb3ZpZGVyU3RhdGUiOiJhIHByb3ZpZGVyIHN0YXRlIiwicmVxdWVzdCI6eyJtZXRob2QiOiJHRVQiLCJwYXRoIjoiLyIsImhlYWRlcnMiOnt9fSwicmVzcG9uc2UiOnsic3RhdHVzIjoyMDAsImhlYWRlcnMiOnsiQ29udGVudC1UeXBlIjoiYXBwbGljYXRpb24vaGFsK2pzb24ifX19XSwibWV0YWRhdGEiOnsicGFjdFNwZWNpZmljYXRpb24iOnsidmVyc2lvbiI6IjIuMC4wIn19fQ==",
-        "writeMode": "overwrite",
-        "onConflict": "overwrite"
-      }
-    ]
-  }
-}
-```
-Pact Broker will respond with:
-```json
-{
-  "status": 200,
-  "headers": {
-    "Content-Type": "application/hal+json;charset=utf-8"
-  },
-  "body": {
-    "_embedded": {
-      "pacticipant": {
-        "name": "Foo"
-      },
-      "version": {
-        "number": "5556b8149bf8bac76bc30f50a8a2dd4c22c85f30",
-        "buildUrl": "http://build"
-      }
-    },
-    "logs": [
-      {
-        "level": "info",
-        "message": "some message"
-      }
-    ],
-    "_links": {
-      "pb:pacticipant-version-tags": [
-        {
-          "name": "dev"
-        }
-      ],
-      "pb:contracts": [
-        {
-          "href": "http://some-pact"
-        }
-      ]
-    }
-  }
-}
-```
 <a name="a_request_to_register_the_repository_URL_of_a_pacticipant_given_the_&#39;Pricing_Service&#39;_already_exists_in_the_pact-broker"></a>
 Given **the 'Pricing Service' already exists in the pact-broker**, upon receiving **a request to register the repository URL of a pacticipant** from Pact Broker Client, with
 ```json
@@ -2286,7 +2264,6 @@ Given **the 'Pricing Service' and 'Condor' already exist in the pact-broker**, u
       }
     ],
     "request": {
-      "url": null,
       "method": "POST",
       "headers": {
         "Foo": "bar",