pact_broker-client 0.0.6 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6a967616dbb7645aee64d92eb651df824eafc0c2
+  data.tar.gz: a71df89ab5813ff99fe394b95132181e8411512f
+SHA512:
+  metadata.gz: 54a964cd4ee363a53da92ea018b94ea9fbc868c485a4351a7c69ba359d2cde0c013136298a1c736b54da8e767c243f8e548f5290e8c52f8dc7568dfb8fb4b987
+  data.tar.gz: 965141aba58e46843f5f6defd961c3f5077086920bf7fe3e760c1c3b4925face6f4aeb3210c7bda523a06a0c37c7f226137463fc401ee44920dbb50ff97b2942

data/CHANGELOG.md

@@ -2,6 +2,18 @@ Do this to generate your change history
 
     $ git log --pretty=format:'  * %h - %s (%an, %ad)'
 
+#### 1.0.0 (2014-10-09)
+
+* 2c08da2 - added pact_broker_basic_auth options to publish task (lifei zhou, Fri Feb 27 21:33:09 2015 +1100)
+* 1b84a54 - Updated pact-version rel name (Beth, Mon Dec 22 11:30:57 2014 +1100)
+* 04c1e4e - Updated link rels (Beth, Thu Dec 11 14:32:27 2014 +1100)
+* d1b2cad - Correcting pact publish message (Beth Skurrie, Mon Aug 25 07:15:57 2014 +1000)
+* 6b1d147 - Added backwards compatibility for pact broker publish response (Beth Skurrie, Sun Aug 24 17:50:16 2014 +1000)
+* 8c8aa89 - Added location of latest pact to output of pact:publish (Beth Skurrie, Sun Aug 24 17:43:02 2014 +1000)
+* e6b56d0 - Added retries for pact publishing (Beth Skurrie, Sun Aug 24 16:55:10 2014 +1000)
+* 27c00e5 - Disabled pacticipant version interactions, not needed yet. (Beth Skurrie, Sat May 17 17:57:33 2014 +1000)
+* cfefdc4 - Changed path from /pact to /pacts (Beth Skurrie, Sat May 17 15:58:32 2014 +1000)
+
 #### 0.0.6 (2014-03-24)
 
 * 2ad5f7d - Updated method of tagging versions (bethesque, Sat Mar 22 16:54:37 2014 +1100)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pact_broker-client (0.0.6)
+    pact_broker-client (1.0.0)
       httparty
       json
       pact
@@ -9,54 +9,76 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    awesome_print (1.2.0)
-    coderay (1.0.9)
-    daemons (1.1.9)
+    awesome_print (1.6.1)
+    coderay (1.1.0)
     diff-lcs (1.2.5)
-    eventmachine (1.0.3)
-    fakefs (0.4.2)
+    fakefs (0.6.0)
     find_a_port (1.0.1)
-    httparty (0.13.0)
+    httparty (0.13.7)
       json (~> 1.8)
       multi_xml (>= 0.5.2)
-    json (1.8.1)
+    json (1.8.3)
     method_source (0.8.2)
     multi_xml (0.5.5)
-    pact (1.0.30)
+    pact (1.9.0)
       awesome_print (~> 1.1)
       find_a_port (~> 1.0.1)
       json
+      pact-mock_service (~> 0.7)
+      pact-support (~> 0.5)
       rack-test (~> 0.6.2)
       randexp (~> 0.1.7)
-      rspec (~> 2.12)
-      thin
+      rspec (>= 2.14)
+      term-ansicolor (~> 1.0)
       thor
       webrick
-    pry (0.9.12.2)
-      coderay (~> 1.0.5)
-      method_source (~> 0.8)
+    pact-mock_service (0.7.2)
+      find_a_port (~> 1.0.1)
+      json
+      pact-support (~> 0.5.3)
+      rack
+      rack-test (~> 0.6.2)
+      rspec (>= 2.14)
+      term-ansicolor (~> 1.0)
+      thor
+      webrick
+    pact-support (0.5.3)
+      awesome_print (~> 1.1)
+      find_a_port (~> 1.0.1)
+      json
+      rack-test (~> 0.6.2)
+      randexp (~> 0.1.7)
+      rspec (>= 2.14)
+      term-ansicolor (~> 1.0)
+      thor
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
       slop (~> 3.4)
-    rack (1.5.2)
-    rack-test (0.6.2)
+    rack (1.6.4)
+    rack-test (0.6.3)
       rack (>= 1.0)
     rake (10.0.4)
     randexp (0.1.7)
-    rspec (2.14.1)
-      rspec-core (~> 2.14.0)
-      rspec-expectations (~> 2.14.0)
-      rspec-mocks (~> 2.14.0)
-    rspec-core (2.14.7)
-    rspec-expectations (2.14.4)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-fire (1.2.0)
-      rspec (~> 2.11)
-    rspec-mocks (2.14.4)
-    slop (3.4.6)
-    thin (1.6.1)
-      daemons (>= 1.0.9)
-      eventmachine (>= 1.0.0)
-      rack (>= 1.0.0)
-    thor (0.18.1)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.7)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-fire (1.3.0)
+      rspec (>= 2.11, < 4)
+    rspec-mocks (3.1.3)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.2)
+    slop (3.6.0)
+    term-ansicolor (1.3.2)
+      tins (~> 1.0)
+    thor (0.19.1)
+    tins (1.6.0)
     webrick (1.3.1)
 
 PLATFORMS
@@ -68,3 +90,6 @@ DEPENDENCIES
   pry
   rake (~> 10.0.3)
   rspec-fire
+
+BUNDLED WITH
+   1.10.6

data/README.md

@@ -1,3 +1,50 @@
 # Pact Broker Client
 
 A client for the Pact Broker. Publishes pacts to, and retrieves pacts from, the pact broker.
+
+## Usage
+
+You will need an instance of a [Pact Broker](https://github.com/bethesque/pact_broker). It's URL will be used below in the configuration for the Consumer and the Provider. eg. http://pact-broker.my.org
+
+### Consumer
+
+```ruby
+# In Gemfile
+
+gem "pact_broker-client"
+```
+
+```ruby
+# In Rakefile
+
+require 'pact_broker/client/tasks'
+
+PactBroker::Client::PublicationTask.new do | task |
+  require 'my_consumer/version'
+  task.consumer_version = MyConsumer::VERSION
+  task.pact_broker_base_url = "http://pact-broker.my.org"
+  task.pact_broker_basic_auth =  { username: 'basic_auth_user', password: 'basic_auth_pass'} #optional
+end
+```
+
+```bash
+# In CI script
+
+rake pact:publish
+```
+
+### Provider
+
+```ruby
+# In spec/service_consumers/pact_helper.rb
+
+require 'pact/provider/rspec'
+
+Pact.service_provider "My Provider" do
+
+  honours_pact_with "My Consumer" do
+    pact_uri URI.encode("http://pact-broker.my.org/pact/provider/My Provider/consumer/My Consumer/latest")
+  end
+
+end
+```

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"
+      }
+    }
+  }
+}
+```