pact_broker-client 1.51.0 → 1.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 854312863c664ff8f355fcab3d2cb3733bf7c229f75b98aa9f2f9187a93d5409
-  data.tar.gz: c02cfe9055664950a2811e3351c701431e5a6916a6a06e21e34aab14ee94520c
+  metadata.gz: d6662ad835f144252e2a6fd78f98e52b381794629dcbfb8085fa1acb0b28ece0
+  data.tar.gz: b0ec70c258bb01ae05801070596dbb02fe23a8f674d2bab53117c40b75a6d59f
 SHA512:
-  metadata.gz: d5be4a8a3fc89a6606aac689d9da2a335393d0ef8e0b01e7f09c5745798c475ff1b53be34b00284c00e0cadaffecd834a75d03cca9805c8b386e2c9f223af8ec
-  data.tar.gz: dc9192512acf2a696f635274b504042a960c8d3eded2ae7b07e17e1dc982de0badc177686fb62d9516d9976cc5d9a5fd9564b4d02bf47f6ad2bcc3e56576a590
+  metadata.gz: 0f20176d5773873c3cd9a41711a7d4405721f95017132702e6be84430a63baef7101aefcb2b43e05546536d974306c7677b529bd8c2d6e32701432de67e0fe44
+  data.tar.gz: b4fc4fa3bd5096b5281d98478cc59d8732a31c29ec7f959922c064193135fd613740220230449e2c5ea3b98611f555b372545549fd22fb52050cc7710a582023

data/CHANGELOG.md

@@ -1,3 +1,32 @@
+<a name="v1.53.0"></a>
+### v1.53.0 (2021-09-29)
+
+#### Features
+
+* allow pacts to be published using the old API by setting the environment variable PACT_BROKER_FEATURES=publish_pacts_using_old_api	 ([7c34132](/../../commit/7c34132))
+
+<a name="v1.52.0"></a>
+### v1.52.0 (2021-09-29)
+
+#### Features
+
+* rename target to application-instance for record-deployment and record-undeployment (backwards compatible)	 ([53d23eb](/../../commit/53d23eb))
+
+<a name="v1.51.2"></a>
+### v1.51.2 (2021-09-27)
+
+#### Bug Fixes
+
+* **deps**
+  * lock httparty to 0.18.1	 ([1ab2d9c](/../../commit/1ab2d9c))
+
+<a name="v1.51.1"></a>
+### v1.51.1 (2021-09-22)
+
+#### Bug Fixes
+
+* remove deprecated method of handling branches	 ([6d26487](/../../commit/6d26487))
+
 <a name="v1.51.0"></a>
 ### v1.51.0 (2021-09-22)
 

data/README.md

@@ -275,29 +275,33 @@ Usage:
   pact-broker record-deployment --environment=ENVIRONMENT -a, --pacticipant=PACTICIPANT -b, --broker-base-url=BROKER_BASE_URL -e, --version=VERSION
 
 Options:
-  -a, --pacticipant=PACTICIPANT            
+  -a, --pacticipant=PACTICIPANT                      
               # The name of the pacticipant that was deployed.
-  -e, --version=VERSION                    
+  -e, --version=VERSION                              
               # The pacticipant version number that was deployed.
-      --environment=ENVIRONMENT            
+      --environment=ENVIRONMENT                      
               # The name of the environment that the pacticipant version was
                 deployed to.
-      [--target=TARGET]                    
-              # Optional. The target of the deployment - a logical identifer
-                required to differentiate deployments when there are multiple
-                instances of the same application in an environment.
-  -o, [--output=OUTPUT]                    
+      [--application-instance=APPLICATION_INSTANCE]  
+              # Optional. The application instance to which the deployment has
+                occurred - a logical identifer required to differentiate
+                deployments when there are multiple instances of the same
+                application in an environment. This field was called 'target'
+                in a beta release.
+      [--target=TARGET]                              
+              # Renamed to application_instance
+  -o, [--output=OUTPUT]                              
               # json or text
               # Default: text
-  -b, --broker-base-url=BROKER_BASE_URL    
+  -b, --broker-base-url=BROKER_BASE_URL              
               # The base URL of the Pact Broker
-  -u, [--broker-username=BROKER_USERNAME]  
+  -u, [--broker-username=BROKER_USERNAME]            
               # Pact Broker basic auth username
-  -p, [--broker-password=BROKER_PASSWORD]  
+  -p, [--broker-password=BROKER_PASSWORD]            
               # Pact Broker basic auth password
-  -k, [--broker-token=BROKER_TOKEN]        
+  -k, [--broker-token=BROKER_TOKEN]                  
               # Pact Broker bearer token
-  -v, [--verbose], [--no-verbose]          
+  -v, [--verbose], [--no-verbose]                    
               # Verbose output. Default: false
 ```
 
@@ -310,28 +314,34 @@ Usage:
   pact-broker record-undeployment --environment=ENVIRONMENT -a, --pacticipant=PACTICIPANT -b, --broker-base-url=BROKER_BASE_URL
 
 Options:
-  -a, --pacticipant=PACTICIPANT            
+  -a, --pacticipant=PACTICIPANT                      
               # The name of the pacticipant that was undeployed.
-      --environment=ENVIRONMENT            
+      --environment=ENVIRONMENT                      
               # The name of the environment that the pacticipant version was
                 undeployed from.
-      [--target=TARGET]                    
+      [--application-instance=APPLICATION_INSTANCE]  
+              # Optional. The application instance from which the application
+                is being undeployed - a logical identifer required to
+                differentiate deployments when there are multiple instances of
+                the same application in an environment. This field was called
+                'target' in a beta release.
+      [--target=TARGET]                              
               # Optional. The target that the application is being undeployed
                 from - a logical identifer required to differentiate
                 deployments when there are multiple instances of the same
                 application in an environment.
-  -o, [--output=OUTPUT]                    
+  -o, [--output=OUTPUT]                              
               # json or text
               # Default: text
-  -b, --broker-base-url=BROKER_BASE_URL    
+  -b, --broker-base-url=BROKER_BASE_URL              
               # The base URL of the Pact Broker
-  -u, [--broker-username=BROKER_USERNAME]  
+  -u, [--broker-username=BROKER_USERNAME]            
               # Pact Broker basic auth username
-  -p, [--broker-password=BROKER_PASSWORD]  
+  -p, [--broker-password=BROKER_PASSWORD]            
               # Pact Broker basic auth password
-  -k, [--broker-token=BROKER_TOKEN]        
+  -k, [--broker-token=BROKER_TOKEN]                  
               # Pact Broker bearer token
-  -v, [--verbose], [--no-verbose]          
+  -v, [--verbose], [--no-verbose]                    
               # Verbose output. Default: false
 ```
 
