pact_broker-client 1.13.1 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 04be89acaef17f512ad8aab983fe3dfb4d6e9413
-  data.tar.gz: 38e3dafaa69d47aa311725647178120a1e25e5f1
+  metadata.gz: 3be2902ef57a2367371bbc65a68394875f91e2c2
+  data.tar.gz: 2717b8043ad6ea83c97668153b4ed1ec644f20ce
 SHA512:
-  metadata.gz: 863e8363bc8ae586f3975f400ce73a8fed77ea952ce450de96c04d5246a43c7b9b7a93a3c58c2a796cb43da9e7fae06a22f5fa951320c8be057931b0c0e7e361
-  data.tar.gz: 7ab61062adeebc8306a9b169fb9c04cddfb777e1979cafc25409647eba8448f11b8f45c7cd6a3accc40d87ec69cc525b2635f5f62bae5f43b66dc713311beed0
+  metadata.gz: 23f6c7c6cbd7910dd3bc27f704cd6e8e8cb69c27587c6c5f49c20d63cc158a4879ff6483bc43088441ed066f74edaf6e467878dbff3198eb25bc31e362c6d20d
+  data.tar.gz: 88e25959d7e6c29b405ef277ca40544287a32c3453774f993d639651dc1fb5e815f7b59e08c1dab12bf0bd13c246baf448bfe0a454ef802fb6a89f001e9af701

data/.gitignore

@@ -17,7 +17,6 @@ reports
 # YARD artifacts
 .yardoc
 _yardoc
-doc/
 .bin
 
 # Editor files

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+<a name="v1.14.0"></a>
+### v1.14.0 (2018-01-25)
+
+
+#### Features
+
+* **describe-version**
+  * allow retrieving latest pacticipant version	 ([7679f61](/../../commit/7679f61))
+
+* update help text for can-i-deploy	 ([7d3f3e1](/../../commit/7d3f3e1))
+* add example showing how to use can-i-deploy and describe-version as a verification webhook endpoint	 ([ec83387](/../../commit/ec83387))
+
+* **cli**
+  * add describe-version	 ([6e12478](/../../commit/6e12478))
+  * output HTTP request and response debugging when verbose mode enabled	 ([f487714](/../../commit/f487714))
+
+
 <a name="v1.13.0"></a>
 ### v1.13.0 (2017-11-09)
 

data/README.md

@@ -55,8 +55,7 @@ Add a tag to a pacticipant version
 
 ### can-i-deploy
 
