pact_broker 2.99.0 → 2.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edd8be1bf717f3b98618f1f585146efa701f4833a9c2d8ba05eb395278bd435c
-  data.tar.gz: 36c07bdd448edd40e623c0976ec65df4c2512ddf73ce400512e27d08f7a086d8
+  metadata.gz: 398f65fe7258fe0826026394bf3066bce3bfcda2662d460a0aa971e642310b16
+  data.tar.gz: f0e2c8c038763a814075d8a1090b3dc6886ccc8cef823a75acfa1e372378f770
 SHA512:
-  metadata.gz: 023ae6605034518c73da217fff6be8c6888bd7d56abcbf11895f18ec3eab9e32775ec574381473e626e1bca75bc3b132fd30fd755157e980d3e16dea9c125f4f
-  data.tar.gz: 67d5dcb38a78a5e590ec961826951e32c4e391ad13eea43fbf57faa48de2c20212397cdb116b93c975ecdb576e7790112e6db16b43ba5c866af4c074c0370cd3
+  metadata.gz: 0d24a6f1cd9d2b82f237e3bd56412e73da07cd6e37b9a229fb36996a2994dafae9f8a7ec45fbd158f512e244df0403a5fa80f0edf8aae59e1b4fbf4423f9cef6
+  data.tar.gz: b2f0bd7cdae4c7551ab6b3e28ec339d809ea98907c3dc0d1a824f054cfefef8592379d758ac3e679b0e509fffdd774cab104d882647b89fe0762e998873eb3a0

data/CHANGELOG.md