@@ -469,8 +479,8 @@ Description:
   support for environments, deployments and releases. For documentation on how to use can-i-deploy with tags, please see
   https://docs.pact.io/pact_broker/client_cli/can_i_deploy_usage_with_tags/
 
-  Before `can-i-deploy` can be used, the relevant environment resources must first be created in the Pact Broker using the `create-environment` command. The "test"
-  and "production" environments will have been seeded for you. You can check the existing environments by running `pact-broker list-environments`. See
+  Before `can-i-deploy` can be used, the relevant environment resources must first be created in the Pact Broker using the `create-environment` command. The
+  "test" and "production" environments will have been seeded for you. You can check the existing environments by running `pact-broker list-environments`. See
   https://docs.pact.io/pact_broker/client_cli/readme#environments for more information.
 
   $ pact-broker create-environment --name "uat" --display-name "UAT" --no-production
@@ -480,8 +490,8 @@ Description:
 
   $ pact-broker record-deployment --pacticipant Foo --version 173153ae0 --environment uat
 
-  Before an application is deployed or released to an environment, the can-i-deploy command must be run to check that the application version is safe to deploy with
-  the versions of each integrated application that are already in that environment.
+  Before an application is deployed or released to an environment, the can-i-deploy command must be run to check that the application version is safe to deploy
+  with the versions of each integrated application that are already in that environment.
 
   $ pact-broker can-i-deploy --pacticipant PACTICIPANT --version VERSION --to-environment ENVIRONMENT
 
@@ -489,8 +499,8 @@ Description:
 
   $ pact-broker can-i-deploy --pacticipant Foo --version 173153ae0 --to-environment test
 
-  Can-i-deploy can also be used to check if arbitrary versions have a successful verification. When asking "Can I deploy this application version with the latest version
-  from the main branch of another application" it functions as a "can I merge" check.
+  Can-i-deploy can also be used to check if arbitrary versions have a successful verification. When asking "Can I deploy this application version with the
+  latest version from the main branch of another application" it functions as a "can I merge" check.
 
   $ pact-broker can-i-deploy --pacticipant Foo 173153ae0 \ --pacticipant Bar --latest main
 
@@ -628,8 +638,8 @@ Options:
 ```
 
 Description:
-  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-webhook" and add the consumer,
-  provider, event types and broker details. Note that the URL must be the first parameter when executing create-webhook.
+  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-webhook" and add the
+  consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-webhook.
 
   Note that the -u option from the curl command clashes with the -u option from the pact-broker CLI. When used in this command, the -u will be used as a curl
   option. Please use the --broker-username or environment variable for the Pact Broker username.
@@ -686,9 +696,9 @@ Options:
 ```
 
 Description:
-  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-or-update-webhook" and add the
-  consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-or-update-webhook and a uuid must
-  also be provided. You can generate a valid UUID by using the `generate-uuid` command.
+  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-or-update-webhook" and
+  add the consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-or-update-webhook and a uuid
+  must also be provided. You can generate a valid UUID by using the `generate-uuid` command.
 
   Note that the -u option from the curl command clashes with the -u option from the pact-broker CLI. When used in this command, the -u will be used as a curl
   option. Please use the --broker-username or environment variable for the Pact Broker username.

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