-*This feature is in beta release, and backwards compatibility is NOT guaranteed.*
-You will need the latest version of the Pact Broker for this feature to work.
+You will need >= v2.13.0 of the Pact Broker for this feature to work.
 
 ```
 Usage:
@@ -74,40 +73,52 @@ Options:
   -v, [--verbose], [--no-verbose]          # Verbose output. Default: false
 
 Description:
-  Returns exit code 0 or 1, indicating whether or not the specified pacticipant versions are compatible. Prints out the
-  relevant pact/verification details.
+  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_USERNAME and PACT_BROKER_PASSWORD may be used instead of
-  their respective command line options.
+  The environment variables PACT_BROKER_BASE_URL_BASE_URL, PACT_BROKER_BASE_URL_USERNAME and PACT_BROKER_BASE_URL_PASSWORD may be used instead of their respective command line options.
 
   SCENARIOS
 
-  Check the status of the pacts for a pacticipant version:
+  # If every build goes straight to production
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT --version VERSION --broker-base-url BROKER_BASE_URL
+  Check the status of the pacts for a pacticipant version. Note that this only checks that the most recent verification for each pact is successful. It doesn't provide any assurance that the pact has been verified by the *production* version of the provider, however, it is sufficient if you are doing true continuous deployment.
 
-  Check the status of the pacts for the latest pacticipant version:
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT --version VERSION --broker-base-url BROKER_BASE_URL
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT --latest --broker-base-url BROKER_BASE_URL
+  # If every build does NOT go straight to production
+
+  ## Recommended approach
+
+  If all applications within the pact network are not being deployed continuously (ie. if there is a gap between pact verification and actual deployment) then the following strategy is recommended. Each application version should be tagged in the broker with the name of the stage (eg. test, staging, production) as it is deployed (see the pact-broker create-version-tag CLI). This enables you to use the following very simple command to check if the application version you are about to deploy is compatible with every other application version already deployed in that environment.
+
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT --version VERSION --to TAG --broker-base-url BROKER_BASE_URL
+
+  ## Other approaches
+
+  If you do not/cannot tag every application at deployment, you have two options. You can either use the very first form of this command which just checks that the *latest* verification is successful (not recommended as it's the production version that you really care about) or you will need to determine the production versions of each collaborating application from some other source (eg. git) and explictly reference each one using one using the format `--pacticipant PACTICIPANT1 --version VERSION1 --pacticipant PACTICIPANT2 --version VERSION2 ...`
+
+  # Other commands
+
+  Check the status of the pacts for the latest pacticipant version. This form is not recommended for use in your CI as it is possible that the version you are about to deploy is not the the version that the Broker considers the latest. It's best to specify the version explictly.
+
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT --latest --broker-base-url BROKER_BASE_URL
 
   Check the status of the pacts for the latest pacticipant version for a given tag:
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT --latest TAG --broker-base-url BROKER_BASE_URL
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT --latest TAG --broker-base-url BROKER_BASE_URL
 
   Check the status of the pacts between two (or more) specific pacticipant versions:
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --version VERSION1 --pacticipant PACTICIPANT2 --version VERSION2
-  --broker-base-url BROKER_BASE_URL
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --version VERSION1 --pacticipant PACTICIPANT2 --version VERSION2 --broker-base-url BROKER_BASE_URL
 
   Check the status of the pacts between the latest versions of two (or more) pacticipants:
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --latest --pacticipant PACTICIPANT2 --latest --broker-base-url
-  BROKER
+    $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --latest --pacticipant PACTICIPANT2 --latest --broker-base-url BROKER_BASE_URL
 
   Check the status of the pacts between the latest versions of two (or more) pacticipants with a given tag:
 
-  $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --latest TAG1 --pacticipant PACTICIPANT2 --latest TAG2
-  --broker-base-url BROKER_BASE_URL
+  $ pact-broker can-i-deploy --pacticipant PACTICIPANT1 --latest TAG1 --pacticipant PACTICIPANT2 --latest TAG2 --broker-base-url BROKER_BASE_URL
+
 ```
 
 ## Usage - Ruby

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