@@ -1,3 +1,53 @@
+<a name="v2.102.0"></a>
+### v2.102.0 (2022-07-07)
+
+#### Features
+
+* default allow_dangerous_contract_modification to false for new installations	 ([85a89951](/../../commit/85a89951))
+
+#### Bug Fixes
+
+* add missing provider version branch parameter to webhook requests	 ([262dae44](/../../commit/262dae44))
+* clean up pacticipants with no names	 ([0aff250d](/../../commit/0aff250d))
+* update string refinements with blank? and present?	 ([8373f88f](/../../commit/8373f88f))
+* update validation for creating pacticipants to return a 400 when name is missing	 ([fcb02aa6](/../../commit/fcb02aa6))
+
+<a name="v2.101.0"></a>
+### v2.101.0 (2022-06-07)
+
+#### Features
+
+* recalculate the branch head if the deleted branch version was the latest for the branch	 ([db51d4fe](/../../commit/db51d4fe))
+* support deleting branch versions (removing a version from a branch)	 ([661667b3](/../../commit/661667b3))
+* improve error message when request has non UTF-8 characters (#559)	 ([3addc0c8](/../../commit/3addc0c8))
+
+#### Bug Fixes
+
+* add missing environment policy record for use when recording deployments	 ([09bb02a6](/../../commit/09bb02a6))
+* fix bug where pacticipant with blank name was being created instead of updating existing record	 ([be24a8ad](/../../commit/be24a8ad))
+* ensure pacticipant name is retained when updating with PUT	 ([eeac47c3](/../../commit/eeac47c3))
+
+<a name="v2.100.0"></a>
+### v2.100.0 (2022-05-20)
+
+#### Features
+
+* check for potential duplicate pacticipants in publish contracts endpoint (#558)	 ([ed714f03](/../../commit/ed714f03))
+* add support for "can i merge" matrix query	 ([bb108ed2](/../../commit/bb108ed2))
+* remove inefficient skynet query for tags	 ([bdc2599c](/../../commit/bdc2599c))
+* update text for matrix version description when no version is in an enviroment	 ([3eb5581d](/../../commit/3eb5581d))
+
+* **pacts for verification**
+  * update wip and pending descriptions for wip pacts	 ([b06d4477](/../../commit/b06d4477))
+
+* **matrix**
+  * add support for selectors specified by branch and environment name when reporting that a version does not exist	 ([07ff8044](/../../commit/07ff8044))
+
+#### Bug Fixes
+
+* **matrix**
+  * identify the correct failed version when a selector resolves to multiple versions	 ([11e7dc1c](/../../commit/11e7dc1c))
+
 <a name="v2.99.0"></a>
 ### v2.99.0 (2022-05-13)
 

data/Gemfile

@@ -30,6 +30,7 @@ group :test do
   gem "faraday_middleware", "~> 0.14"
   gem "docker-api", "~>1.34"
   gem "approvals", ">=0.0.24", "<1.0.0"
+  gem "tzinfo", "~>2.0"
 end
 
 if ENV["INSTALL_MYSQL"] == "true"

data/README.md

@@ -114,7 +114,17 @@ Use the HAL browser to view documentation as you browse.
 
 ### To have a play around on your local machine
 
-* Install Ruby and Bundler (check the automated tests to find the most recent version of Ruby and Bundler that are supported)
+#### Using Docker Compose
+
+Download a copy of the [example Docker Compose file](https://github.com/pact-foundation/pact-broker-docker/blob/master/docker-compose.yml) from the Pact Broker Docker repository and run:
+
+`docker compose up`
+
+Then open a browser at [http://localhost:9292](http://localhost:9292).
+
+#### Using Ruby
+
+* Install Ruby 2.7 and Bundler (check the automated tests to find the most recent version of Ruby and Bundler that are supported)
     * Windows users: get a Rails/Ruby installer from [RailsInstaller](http://railsinstaller.org/) and run it
     * unix users just use your package manager
 * Run `git clone git@github.com:pact-foundation/pact_broker.git && cd pact_broker/example`
@@ -144,8 +154,8 @@ You can use the [Pact Broker Docker image][docker] or [Terraform on AWS][terrafo
   * To ensure you're on a supported version of the database that you choose, check the [travis.yml][travisyml] file to see which versions we're currently running our tests against.
   * MySQL was supported for the native Ruby application until around 2021, but the official `pactfoundation/pact-broker` Docker image does not support it. New features will not be optimised for MySQL, and some new features may not even be supported on it (eg. the database clean feature).
 * You'll find a sample database creation script in the [example/config.ru](https://github.com/pact-foundation/pact_broker/blob/master/example/config.ru).
-* Install ruby 2.7 or later and the latest version of bundler (if you've come this far, I'm assuming you know how to do both of these. Did I mention there was a [Docker][docker] image?)
-* Copy the [pact\_broker](https://github.com/DiUS/pact_broker-docker/tree/master/pact_broker) directory from the Pact Broker Docker project. This will have the recommended settings for database connections, logging, basic auth etc. Note that the Docker image uses Phusion Passenger as the web application server in front of the Pact Broker Ruby application, which is the recommended set up.
+* Install ruby 2.7 and the latest version of bundler (if you've come this far, I'm assuming you know how to do both of these. Did I mention there was a [Docker][docker] image?)
+* Copy the [pact\_broker](https://github.com/DiUS/pact_broker-docker/tree/master/pact_broker) directory from the Pact Broker Docker project. This will have the recommended settings for database connections, logging, basic auth etc. Note that the Docker image uses Phusion Passenger as the web application server in front of the Pact Broker Ruby application, which is the recommended set up if you are not using a containerized solution.
 * Modify the config.ru and Gemfile as desired (eg. choose database driver gem, set your database credentials. Use the "pg" gem for Postgres)
   * example Sequel configuration for postgres `{ adapter: "postgres", database: "pact_broker", username: 'pact_broker', password: 'pact_broker', :encoding => 'utf8' }`
 * Please ensure you use `encoding: 'utf8'` in your Sequel options to avoid encoding issues.
@@ -169,7 +179,7 @@ The Pact Broker follows the [semantic versioning](https://semver.org/) scheme.
 [terraform]: https://github.com/nadnerb/terraform-pact-broker
 [pactflow]: https://pactflow.io/?utm_source=github&utm_campaign=pact_broker_usage
 [wiki]: https://github.com/pact-foundation/pact_broker/wiki
-[reverse-proxy-docs]: https://github.com/pact-foundation/pact_broker/wiki/Configuration#running-the-broker-behind-a-reverse-proxy
+[reverse-proxy-docs]: https://docs.pact.io/pact_broker/configuration/features#running-the-broker-behind-a-reverse-proxy
 [stackoverflow]: http://stackoverflow.com/questions/tagged/pact-broker
 [twitter]: https://twitter.com/pact_up
 [slack]: https://slack.pact.io/

data/db/migrations/20220622_default_allow_dangerous_contract_modification_to_false_for_new_installations.rb

@@ -0,0 +1,22 @@
+require_relative "migration_helper"
+include PactBroker::MigrationHelper
+
+Sequel.migration do
+  up do
+    # Need to do this again because didn't actually set default of allow_dangerous_contract_modification to true
+    # when the first migration was run in db/migrations/20210810_set_allow_contract_modification.rb
+    for_upgrades_of_existing_installations do
+      from(:config).insert_ignore.insert(
+        name: "allow_dangerous_contract_modification",
+        type: "boolean",
+        value: "1",
+        created_at: Sequel.datetime_class.now,
+        updated_at: Sequel.datetime_class.now
+      )
+    end
+  end
+
+  down do
+
+  end
+end

data/db/migrations/20220625_delete_pacticipants_with_no_name.rb

@@ -0,0 +1,62 @@
+# There was a bug that caused a duplicate pacticipant to be created
+# with a null name when updating the pacticipant in a certain way.
+# It was fixed in be24a8ad650f0ed49993283b22ba1d1a744fb3e8.
+# This migration deletes any pacticipants with null names that are not referenced by any other rows,
+# or assigns a name if the pacticipant is referenced so that it can be deleted through the API
+# (I can't think of a reason why a pacticipant with a null name should be referenced, but better to be safe than sorry).
+# The "find tables that reference pacticipants" logic is done dynamically because Pactflow has extra tables not in the OSS.
+
+# Query each table that references the pacticipants table to determine
+# if there are any rows in it that reference the pacticipant with the specified ID.
+# @return [Boolean]
+def pacticipant_is_unreferenced(pacticipant_id, table_foreign_keys)
+  table_foreign_keys.any? do | (table_name, foreign_keys) |
+    criteria = foreign_keys.flat_map do | fk |
+      fk[:columns].collect do | column_name |
+        { column_name => pacticipant_id }
+      end
+    end
+
+    # SELECT 'one' FROM xxx where consumer_id = x or provider_id = x LIMIT 1
+    !from(table_name).where(Sequel.|(*criteria)).empty?
+  end
+end
+
+# Return a structure describing the tables and columns that reference the pacticipants table.
+# @return [Array] eg. [ [:integrations, [ { columns: [:consumer_id] }, { columns: [:provider_id] } ] ] ]
+def get_table_foreign_keys
+  table_foreign_keys = tables.sort.collect do | table_name |
+    key_list = foreign_key_list(table_name).select{ |fk| fk[:table] == :pacticipants }
+    if key_list.any?
+      [ table_name,  key_list]
+    end
+  end.compact
+
+  # move the integrations table check first because that's the most likely candidate to have a referencing row
+  table_foreign_keys.select{ |(table_name, _)| table_name == :integrations } | table_foreign_keys
+end
+
+# Deletes the pacticipant if it is unreferenced, or populates the name so it can
+# be deleted through the API.
+def delete_pacticipant_or_populate_name(row, table_foreign_keys)
+  if pacticipant_is_unreferenced(row[:id], table_foreign_keys)
+    from(:pacticipants).where(id: row[:id]).delete
+  else
+    from(:pacticipants).where(id: row[:id]).update(name: "Delete me #{row[:id]}")
+  end
+end
+
+Sequel.migration do
+  up do
+
+    table_foreign_keys = get_table_foreign_keys
+
+    from(:pacticipants).where(name: nil).all.each do | row |
+      delete_pacticipant_or_populate_name(row, table_foreign_keys)
+    end
+  end
+
+  down do
+
+  end
+end

data/db/migrations/migration_helper.rb

@@ -3,6 +3,12 @@ module PactBroker
 
     extend self
 
+    def for_upgrades_of_existing_installations
+      if from(:integrations).count > 0
+        yield
+      end
+    end
+
     def large_text_type
       if postgres?
         :text

data/docs/CONFIGURATION.md

@@ -648,10 +648,12 @@ Whether or not to allow the pact content for an existing consumer version to be
 as allowing modification makes the results of can-i-deploy unreliable. When this is set to false as recommended, each commit must publish pacts
 with a unique version number.
 
+If modification of an existing contract is attempted when the value is set to `false`, an HTTP 409 status will be returned.
+
 **Supported versions:** From v2.82.0<br/>
 **Environment variable name:** `PACT_BROKER_ALLOW_DANGEROUS_CONTRACT_MODIFICATION`<br/>
 **YAML configuration key name:** `allow_dangerous_contract_modification`<br/>
-**Default:** For new installations of v2.82.0 and later, this defaults to `false`.<br/>
+**Default:** For new installations of v2.102 and later, this defaults to `false` (the recommended value). Previous installations will have the default value of `true` (not recommended).<br/>
 **Allowed values:** `true`, `false`<br/>
 **More information:** https://docs.pact.io/versioning<br/>
 

data/docs/api/PACTICIPANTS.md

@@ -0,0 +1,290 @@
+
+# Pacticipants
+
+
+## Pacticipant
+
+Path: `/pacticipants/:pacticipant_name`<br/>
+Allowed methods: `GET`, `PUT`, `PATCH`, `DELETE`<br/>
+
+### GET
+
+#### Request
+
+Headers: `{"Accept":"application/hal+json"}`<br/>
+
+
+#### Response
+
+Status: `200`<br/>
+Headers: `{"Content-Type":"application/hal+json;charset=utf-8"}`<br/>
+Body:
+
+```
+{
+  "name": "foo",
+  "displayName": "Foo",
+  "repositoryUrl": "https://github.com/example-organization/foo",
+  "createdAt": "2021-09-01T00:07:21+00:00",
+  "_embedded": {
+    "latestVersion": {
+      "number": "3e1f00a04",
+      "_links": {
+        "self": {
+          "title": "Version",
+          "name": "3e1f00a04",
+          "href": "https://pact-broker/pacticipants/foo/versions/3e1f00a04"
+        }
+      }
+    },
+    "labels": [
+
+    ]
+  },
+  "_links": {
+    "self": {
+      "href": "https://pact-broker/pacticipants/foo"
+    },
+    "pb:versions": {
+      "href": "https://pact-broker/pacticipants/foo/versions"
+    },
+    "pb:version": {
+      "title": "Get, create or delete a pacticipant version",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}",
+      "templated": true
+    },
+    "pb:version-tag": {
+      "title": "Get, create or delete a tag for a version of foo",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}/tags/{tag}",
+      "templated": true
+    },
+    "pb:branch-version": {
+      "title": "Get or add/create a version for a branch of foo",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/versions/{version}",
+      "templated": true
+    },
+    "pb:label": {
+      "title": "Get, create or delete a label for foo",
+      "href": "https://pact-broker/pacticipants/foo/labels/{label}",
+      "templated": true
+    },
+    "pb:can-i-deploy-badge": {
+      "title": "Can I Deploy foo badge",
+      "href": "https://pact-broker/pacticipants/foo/latest-version/{tag}/can-i-deploy/to/{environmentTag}/badge",
+      "templated": true
+    },
+    "pb:can-i-deploy-branch-to-environment-badge": {
+      "title": "Can I Deploy foo from branch to environment badge",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/latest-version/can-i-deploy/to-environment/{environment}/badge",
+      "templated": true
+    },
+    "curies": [
+      {
+        "name": "pb",
+        "href": "https://pact-broker/doc/{rel}?context=pacticipant",
+        "templated": true
+      }
+    ]
+  }
+}
+```
+
+
+### PUT
+
+PUT replaces the entire resource with the specified body, so missing properties will effectively be nulled. Embedded properties (eg. versions) will not be affected.
+
+#### Request
+
+Headers: `{"Content-Type":"application/json","Accept":"application/hal+json"}`<br/>
+Body:
+
+```
+{
+  "displayName": "Foo",
+  "repositoryUrl": "https://github.com/example/foo",
+  "repositoryName": "foo",
+  "repositoryNamespace": "example",
+  "mainBranch": "main"
+}
+```
+
+
+#### Response
+
+Status: `200`<br/>
+Headers: `{"Content-Type":"application/hal+json;charset=utf-8"}`<br/>
+Body:
+
+```
+{
+  "name": "foo",
+  "displayName": "Foo",
+  "repositoryUrl": "https://github.com/example/foo",
+  "repositoryName": "foo",
+  "repositoryNamespace": "example",
+  "mainBranch": "main",
+  "createdAt": "2021-09-01T00:07:21+00:00",
+  "_embedded": {
+    "latestVersion": {
+      "number": "3e1f00a04",
+      "_links": {
+        "self": {
+          "title": "Version",
+          "name": "3e1f00a04",
+          "href": "https://pact-broker/pacticipants/foo/versions/3e1f00a04"
+        }
+      }
+    },
+    "labels": [
+
+    ]
+  },
+  "_links": {
+    "self": {
+      "href": "https://pact-broker/pacticipants/foo"
+    },
+    "pb:versions": {
+      "href": "https://pact-broker/pacticipants/foo/versions"
+    },
+    "pb:version": {
+      "title": "Get, create or delete a pacticipant version",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}",
+      "templated": true
+    },
+    "pb:version-tag": {
+      "title": "Get, create or delete a tag for a version of foo",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}/tags/{tag}",
+      "templated": true
+    },
+    "pb:branch-version": {
+      "title": "Get or add/create a version for a branch of foo",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/versions/{version}",
+      "templated": true
+    },
+    "pb:label": {
+      "title": "Get, create or delete a label for foo",
+      "href": "https://pact-broker/pacticipants/foo/labels/{label}",
+      "templated": true
+    },
+    "pb:can-i-deploy-badge": {
+      "title": "Can I Deploy foo badge",
+      "href": "https://pact-broker/pacticipants/foo/latest-version/{tag}/can-i-deploy/to/{environmentTag}/badge",
+      "templated": true
+    },
+    "pb:can-i-deploy-branch-to-environment-badge": {
+      "title": "Can I Deploy foo from branch to environment badge",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/latest-version/can-i-deploy/to-environment/{environment}/badge",
+      "templated": true
+    },
+    "curies": [
+      {
+        "name": "pb",
+        "href": "https://pact-broker/doc/{rel}?context=pacticipant",
+        "templated": true
+      }
+    ]
+  }
+}
+```
+
+
+### PATCH
+
+PATCH with the Content-Type application/merge-patch+json merges the pacticipant's existing properties with those from the request body. Embedded properties (eg. versions) will not be affected.
+
+#### Request
+
+Headers: `{"Content-Type":"application/merge-patch+json","Accept":"application/hal+json"}`<br/>
+Body:
+
+```
+{
+  "displayName": "Foo",
+  "repositoryUrl": "https://github.com/example/foo",
+  "repositoryName": "foo",
+  "repositoryNamespace": "example",
+  "mainBranch": "main"
+}
+```
+
+
+#### Response
+
+Status: `200`<br/>
+Headers: `{"Content-Type":"application/hal+json;charset=utf-8"}`<br/>
+Body:
+
+```
+{
+  "name": "foo",
+  "displayName": "Foo",
+  "repositoryUrl": "https://github.com/example/foo",
+  "repositoryName": "foo",
+  "repositoryNamespace": "example",
+  "mainBranch": "main",
+  "createdAt": "2021-09-01T00:07:21+00:00",
+  "_embedded": {
+    "latestVersion": {
+      "number": "3e1f00a04",
+      "_links": {
+        "self": {
+          "title": "Version",
+          "name": "3e1f00a04",
+          "href": "https://pact-broker/pacticipants/foo/versions/3e1f00a04"
+        }
+      }
+    },
+    "labels": [
+
+    ]
+  },
+  "_links": {
+    "self": {
+      "href": "https://pact-broker/pacticipants/foo"
+    },
+    "pb:versions": {
+      "href": "https://pact-broker/pacticipants/foo/versions"
+    },
+    "pb:version": {
+      "title": "Get, create or delete a pacticipant version",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}",
+      "templated": true
+    },
+    "pb:version-tag": {
+      "title": "Get, create or delete a tag for a version of foo",
+      "href": "https://pact-broker/pacticipants/foo/versions/{version}/tags/{tag}",
+      "templated": true
+    },
+    "pb:branch-version": {
+      "title": "Get or add/create a version for a branch of foo",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/versions/{version}",
+      "templated": true
+    },
+    "pb:label": {
+      "title": "Get, create or delete a label for foo",
+      "href": "https://pact-broker/pacticipants/foo/labels/{label}",
+      "templated": true
+    },
+    "pb:can-i-deploy-badge": {
+      "title": "Can I Deploy foo badge",
+      "href": "https://pact-broker/pacticipants/foo/latest-version/{tag}/can-i-deploy/to/{environmentTag}/badge",
+      "templated": true
+    },
+    "pb:can-i-deploy-branch-to-environment-badge": {
+      "title": "Can I Deploy foo from branch to environment badge",
+      "href": "https://pact-broker/pacticipants/foo/branches/{branch}/latest-version/can-i-deploy/to-environment/{environment}/badge",
+      "templated": true
+    },
+    "curies": [
+      {
+        "name": "pb",
+        "href": "https://pact-broker/doc/{rel}?context=pacticipant",
+        "templated": true
+      }
+    ]
+  }
+}
+```
+
+