@@ -40,8 +40,6 @@
 
 * [A request for the index resource](#a_request_for_the_index_resource_given_the_pb:pacticipant-version_and_pb:environments_relations_exist_in_the_index_resource) given the pb:pacticipant-version and pb:environments relations exist in the index resource
 
-* [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)
@@ -58,10 +56,6 @@
 
 * [A request to create a pacticipant](#a_request_to_create_a_pacticipant)
 
-* [A request to create a pacticipant version](#a_request_to_create_a_pacticipant_version_given_version_26f353580936ad3b9baddb17b00e84f33c69e7cb_of_pacticipant_Foo_does_exist) given version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does exist
-
-* [A request to create a pacticipant version](#a_request_to_create_a_pacticipant_version_given_version_26f353580936ad3b9baddb17b00e84f33c69e7cb_of_pacticipant_Foo_does_not_exist) given version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does not exist
-
 * [A request to create a webhook for a consumer and provider](#a_request_to_create_a_webhook_for_a_consumer_and_provider_given_'Condor'_does_not_exist_in_the_pact-broker) given 'Condor' does not exist in the pact-broker
 
 * [A request to create a webhook with a JSON body and a uuid](#a_request_to_create_a_webhook_with_a_JSON_body_and_a_uuid_given_the_'Pricing_Service'_and_'Condor'_already_exist_in_the_pact-broker) given the 'Pricing Service' and 'Condor' already exist in the pact-broker
@@ -859,33 +853,6 @@ Pact Broker will respond with:
   }
 }
 ```
-<a name="a_request_for_the_index_resource_given_the_pb:pacticipant-version_relation_exists_in_the_index_resource"></a>
-Given **the pb:pacticipant-version relation 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:pacticipant-version": {
-        "href": "http://localhost:1234/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-{pacticipant}-{version}"
-      }
-    }
-  }
-}
-```
 <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
@@ -1165,74 +1132,6 @@ Pact Broker will respond with:
   }
 }
 ```
-<a name="a_request_to_create_a_pacticipant_version_given_version_26f353580936ad3b9baddb17b00e84f33c69e7cb_of_pacticipant_Foo_does_exist"></a>
-Given **version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does exist**, upon receiving **a request to create a pacticipant version** from Pact Broker Client, with
-```json
-{
-  "method": "put",
-  "path": "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-Foo-26f353580936ad3b9baddb17b00e84f33c69e7cb",
-  "headers": {
-    "Content-Type": "application/json",
-    "Accept": "application/hal+json"
-  },
-  "body": {
-    "branch": "main",
-    "buildUrl": "http://my-ci/builds/1"
-  }
-}
-```
-Pact Broker will respond with:
-```json
-{
-  "status": 200,
-  "headers": {
-    "Content-Type": "application/hal+json;charset=utf-8"
-  },
-  "body": {
-    "number": "26f353580936ad3b9baddb17b00e84f33c69e7cb",
-    "buildUrl": "http://my-ci/builds/1",
-    "_links": {
-      "self": {
-        "href": "http://localhost:1234/some-url"
-      }
-    }
-  }
-}
-```
-<a name="a_request_to_create_a_pacticipant_version_given_version_26f353580936ad3b9baddb17b00e84f33c69e7cb_of_pacticipant_Foo_does_not_exist"></a>
-Given **version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does not exist**, upon receiving **a request to create a pacticipant version** from Pact Broker Client, with
-```json
-{
-  "method": "put",
-  "path": "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-Foo-26f353580936ad3b9baddb17b00e84f33c69e7cb",
-  "headers": {
-    "Content-Type": "application/json",
-    "Accept": "application/hal+json"
-  },
-  "body": {
-    "branch": "main",
-    "buildUrl": "http://my-ci/builds/1"
-  }
-}
-```
-Pact Broker will respond with:
-```json
-{
-  "status": 201,
-  "headers": {
-    "Content-Type": "application/hal+json;charset=utf-8"
-  },
-  "body": {
-    "number": "26f353580936ad3b9baddb17b00e84f33c69e7cb",
-    "buildUrl": "http://my-ci/builds/1",
-    "_links": {
-      "self": {
-        "href": "http://localhost:1234/some-url"
-      }
-    }
-  }
-}
-```
 <a name="a_request_to_create_a_webhook_for_a_consumer_and_provider_given_&#39;Condor&#39;_does_not_exist_in_the_pact-broker"></a>
 Given **'Condor' does not exist in the pact-broker**, upon receiving **a request to create a webhook for a consumer and provider** from Pact Broker Client, with
 ```json
@@ -2230,6 +2129,7 @@ Given **version 5556b8149bf8bac76bc30f50a8a2dd4c22c85f30 of pacticipant Foo exis
     "Accept": "application/hal+json"
   },
   "body": {
+    "applicationInstance": "blue",
     "target": "blue"
   }
 }

data/lib/pact_broker/client/cli/deployment_commands.rb

@@ -14,16 +14,18 @@ module PactBroker
             method_option :pacticipant, required: true, aliases: "-a", desc: "The name of the pacticipant that was deployed."
             method_option :version, required: true, aliases: "-e", desc: "The pacticipant version number that was deployed."
             method_option :environment, required: true, desc: "The name of the environment that the pacticipant version was deployed to."
-            method_option :target, default: nil, required: false, desc: "Optional. The target of the deployment - a logical identifer required to differentiate deployments when there are multiple instances of the same application in an environment."
+            method_option :application_instance, default: nil, required: false, desc: "Optional. The application instance to which the deployment has occurred - a logical identifer required to differentiate deployments when there are multiple instances of the same application in an environment. This field was called 'target' in a beta release."
+            method_option :target, hidden: true, default: nil, required: false, desc: "Renamed to application_instance"
             output_option_json_or_text
             shared_authentication_options
 
             def record_deployment
+              $stderr.puts("WARN: target has been renamed to application-instance") if options.target
               params = {
                 pacticipant_name: options.pacticipant,
                 version_number: options.version,
                 environment_name: options.environment,
-                target: options.target
+                application_instance: options.application_instance || options.target
               }
               execute_deployment_command(params, "RecordDeployment")
             end
@@ -32,15 +34,17 @@ module PactBroker
             long_desc "Note that use of this command is only required if you are permanently removing an application instance from an environment. It is not required if you are deploying over a previous version, as record-deployment will automatically mark the previously deployed version as undeployed for you. See #{RECORD_UNDEPLOYMENT_HELP_URL} for more information."
             method_option :pacticipant, required: true, aliases: "-a", desc: "The name of the pacticipant that was undeployed."
             method_option :environment, required: true, desc: "The name of the environment that the pacticipant version was undeployed from."
+            method_option :application_instance, default: nil, required: false, desc: "Optional. The application instance from which the application is being undeployed - a logical identifer required to differentiate deployments when there are multiple instances of the same application in an environment. This field was called 'target' in a beta release."
             method_option :target, default: nil, required: false, desc: "Optional. The target that the application is being undeployed from - a logical identifer required to differentiate deployments when there are multiple instances of the same application in an environment."
             output_option_json_or_text
             shared_authentication_options
 
             def record_undeployment
+              $stderr.puts("WARN: target has been renamed to application-instance") if options.target
               params = {
                 pacticipant_name: options.pacticipant,
                 environment_name: options.environment,
-                target: options.target
+                application_instance: options.application_instance || options.target
               }
               execute_deployment_command(params, "RecordUndeployment")
             end

data/lib/pact_broker/client/deployments/record_deployment.rb