@@ -0,0 +1,582 @@
+### A pact between Pact Broker Client and Pact Broker
+
+#### Requests from Pact Broker Client to Pact Broker
+
+* [A request for the latest version](#a_request_for_the_latest_version_given_no_version_exists_for_the_Pricing_Service) given no version exists for the Pricing Service
+
+* [A request for the latest version tagged with 'prod'](#a_request_for_the_latest_version_tagged_with_'prod'_given_a_version_with_production_details_exists_for_the_Pricing_Service) given a version with production details exists for the Pricing Service
+
+* [A request retrieve a pact for a specific version](#a_request_retrieve_a_pact_for_a_specific_version_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 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
+
+* [A request to list pacticipants](#a_request_to_list_pacticipants_given_'Condor'_exists_in_the_pact-broker) given 'Condor' exists in the pact-broker
+
+* [A request to list the latest pacts](#a_request_to_list_the_latest_pacts_given_a_pact_between_Condor_and_the_Pricing_Service_exists) given a pact between Condor and the Pricing Service exists
+
+* [A request to publish a pact](#a_request_to_publish_a_pact_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 a pact](#a_request_to_publish_a_pact_given_'Condor'_already_exist_in_the_pact-broker,_but_the_'Pricing_Service'_does_not) given 'Condor' already exist in the pact-broker, but the 'Pricing Service' does not
+
+* [A request to publish a pact](#a_request_to_publish_a_pact_given_the_'Pricing_Service'_already_exists_in_the_pact-broker) given the 'Pricing Service' already exists in the pact-broker
+
+* [A request to publish a pact](#a_request_to_publish_a_pact_given_an_error_occurs_while_publishing_a_pact) given an error occurs while publishing a pact
+
+* [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
+
+* [A request to retrieve the latest pact between Condor and the Pricing Service](#a_request_to_retrieve_the_latest_pact_between_Condor_and_the_Pricing_Service_given_a_pact_between_Condor_and_the_Pricing_Service_exists) given a pact between Condor and the Pricing Service exists
+
+* [A request to retrieve the latest pact between Condor and the Pricing Service](#a_request_to_retrieve_the_latest_pact_between_Condor_and_the_Pricing_Service_given_no_pact_between_Condor_and_the_Pricing_Service_exists) given no pact between Condor and the Pricing Service exists
+
+* [A request to retrieve the pact between the production verison of Condor and the Pricing Service](#a_request_to_retrieve_the_pact_between_the_production_verison_of_Condor_and_the_Pricing_Service_given_a_pact_between_Condor_and_the_Pricing_Service_exists_for_the_production_version_of_Condor) given a pact between Condor and the Pricing Service exists for the production version of Condor
+
+* [A request to tag the production version of Condor](#a_request_to_tag_the_production_version_of_Condor_given_'Condor'_exists_in_the_pact-broker_with_version_1.3.0,_tagged_with_'prod') given 'Condor' exists in the pact-broker with version 1.3.0, tagged with 'prod'
+
+* [A request to tag the production version of Condor](#a_request_to_tag_the_production_version_of_Condor_given_'Condor'_does_not_exist_in_the_pact-broker) given 'Condor' does not exist in the pact-broker
+
+* [A request to tag the production version of Condor](#a_request_to_tag_the_production_version_of_Condor_given_'Condor'_exists_in_the_pact-broker) given 'Condor' exists in the pact-broker
+
+#### Interactions
+
+<a name="a_request_for_the_latest_version_given_no_version_exists_for_the_Pricing_Service"></a>
+Given **no version exists for the Pricing Service**, upon receiving **a request for the latest version** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pacticipants/Pricing%20Service/versions/latest",
+  "headers": {
+    "Accept": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 404
+}
+```
+<a name="a_request_for_the_latest_version_tagged_with_'prod'_given_a_version_with_production_details_exists_for_the_Pricing_Service"></a>
+Given **a version with production details exists for the Pricing Service**, upon receiving **a request for the latest version tagged with 'prod'** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pacticipants/Pricing%20Service/versions/latest",
+  "query": "tag=prod",
+  "headers": {
+    "Accept": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "number": "1.2.3",
+    "repository_ref": "package/pricing-service-1.2.3",
+    "tags": [
+      "prod"
+    ]
+  }
+}
+```
+<a name="a_request_retrieve_a_pact_for_a_specific_version_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>
+Given **the 'Pricing Service' and 'Condor' already exist in the pact-broker, and Condor already has a pact published for version 1.3.0**, upon receiving **a request retrieve a pact for a specific version** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+<a name="a_request_to_get_the_Pricing_Service_given_the_'Pricing_Service'_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
+{
+  "method": "get",
+  "path": "/pacticipants/Pricing%20Service"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/hal+json"
+  },
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://example.org/pacticipants/Pricing%20Service"
+      },
+      "versions": {
+        "href": "http://example.org/pacticipants/Pricing%20Service/versions"
+      },
+      "latest_version": {
+        "href": "http://example.org/pacticipants/Pricing%20Service/versions/latest"
+      }
+    },
+    "name": "Pricing Service",
+    "repository_url": "git@git.realestate.com.au:business-systems/pricing-service",
+    "_embedded": {
+      "latest_version": {
+        "_links": {
+          "self": {
+            "href": "http://example.org/pacticipants/Pricing%20Service/versions/1.3.0"
+          }
+        },
+        "number": "1.3.0"
+      }
+    }
+  }
+}
+```
+<a name="a_request_to_get_the_Pricing_Service_given_the_'Pricing_Service'_does_not_exist_in_the_pact-broker"></a>
+Given **the 'Pricing Service' does not exist in the pact-broker**, upon receiving **a request to get the Pricing Service** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pacticipants/Pricing%20Service"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 404
+}
+```
+<a name="a_request_to_list_pacticipants_given_'Condor'_exists_in_the_pact-broker"></a>
+Given **'Condor' exists in the pact-broker**, upon receiving **a request to list pacticipants** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pacticipants"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/hal+json"
+  },
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://example.org/pacticipants"
+      },
+      "pacticipants": [
+        {
+          "href": "http://example.org/pacticipants/Condor",
+          "title": "Condor"
+        }
+      ]
+    },
+    "pacticipants": [
+      {
+        "_links": {
+          "self": {
+            "href": "http://example.org/pacticipants/Condor"
+          }
+        },
+        "name": "Condor",
+        "_embedded": {
+          "latest_version": {
+            "_links": {
+              "self": {
+                "href": "http://example.org/pacticipants/Condor/versions/1.3.0"
+              }
+            },
+            "number": "1.3.0"
+          }
+        }
+      }
+    ]
+  }
+}
+```
+<a name="a_request_to_list_the_latest_pacts_given_a_pact_between_Condor_and_the_Pricing_Service_exists"></a>
+Given **a pact between Condor and the Pricing Service exists**, upon receiving **a request to list the latest pacts** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pacts/latest"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/hal+json"
+  },
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://example.org/pacts/latest"
+      }
+    },
+    "pacts": [
+      {
+        "_links": {
+          "self": [
+            {
+              "href": "http://example.org/pact/provider/Pricing%20Service/consumer/Condor/latest"
+            },
+            {
+              "href": "http://example.org/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0"
+            }
+          ]
+        },
+        "_embedded": {
+          "consumer": {
+            "name": "Condor",
+            "_links": {
+              "self": {
+                "href": "http://example.org/pacticipants/Condor"
+              }
+            },
+            "_embedded": {
+              "version": {
+                "number": "1.3.0"
+              }
+            }
+          },
+          "provider": {
+            "_links": {
+              "self": {
+                "href": "http://example.org/pacticipants/Pricing%20Service"
+              }
+            },
+            "name": "Pricing Service"
+          }
+        }
+      }
+    ]
+  }
+}
+```
+<a name="a_request_to_publish_a_pact_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>
+Given **the 'Pricing Service' and 'Condor' already exist in the pact-broker, and Condor already has a pact published for version 1.3.0**, upon receiving **a request to publish a pact** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200
+}
+```
+<a name="a_request_to_publish_a_pact_given_'Condor'_already_exist_in_the_pact-broker,_but_the_'Pricing_Service'_does_not"></a>
+Given **'Condor' already exist in the pact-broker, but the 'Pricing Service' does not**, upon receiving **a request to publish a pact** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 201
+}
+```
+<a name="a_request_to_publish_a_pact_given_the_'Pricing_Service'_already_exists_in_the_pact-broker"></a>
+Given **the 'Pricing Service' already exists in the pact-broker**, upon receiving **a request to publish a pact** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 201
+}
+```
+<a name="a_request_to_publish_a_pact_given_an_error_occurs_while_publishing_a_pact"></a>
+Given **an error occurs while publishing a pact**, upon receiving **a request to publish a pact** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/version/1.3.0",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 500,
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "message": "An error occurred"
+  }
+}
+```
+<a name="a_request_to_register_the_repository_URL_of_a_pacticipant_given_the_'Pricing_Service'_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
+{
+  "method": "patch",
+  "path": "/pacticipants/Pricing%20Service",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "repository_url": "git@git.realestate.com.au:business-systems/pricing-service"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200
+}
+```
+<a name="a_request_to_register_the_repository_URL_of_a_pacticipant_given_the_'Pricing_Service'_does_not_exist_in_the_pact-broker"></a>
+Given **the 'Pricing Service' does not exist in the pact-broker**, upon receiving **a request to register the repository URL of a pacticipant** from Pact Broker Client, with
+```json
+{
+  "method": "patch",
+  "path": "/pacticipants/Pricing%20Service",
+  "headers": {
+    "Content-Type": "application/json"
+  },
+  "body": {
+    "repository_url": "git@git.realestate.com.au:business-systems/pricing-service"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 201
+}
+```
+<a name="a_request_to_retrieve_the_latest_pact_between_Condor_and_the_Pricing_Service_given_a_pact_between_Condor_and_the_Pricing_Service_exists"></a>
+Given **a pact between Condor and the Pricing Service exists**, upon receiving **a request to retrieve the latest pact between Condor and the Pricing Service** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/latest"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "headers": {
+    "Content-Type": "application/json",
+    "X-Pact-Consumer-Version": "1.3.0"
+  },
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+<a name="a_request_to_retrieve_the_latest_pact_between_Condor_and_the_Pricing_Service_given_no_pact_between_Condor_and_the_Pricing_Service_exists"></a>
+Given **no pact between Condor and the Pricing Service exists**, upon receiving **a request to retrieve the latest pact between Condor and the Pricing Service** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/latest"
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 404
+}
+```
+<a name="a_request_to_retrieve_the_pact_between_the_production_verison_of_Condor_and_the_Pricing_Service_given_a_pact_between_Condor_and_the_Pricing_Service_exists_for_the_production_version_of_Condor"></a>
+Given **a pact between Condor and the Pricing Service exists for the production version of Condor**, upon receiving **a request to retrieve the pact between the production verison of Condor and the Pricing Service** from Pact Broker Client, with
+```json
+{
+  "method": "get",
+  "path": "/pact/provider/Pricing%20Service/consumer/Condor/latest/prod",
+  "headers": {
+    "Accept": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "body": {
+    "consumer": {
+      "name": "Condor"
+    },
+    "provider": {
+      "name": "Pricing Service"
+    },
+    "interactions": [
+
+    ]
+  }
+}
+```
+<a name="a_request_to_tag_the_production_version_of_Condor_given_'Condor'_exists_in_the_pact-broker_with_version_1.3.0,_tagged_with_'prod'"></a>
+Given **'Condor' exists in the pact-broker with version 1.3.0, tagged with 'prod'**, upon receiving **a request to tag the production version of Condor** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pacticipants/Condor/versions/1.3.0/tags/prod",
+  "headers": {
+    "Content-Type": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 200,
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://localhost:1234/pacticipants/Condor/versions/1.3.0/tags/prod"
+      }
+    }
+  }
+}
+```
+<a name="a_request_to_tag_the_production_version_of_Condor_given_'Condor'_does_not_exist_in_the_pact-broker"></a>
+Given **'Condor' does not exist in the pact-broker**, upon receiving **a request to tag the production version of Condor** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pacticipants/Condor/versions/1.3.0/tags/prod",
+  "headers": {
+    "Content-Type": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 201,
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://localhost:1234/pacticipants/Condor/versions/1.3.0/tags/prod"
+      }
+    }
+  }
+}
+```
+<a name="a_request_to_tag_the_production_version_of_Condor_given_'Condor'_exists_in_the_pact-broker"></a>
+Given **'Condor' exists in the pact-broker**, upon receiving **a request to tag the production version of Condor** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/pacticipants/Condor/versions/1.3.0/tags/prod",
+  "headers": {
+    "Content-Type": "application/json"
+  }
+}
+```
+Pact Broker will respond with:
+```json
+{
+  "status": 201,
+  "body": {
+    "_links": {
+      "self": {
+        "href": "http://localhost:1234/pacticipants/Condor/versions/1.3.0/tags/prod"
+      }
+    }
+  }
+}
+```