@@ -6,12 +6,12 @@ module PactBroker
       class RecordDeployment < PactBroker::Client::Deployments::RecordRelease
         def initialize(params, options, pact_broker_client_options)
           super
-          @target = params.fetch(:target)
+          @application_instance = params.fetch(:application_instance)
         end
 
         private
 
-        attr_reader :target
+        attr_reader :application_instance
 
         def action
           "deployment"
@@ -22,12 +22,13 @@ module PactBroker
         end
 
         def record_action_request_body
-          { target: target }.compact
+          # for backwards compatibility with old broker
+          { applicationInstance: application_instance, target: application_instance }.compact
         end
 
         def result_text_message
-          if target
-            "#{super} (target #{target})"
+          if application_instance
+            "#{super} (application instance #{application_instance})"
           else
             super
           end

data/lib/pact_broker/client/deployments/record_undeployment.rb

@@ -8,7 +8,7 @@ module PactBroker
           super
           @pacticipant_name = params.fetch(:pacticipant_name)
           @environment_name = params.fetch(:environment_name)
-          @target = params.fetch(:target)
+          @application_instance = params.fetch(:application_instance)
         end
 
         private
@@ -21,7 +21,7 @@ module PactBroker
           end
         end
 
-        attr_reader :pacticipant_name, :environment_name, :target
+        attr_reader :pacticipant_name, :environment_name, :application_instance
 
         def currently_deployed_versions_link
           environment_resource._link("pb:currently-deployed-deployed-versions", "pb:currently-deployed-versions") or raise PactBroker::Client::Error.new(not_supported_message)
@@ -31,14 +31,19 @@ module PactBroker
           @deployed_version_links ||= currently_deployed_versions_link.get!(pacticipant: pacticipant_name).embedded_entities!("deployedVersions")
         end
 
-        def currently_deployed_version_entities_for_pacticipant_and_target
+        def currently_deployed_version_entities_for_pacticipant_and_instance
           currently_deployed_version_entities_for_pacticipant.select do | entity |
-            entity.target == target
+            if application_instance
+              entity.applicationInstance == application_instance || entity.target == application_instance
+            else
+              entity.applicationInstance == nil && entity.target == nil
+            end
+
           end
         end
 
         def undeployed_versions_resources
-          @undeployed_versions_resources ||= currently_deployed_version_entities_for_pacticipant_and_target.collect do | entity |
+          @undeployed_versions_resources ||= currently_deployed_version_entities_for_pacticipant_and_instance.collect do | entity |
             entity._link!("self").patch(currentlyDeployed: false)
           end
         end
@@ -75,7 +80,7 @@ module PactBroker
           message = "Recorded #{action} of #{pacticipant_name}"
           message = "#{message} version #{version.number}" if (version && version.number)
           message = "#{message} from #{environment_name} environment"
-          message = "#{message} (target #{target})" if target
+          message = "#{message} (application instance #{application_instance})" if application_instance
           message
         end
 
@@ -92,19 +97,22 @@ module PactBroker
             "No pacticipant with name '#{pacticipant_name}' found."
           else
             if currently_deployed_version_entities_for_pacticipant.any?
-              target_does_not_match_message
+              application_instance_does_not_match_message
             else
               "#{pacticipant_name} is not currently deployed to #{environment_name} environment. Cannot record undeployment."
             end
           end
         end
 
-        def target_does_not_match_message
-          potential_targets = currently_deployed_version_entities_for_pacticipant.collect(&:target).collect { |target| target || "<no target>"}
-          if target
-            "#{pacticipant_name} is not currently deployed to target '#{target}' in #{environment_name} environment. Please specify one of the following targets to record the undeployment from: #{potential_targets.join(", ")}"
+        def application_instance_does_not_match_message
+          potential_application_instances = currently_deployed_version_entities_for_pacticipant.collect{|e| e.applicationInstance || e.target }
+
+          if application_instance
+            omit_text = potential_application_instances.include?(nil) ? "omit the application instance to undeploy from the anonymous instance" : nil
+            specify_text = potential_application_instances.compact.any? ? "specify one of the following application instances to record the undeployment from: #{potential_application_instances.compact.join(", ")}" : nil
+            "#{pacticipant_name} is not currently deployed to application instance '#{application_instance}' in #{environment_name} environment. Please #{[omit_text, specify_text].compact.join(" or ")}."
           else
-            "Please specify one of the following targets to record the undeployment from: #{potential_targets.join(", ")}"
+            "Please specify one of the following application instances to record the undeployment from: #{potential_application_instances.compact.join(", ")}"
           end
         end
 

data/lib/pact_broker/client/publish_pacts.rb

@@ -28,7 +28,7 @@ module PactBroker
 
       def call
         validate
-        if index_resource.can?("pb:publish-contracts")
+        if !force_use_old_api? && index_resource.can?("pb:publish-contracts")
           publish_pacts
           PactBroker::Client::CommandResult.new(success?, message)
         else
@@ -40,6 +40,10 @@ module PactBroker
 
       attr_reader :pact_broker_base_url, :pact_file_paths, :consumer_version_params, :consumer_version_number, :branch, :tags, :build_url, :options, :pact_broker_client_options, :response_entities
 
+      def force_use_old_api?
+        ENV.fetch("PACT_BROKER_FEATURES", "").include?("publish_pacts_using_old_api")
+      end
+
       def request_body_for(consumer_name)
         {
           pacticipantName: consumer_name,

data/lib/pact_broker/client/publish_pacts_the_old_way.rb

@@ -25,14 +25,13 @@ module PactBroker
         @branch = consumer_version_params[:branch]
         @build_url = consumer_version_params[:build_url]
         @tags = consumer_version_params[:tags] ? consumer_version_params[:tags].collect{ |tag| tag.respond_to?(:strip) ? tag.strip : tag } : []
-        @version_required = consumer_version_params[:version_required]
         @pact_broker_client_options = pact_broker_client_options
       end
 
       def call
         validate
         $stdout.puts("")
-        result = create_consumer_versions && apply_tags && publish_pacts
+        result = apply_tags && publish_pacts
         $stdout.puts("")
         if result
           PactBroker::Client::CommandResult.new(true)
@@ -59,10 +58,6 @@ module PactBroker
         end
       end
 
-      def can_create_version_with_branch?
-        @can_create_version_with_branch ||= index_resource.can?('pb:pacticipant-version')
-      end
-
       def merge_on_server?
         pact_broker_client_options[:write] == :merge
       end
@@ -96,49 +91,6 @@ module PactBroker
         end
       end
 
-      def create_consumer_versions
-        if create_versions?
-          consumer_names.collect do | consumer_name |
-            create_version(index_resource, consumer_name)
-          end
-          true
-        else
-          true
-        end
-      end
-
-      def create_versions?
-        if version_required
-          if can_create_version_with_branch?
-            true
-          else
-            raise PactBroker::Client::Error.new("This version of the Pact Broker does not support versions with branches or build URLs. Please upgrade your broker to 2.76.2 or later.")
-          end
-        elsif (branch || build_url) && can_create_version_with_branch?
-          true
-        else
-          false
-        end
-      end
-
-      def create_version(index_resource, consumer_name)
-        Retry.while_error do
-          version_resource = index_resource._link('pb:pacticipant-version').expand(version: consumer_version_number, pacticipant: consumer_name).put(version_body).assert_success!
-          message = if version_resource.response.status == 200
-            "Replaced version #{consumer_version_number} of #{consumer_name}"
-          else
-            "Created version #{consumer_version_number} of #{consumer_name}"
-          end
-
-          message = message + " (branch #{branch})" if branch
-          $stdout.puts message
-          if version_resource.response.status == 200
-            $stdout.puts ::Term::ANSIColor.yellow("Replacing the version resource is not recommended under normal circumstances and may indicate that you have not configured your Pact pipeline correctly (unless you are just re-running a build for a particular commit). For more information see https://docs.pact.io/versioning")
-          end
-          true
-        end
-      end
-
       def version_body
         {
           branch: branch,
@@ -185,6 +137,9 @@ module PactBroker
       end
 
       def validate
+        if branch || build_url
+          $stdout.puts ::Term::ANSIColor.yellow("WARN: This version of the Pact Broker does not support versions with branches or build URLs. Please upgrade your broker to 2.86.0 or later.")
+        end
         raise PactBroker::Client::Error.new("Please specify the consumer_version_number") unless (consumer_version_number && consumer_version_number.to_s.strip.size > 0)
         raise PactBroker::Client::Error.new("Please specify the pact_broker_base_url") unless (pact_broker_base_url && pact_broker_base_url.to_s.strip.size > 0)
         raise PactBroker::Client::Error.new("No pact files found") unless (pact_file_paths && pact_file_paths.any?)

data/lib/pact_broker/client/version.rb

@@ -1,5 +1,5 @@
 module PactBroker
   module Client
-    VERSION = '1.51.0'
+    VERSION = '1.53.0'
   end
 end

data/pact-broker-client.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.license       = 'MIT'
 
-  gem.add_runtime_dependency 'httparty', '~>0.18'
+  gem.add_runtime_dependency 'httparty', '~>0.18.1' # https://github.com/jnunemaker/httparty/issues/733
   gem.add_runtime_dependency 'term-ansicolor', '~> 1.7'
   gem.add_runtime_dependency 'table_print', '~> 1.5'
   gem.add_runtime_dependency 'thor', '>= 0.20', '< 2.0'

data/script/publish-pact.sh

@@ -1,5 +1,6 @@
 export PACT_BROKER_BASE_URL="http://localhost:9292"
 export PACT_BROKER_TOKEN="localhost"
+#export PACT_BROKER_FEATURES=publish_pacts_using_old_api
 
 # bundle exec bin/pact-broker create-or-update-webhook http://localhost:9393 \
 #   --uuid d40f38c3-aaa3-47f5-9161-95c07bc16b14 \

data/script/record-deployments-and-releases.sh

@@ -8,9 +8,19 @@ bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --en
 bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --environment test --target customer-1
 bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --environment test --target customer-1
 
+bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test --target customer-2
 bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test
 bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test
 bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test --target customer-1
 
 bundle exec bin/pact-broker record-release --pacticipant Foo --version 2 --environment test
-bundle exec bin/pact-broker record-support-ended --pacticipant Foo --version 2 --environment test
+bundle exec bin/pact-broker record-support-ended --pacticipant Foo --version 2 --environment test
+
+bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --environment test
+bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --environment test --application-instance customer-1
+bundle exec bin/pact-broker record-deployment --pacticipant Foo --version 2 --environment test --application-instance customer-1
+
+bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test --application-instance customer-2
+bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test
+bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test
+bundle exec bin/pact-broker record-undeployment --pacticipant Foo --environment test --application-instance customer-1

data/spec/lib/pact_broker/client/deployments/record_deployment_spec.rb

@@ -61,14 +61,14 @@ module PactBroker
               to_return(status: 200, body: record_deployment_body_hash.to_json , headers: {})
           end
 
-          let(:target) { "blue" }
+          let(:application_instance) { "blue" }
 
           let(:params) do
             {
               pacticipant_name: "Foo",
               version_number: "1",
               environment_name: "test",
-              target: target
+              application_instance: application_instance
             }
           end
 
@@ -186,13 +186,13 @@ module PactBroker
             end
 
             it "indicates the API was Pactflow" do
-              expect(subject.message).to include "Recorded deployment of Foo version 1 to test environment (target blue) in Pactflow"
+              expect(subject.message).to include "Recorded deployment of Foo version 1 to test environment (application instance blue) in Pactflow"
             end
 
-            context "when target is nil" do
-              let(:target) { nil }
+            context "when application_instance is nil" do
+              let(:application_instance) { nil }
 
-              it "does not include the target in the result message" do
+              it "does not include the application_instance in the result message" do
                 expect(subject.message).to include "Recorded deployment of Foo version 1 to test environment in"
               end
             end

data/spec/lib/pact_broker/client/deployments/record_undeployment_spec.rb

@@ -7,11 +7,11 @@ module PactBroker
         let(:params) do
           {
             pacticipant_name: "Foo",
-            target: target,
+            application_instance: application_instance,
             environment_name: "test"
           }
         end
-        let(:target) { "customer-1" }
+        let(:application_instance) { "customer-1" }
         let(:output) { "text" }
         let(:options) { { output: output, verbose: true } }
         let(:pact_broker_base_url) { "http://broker" }
@@ -131,7 +131,7 @@ module PactBroker
         subject { RecordUndeployment.call(params, options, pact_broker_client_options) }
 
         its(:success) { is_expected.to eq true }
-        its(:message) { is_expected.to include "Recorded undeployment of Foo version 2 from test environment (target customer-1) in the Pact Broker" }
+        its(:message) { is_expected.to include "Recorded undeployment of Foo version 2 from test environment (application instance customer-1) in the Pact Broker" }
 
         context "when there is no pb:environments relation in the index" do
           let(:index_body_hash) do
@@ -173,8 +173,8 @@ module PactBroker
         end
 
         context "when a target is provided and there is no deployed version with a matching target" do
-          let(:target) { "wrong" }
-          let(:expected_message) { "Foo is not currently deployed to target 'wrong' in test environment. Please specify one of the following targets to record the undeployment from: customer-1, <no target>" }
+          let(:application_instance) { "wrong" }
+          let(:expected_message) { "Foo is not currently deployed to application instance 'wrong' in test environment. Please omit the application instance to undeploy from the anonymous instance or specify one of the following application instances to record the undeployment from: customer-1." }
 
           its(:success) { is_expected.to be false }
           its(:message) { is_expected.to include expected_message }
@@ -186,12 +186,20 @@ module PactBroker
           end
         end
 
+        context "when a target is provided and there is no deployed version with a matching target and all the application instances are set" do
+          let(:application_instance) { "wrong" }
+          let(:returned_target_2) { "customer-2" }
+          let(:expected_message) { "Foo is not currently deployed to application instance 'wrong' in test environment. Please specify one of the following application instances to record the undeployment from: customer-1, customer-2." }
+
+          its(:message) { is_expected.to include expected_message }
+        end
+
         context "when a target is not provided and there is no deployed verison without a target" do
-          let(:target) { nil }
+          let(:application_instance) { nil }
           let(:returned_target_2) { "customer-2" }
 
           its(:success) { is_expected.to be false }
-          its(:message) { is_expected.to include "Please specify one of the following targets to record the undeployment from: customer-1, customer-2" }
+          its(:message) { is_expected.to include "Please specify one of the following application instances to record the undeployment from: customer-1, customer-2" }
         end
 
         context "when there are no deployed versions for the pacticipant" do

data/spec/lib/pact_broker/client/publish_pacts_the_old_way_spec.rb

@@ -263,80 +263,9 @@ module PactBroker
         context "when the broker does not support creation of a version with a branch but a branch is specified" do
           let(:branch) { "main" }
 
-          context "when version_required is true" do
-            let(:version_required) { true }
-
-            it "raises an error" do
-              expect { subject.call }.to raise_error PactBroker::Client::Error
-            end
-          end
-        end
-
-        context "when the broker supports creation of a version with a branch" do
-          before do
-            allow(version_link).to receive(:expand).and_return(version_link)
-            allow(version_resource).to receive(:assert_success!).and_return(version_resource)
-            allow(version_resource).to receive_message_chain(:response, :status).and_return(version_creation_response_status)
-          end
-          let(:can_create_version) { true }
-          let(:version_link) { instance_double("PactBroker::Client::Hal::Link", put: version_resource) }
-          let(:version_resource) { instance_double("PactBroker::Client::Hal::Entity") }
-          let(:version_creation_response_status) { 201 }
-
-          before do
-            allow(index_resource).to receive(:_link).and_return(version_link)
-          end
-
-          context "when there is a branch, build_url or tags specified" do
-            let(:tags) { ["dev"] }
-            let(:branch) { ["main"] }
-            let(:build_url) { "build_url" }
-
-            it "creates a version with the branch, build_url and tags" do
-              expect(index_resource).to receive(:_link)
-              expect(version_link).to receive(:expand).with(pacticipant: "Consumer", version: "1.2.3")
-              expect(version_link).to receive(:put).with(branch: branch, buildUrl: build_url)
-              subject.call
-            end
-
-            context "when there is a branch but no tags" do
-              let(:tags) { [] }
-
-              it "does not set the tags, as this would overwrite the existing ones - not sure about this implementation" do
-                expect(version_link).to receive(:put).with(branch: branch, buildUrl: build_url)
-                subject.call
-              end
-            end
-
-            context "when the version response status is 201" do
-              it "puts a message indicating the version was created" do
-                expect($stdout).to receive(:puts).with(/Created/)
-                subject.call
-              end
-            end
-
-            context "when the version response status is 200" do
-              let(:version_creation_response_status) { 200 }
-
-              it "puts a message indicating the version was replaced" do
-                expect($stdout).to receive(:puts).with(/Replaced/)
-                subject.call
-              end
-            end
-          end
-
-          context "when there is no branch, tags or build_url specified" do
-            before do
-              allow(Retry).to receive(:while_error) { |&block| block.call }
-            end
-            let(:tags) { [] }
-            let(:branch) { nil }
-            let(:build_url) { nil }
-
-            it "does not create a version resource" do
-              expect(index_resource).to_not receive(:_link)
-              subject.call
-            end
+          it "logs a warning" do
+            expect($stdout).to receive(:puts).with(/WARN: This version/)
+            subject.call
           end
         end
       end

data/spec/pacts/pact_broker_client-pact_broker.json

@@ -186,110 +186,6 @@
         }
       }
     },
-    {
-      "description": "a request for the index resource",
-      "providerState": "the pb:pacticipant-version relation exists in the index resource",
-      "request": {
-        "method": "get",
-        "path": "/",
-        "headers": {
-          "Accept": "application/hal+json"
-        }
-      },
-      "response": {
-        "status": 200,
-        "headers": {
-          "Content-Type": "application/hal+json;charset=utf-8"
-        },
-        "body": {
-          "_links": {
-            "pb:pacticipant-version": {
-              "href": "http://localhost:1234/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-{pacticipant}-{version}"
-            }
-          }
-        },
-        "matchingRules": {
-          "$.body._links.pb:pacticipant-version.href": {
-            "match": "regex",
-            "regex": "http:\\/\\/.*{pacticipant}.*{version}"
-          }
-        }
-      }
-    },
-    {
-      "description": "a request to create a pacticipant version",
-      "providerState": "version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does not exist",
-      "request": {
-        "method": "put",
-        "path": "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-Foo-26f353580936ad3b9baddb17b00e84f33c69e7cb",
-        "headers": {
-          "Content-Type": "application/json",
-          "Accept": "application/hal+json"
-        },
-        "body": {
-          "branch": "main",
-          "buildUrl": "http://my-ci/builds/1"
-        }
-      },
-      "response": {
-        "status": 201,
-        "headers": {
-          "Content-Type": "application/hal+json;charset=utf-8"
-        },
-        "body": {
-          "number": "26f353580936ad3b9baddb17b00e84f33c69e7cb",
-          "buildUrl": "http://my-ci/builds/1",
-          "_links": {
-            "self": {
-              "href": "http://localhost:1234/some-url"
-            }
-          }
-        },
-        "matchingRules": {
-          "$.body._links.self.href": {
-            "match": "regex",
-            "regex": "http:\\/\\/.*"
-          }
-        }
-      }
-    },
-    {
-      "description": "a request to create a pacticipant version",
-      "providerState": "version 26f353580936ad3b9baddb17b00e84f33c69e7cb of pacticipant Foo does exist",
-      "request": {
-        "method": "put",
-        "path": "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-Foo-26f353580936ad3b9baddb17b00e84f33c69e7cb",
-        "headers": {
-          "Content-Type": "application/json",
-          "Accept": "application/hal+json"
-        },
-        "body": {
-          "branch": "main",
-          "buildUrl": "http://my-ci/builds/1"
-        }
-      },
-      "response": {
-        "status": 200,
-        "headers": {
-          "Content-Type": "application/hal+json;charset=utf-8"
-        },
-        "body": {
-          "number": "26f353580936ad3b9baddb17b00e84f33c69e7cb",
-          "buildUrl": "http://my-ci/builds/1",
-          "_links": {
-            "self": {
-              "href": "http://localhost:1234/some-url"
-            }
-          }
-        },
-        "matchingRules": {
-          "$.body._links.self.href": {
-            "match": "regex",
-            "regex": "http:\\/\\/.*"
-          }
-        }
-      }
-    },
     {
       "description": "a request to determine if Bar can be deployed with all Foo tagged prod, ignoring the verification for Foo version 3.4.5",
       "providerState": "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",
@@ -1823,6 +1719,7 @@
           "Accept": "application/hal+json"
         },
         "body": {
+          "applicationInstance": "blue",
           "target": "blue"
         }
       },

data/spec/service_providers/record_deployment_spec.rb

@@ -9,13 +9,13 @@ RSpec.describe "recording a deployment", pact: true do
   let(:version_number) { "5556b8149bf8bac76bc30f50a8a2dd4c22c85f30" }
   let(:environment_name) { "test" }
   let(:output) { "text" }
-  let(:target) { "blue" }
+  let(:application_instance) { "blue" }
   let(:params) do
     {
       pacticipant_name: pacticipant_name,
       version_number: version_number,
       environment_name: environment_name,
-      target: target
+      application_instance: application_instance
     }
   end
   let(:options) do
@@ -139,14 +139,15 @@ RSpec.describe "recording a deployment", pact: true do
         path: "/HAL-REL-PLACEHOLDER-PB-RECORD-DEPLOYMENT-FOO-5556B8149BF8BAC76BC30F50A8A2DD4C22C85F30-TEST",
         headers: post_request_headers,
         body: {
-          target: target
+          applicationInstance: application_instance,
+          target: application_instance
         }
       )
       .will_respond_with(
         status: 201,
         headers: pact_broker_response_headers,
         body: {
-          target: target
+          target: application_instance
         }
       )
   end
@@ -160,14 +161,14 @@ RSpec.describe "recording a deployment", pact: true do
 
     it "returns a success message" do
       expect(subject.success).to be true
-      expect(subject.message).to include "Recorded deployment of Foo version 5556b8149bf8bac76bc30f50a8a2dd4c22c85f30 to test environment (target blue) in the Pact Broker."
+      expect(subject.message).to include "Recorded deployment of Foo version 5556b8149bf8bac76bc30f50a8a2dd4c22c85f30 to test environment (application instance blue) in the Pact Broker."
     end
 
     context "when the output is json" do
       let(:output) { "json" }
 
       it "returns the JSON payload" do
-        expect(JSON.parse(subject.message)).to eq "target" => target
+        expect(JSON.parse(subject.message)).to eq "target" => application_instance
       end
     end
   end

data/spec/service_providers/record_undeployment_spec.rb

@@ -8,12 +8,12 @@ RSpec.describe "recording an undeployment", pact: true do
   let(:pacticipant_name) { "Foo" }
   let(:environment_name) { "test" }
   let(:output) { "text" }
-  let(:target) { "customer-1" }
+  let(:application_instance) { "customer-1" }
   let(:params) do
     {
       pacticipant_name: pacticipant_name,
       environment_name: environment_name,
-      target: target
+      application_instance: application_instance
     }
   end
   let(:options) do
@@ -100,7 +100,7 @@ RSpec.describe "recording an undeployment", pact: true do
           _embedded: {
             deployedVersions: [
               {
-                target: target,
+                target: application_instance,
                 _links: {
                   self: {
                     href: Pact.term(pact_broker.mock_service_base_url + deployed_version_placeholder_path, /^http/)
@@ -150,7 +150,7 @@ RSpec.describe "recording an undeployment", pact: true do
 
     it "returns a success message" do
       expect(subject.success).to be true
-      expect(subject.message).to include "Recorded undeployment of Foo version 2 from test environment (target customer-1) in the Pact Broker"
+      expect(subject.message).to include "Recorded undeployment of Foo version 2 from test environment (application instance customer-1) in the Pact Broker"
     end
 
     context "when the output is json" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pact_broker-client
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.53.0
 platform: ruby
 authors:
 - Beth Skurrie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-21 00:00:00.000000000 Z
+date: 2021-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: 0.18.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: 0.18.1
 - !ruby/object:Gem::Dependency
   name: term-ansicolor
   requirement: !ruby/object:Gem::Requirement
@@ -380,7 +380,6 @@ files:
 - spec/service_providers/extra_goodies_spec.rb
 - spec/service_providers/list_environments_spec.rb
 - spec/service_providers/list_latest_pact_versions_spec.rb.bak
-- spec/service_providers/pact_broker_client_create_version_spec.rb
 - spec/service_providers/pact_broker_client_matrix_ignore_spec.rb
 - spec/service_providers/pact_broker_client_matrix_spec.rb
 - spec/service_providers/pact_broker_client_pacticipant_version_spec.rb
@@ -431,7 +430,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.27
+rubygems_version: 3.2.28
 signing_key: 
 specification_version: 4
 summary: See description
@@ -488,7 +487,6 @@ test_files:
 - spec/service_providers/extra_goodies_spec.rb
 - spec/service_providers/list_environments_spec.rb
 - spec/service_providers/list_latest_pact_versions_spec.rb.bak
-- spec/service_providers/pact_broker_client_create_version_spec.rb
 - spec/service_providers/pact_broker_client_matrix_ignore_spec.rb
 - spec/service_providers/pact_broker_client_matrix_spec.rb
 - spec/service_providers/pact_broker_client_pacticipant_version_spec.rb

data/spec/service_providers/pact_broker_client_create_version_spec.rb

@@ -1,88 +0,0 @@
-require_relative 'pact_helper'
-require 'pact_broker/client'
-require 'pact_broker/client/publish_pacts_the_old_way'
-
-describe PactBroker::Client::Versions, pact: true do
-
-  include_context "pact broker"
-
-
-  describe "creating a pacticipant version" do
-    before do
-      allow(publish_pacts_the_old_way).to receive(:consumer_names).and_return(["Foo"])
-      allow($stdout).to receive(:puts)
-    end
-    let(:version_path) { "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-{pacticipant}-{version}" }
-    let(:version_url) { pact_broker.mock_service_base_url + version_path }
-    let(:number) { "26f353580936ad3b9baddb17b00e84f33c69e7cb" }
-    let(:branch) { "main" }
-    let(:build_url) { "http://my-ci/builds/1" }
-    let(:consumer_version_params) { { number: number, branch: branch, build_url: build_url } }
-    let(:publish_pacts_the_old_way) { PactBroker::Client::PublishPactsTheOldWay.new(pact_broker.mock_service_base_url, ["some-pact.json"], consumer_version_params, {}) }
-    let(:provider_state) { "version #{number} of pacticipant Foo does not exist" }
-    let(:expected_response_status) { 201 }
-
-    subject { publish_pacts_the_old_way.send(:create_consumer_versions) }
-
-    before do
-      pact_broker
-        .given("the pb:pacticipant-version relation exists in the index resource")
-        .upon_receiving("a request for the index resource")
-        .with(
-            method: :get,
-            path: '/',
-            headers: get_request_headers).
-          will_respond_with(
-            status: 200,
-            headers: pact_broker_response_headers,
-            body: {
-              _links: {
-                :'pb:pacticipant-version' => {
-                  href: Pact.term(version_url, /http:\/\/.*{pacticipant}.*{version}/)
-                }
-              }
-            }
-          )
-
-      pact_broker
-        .given(provider_state)
-        .upon_receiving("a request to create a pacticipant version")
-        .with(
-            method: :put,
-            path: "/HAL-REL-PLACEHOLDER-INDEX-PB-PACTICIPANT-VERSION-Foo-#{number}",
-            headers: put_request_headers,
-            body: {
-              branch: branch,
-              buildUrl: build_url
-            }).
-          will_respond_with(
-            status: expected_response_status,
-            headers: pact_broker_response_headers,
-            body: {
-              number: number,
-              buildUrl: build_url,
-              _links: {
-                self: {
-                  href: Pact.term('http://localhost:1234/some-url', %r{http://.*})
-                }
-              }
-            }
-          )
-    end
-
-    context "when the version does not already exist" do
-      it "returns true" do
-        expect(subject).to be true
-      end
-    end
-
-    context "when the version does exist" do
-      let(:provider_state) { "version #{number} of pacticipant Foo does exist" }
-      let(:expected_response_status) { 200 }
-
-      it "returns true" do
-        expect(subject).to be true
-      end
-    end
-  end
-end