pact_broker-client 1.58.0 → 1.61.0

data/lib/pact_broker/client/base_client.rb

@@ -125,7 +125,7 @@ module PactBroker
             end
             url
           else
-            raise PactBroker::Client::RelationNotFound.new("Could not find relation #{relation_name} in index resource. Try upgrading your Pact Broker as the feature you require may not exist in your version.")
+            raise PactBroker::Client::RelationNotFound.new("Could not find relation #{relation_name} in index resource. Try upgrading your Pact Broker as the feature you require may not exist in your version. If you are using Pactflow, you may not have the permissions required for this action.")
           end
         end
       end

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

@@ -1,228 +1,44 @@
-require 'pact_broker/client/cli/custom_thor'
-require 'pact_broker/client/hash_refinements'
-require 'thor/error'
-require 'pact_broker/client/cli/environment_commands'
-require 'pact_broker/client/cli/deployment_commands'
-require 'pact_broker/client/cli/pacticipant_commands'
-require 'pact_broker/client/cli/webhook_commands'
+require "pact_broker/client/cli/custom_thor"
+require "pact_broker/client/hash_refinements"
+require "thor/error"
+require "pact_broker/client/cli/pact_commands"
+require "pact_broker/client/cli/environment_commands"
+require "pact_broker/client/cli/deployment_commands"
+require "pact_broker/client/cli/pacticipant_commands"
+require "pact_broker/client/cli/version_commands"
+require "pact_broker/client/cli/webhook_commands"
 require "pact_broker/client/cli/matrix_commands"
 
 module PactBroker
   module Client
     module CLI
-      # Thor::Error will have its backtrace hidden
-      class PactPublicationError < ::Thor::Error; end
-      class AuthError < ::Thor::Error; end
-      class VersionCreationError < ::Thor::Error; end
-
       class Broker < CustomThor
-        using PactBroker::Client::HashRefinements
-
+        include PactBroker::Client::CLI::PactCommands
         include PactBroker::Client::CLI::EnvironmentCommands
         include PactBroker::Client::CLI::DeploymentCommands
         include PactBroker::Client::CLI::MatrixCommands
         include PactBroker::Client::CLI::PacticipantCommands
+        include PactBroker::Client::CLI::VersionCommands
         include PactBroker::Client::CLI::WebhookCommands
 
-        desc 'publish PACT_DIRS_OR_FILES ...', "Publish pacts to a Pact Broker."
-        method_option :consumer_app_version, required: true, aliases: "-a", desc: "The consumer application version"
-        method_option :branch, aliases: "-h", desc: "Repository branch of the consumer version"
-        method_option :auto_detect_version_properties, hidden: true, type: :boolean, default: false, desc: "Automatically detect the repository branch from known CI environment variables or git CLI."
-        method_option :tag, aliases: "-t", type: :array, banner: "TAG", desc: "Tag name for consumer version. Can be specified multiple times."
-        method_option :tag_with_git_branch, aliases: "-g", type: :boolean, default: false, required: false, desc: "Tag consumer version with the name of the current git branch. Default: false"
-        method_option :build_url, desc: "The build URL that created the pact"
-        method_option :merge, type: :boolean, default: false, require: false, desc: "If a pact already exists for this consumer version and provider, merge the contents. Useful when running Pact tests concurrently on different build nodes."
-        output_option_json_or_text
-        shared_authentication_options
-
-        def publish(*pact_files)
-          require 'pact_broker/client/error'
-          validate_credentials
-          validate_pact_files(pact_files)
-          result = publish_pacts(pact_files)
-          $stdout.puts result.message
-          exit(1) unless result.success
-        rescue PactBroker::Client::Error => e
-          raise PactPublicationError, "#{e.class} - #{e.message}"
-        end
-
-        desc 'create-version-tag', 'Add a tag to a pacticipant version'
-        method_option :pacticipant, required: true, aliases: "-a", desc: "The pacticipant name"
-        method_option :version, required: true, aliases: "-e", desc: "The pacticipant version"
-        method_option :tag, aliases: "-t", type: :array, banner: "TAG", desc: "Tag name for pacticipant version. Can be specified multiple times."
-        method_option :auto_create_version, type: :boolean, default: false, desc: "Automatically create the pacticipant version if it does not exist. Default: false"
-        method_option :tag_with_git_branch, aliases: "-g", type: :boolean, default: false, required: false, desc: "Tag pacticipant version with the name of the current git branch. Default: false"
-        shared_authentication_options
-
-        def create_version_tag
-          require 'pact_broker/client/create_tag'
-
-          validate_credentials
-          PactBroker::Client::CreateTag.call(
-            options.broker_base_url,
-            options.pacticipant,
-            options.version,
-            tags,
-            options.auto_create_version,
-            pact_broker_client_options)
-        rescue PactBroker::Client::Error => e
-          raise VersionCreationError.new(e.message)
-        end
-
-        method_option :pacticipant, required: true, aliases: "-a", desc: "The name of the pacticipant that the version belongs to."
-        method_option :version, required: false, aliases: "-e", desc: "The pacticipant version number."
-        method_option :latest, required: false, aliases: "-l", banner: '[TAG]', desc: "Describe the latest pacticipant version. Optionally specify a TAG to describe the latest version with the specified tag."
-        method_option :output, aliases: "-o", desc: "json or table or id", default: 'table'
-        shared_authentication_options
-
-        desc 'describe-version', 'Describes a pacticipant version. If no version or tag is specified, the latest version is described.'
-        def describe_version
-          require 'pact_broker/client/versions/describe'
-
-          validate_credentials
-          latest = !options.latest.nil? || (options.latest.nil? && options.version.nil?)
-          params = {
-            pacticipant: options.pacticipant,
-            version: options.version,
-            latest: latest,
-            tag: options.latest != "latest" ? options.latest : nil
-          }
-          opts = {
-            output: options.output
-          }
-          result = PactBroker::Client::Versions::Describe.call(params, opts, options.broker_base_url, pact_broker_client_options)
-          $stdout.puts result.message
-          exit(1) unless result.success
-        end
-
-
-
         ignored_and_hidden_potential_options_from_environment_variables
-        desc 'generate-uuid', 'Generate a UUID for use when calling create-or-update-webhook'
+        desc "generate-uuid", "Generate a UUID for use when calling create-or-update-webhook"
         def generate_uuid
-          require 'securerandom'
-
+          require "securerandom"
           puts SecureRandom.uuid
         end
 
-        desc 'list-latest-pact-versions', 'List the latest pact for each integration'
-        shared_authentication_options
-        output_option_json_or_table
-        def list_latest_pact_versions(*required_but_ignored)
-          require 'pact_broker/client/pacts/list_latest_versions'
-          result = PactBroker::Client::Pacts::ListLatestVersions.call(options.broker_base_url, options.output, pact_broker_client_options)
-          $stdout.puts result.message
-          exit(1) unless result.success
-        end
-
         ignored_and_hidden_potential_options_from_environment_variables
-        desc 'version', "Show the pact_broker-client gem version"
+        desc "version", "Show the pact_broker-client gem version"
         def version
-          require 'pact_broker/client/version'
-
+          require "pact_broker/client/version"
           $stdout.puts PactBroker::Client::VERSION
         end
 
         no_commands do
-
           def self.exit_on_failure?
             true
           end
-
-          def validate_credentials
-            if options.broker_username && options.broker_token
-              raise AuthError, "You cannot provide both a username/password and a bearer token. If your Pact Broker uses a bearer token, please remove the username and password configuration."
-            end
-          end
-
-          def validate_pact_files pact_files
-            unless pact_files && pact_files.any?
-              raise ::Thor::RequiredArgumentMissingError, "No value provided for required pact_files"
-            end
-          end
-
-
-          def publish_pacts pact_files
-            require 'pact_broker/client/publish_pacts'
-
-            write_options = options[:merge] ? { write: :merge } : {}
-            consumer_version_params = {
-              number: options.consumer_app_version,
-              branch: branch,
-              tags: tags,
-              build_url: options.build_url,
-              version_required: (!!options.branch || !!options.build_url || explict_auto_detect_version_properties)
-            }.compact
-
-            PactBroker::Client::PublishPacts.call(
-              options.broker_base_url,
-              file_list(pact_files),
-              consumer_version_params,
-              { merge: options[:merge], output: options.output }.compact,
-              pact_broker_client_options.merge(write_options)
-            )
-          end
-
-          def file_list pact_files
-            require 'rake/file_list'
-
-            correctly_separated_pact_files = pact_files.collect{ |path| path.gsub(/\\+/, '/') }
-            paths = Rake::FileList[correctly_separated_pact_files].collect do | path |
-              if File.directory?(path)
-                Rake::FileList[File.join(path, "*.json")]
-              else
-                path
-              end
-            end.flatten
-            validate_pact_path_list(paths)
-          end
-
-          def validate_pact_path_list(paths)
-            paths.collect do | path |
-              if File.exist?(path)
-                path
-              elsif path.start_with?("-")
-                raise Thor::Error.new("ERROR: pact-broker publish was called with invalid arguments #{[path]}")
-              else
-                raise Thor::Error.new("Specified pact file '#{path}' does not exist. This sometimes indicates one of the arguments has been specified with the wrong name and has been incorrectly identified as a file path.")
-              end
-            end
-          end
-
-          def tags
-            require 'pact_broker/client/git'
-
-            t = [*options.tag]
-            t << PactBroker::Client::Git.branch(raise_error: true) if options.tag_with_git_branch
-            t.compact.uniq
-          end
-
-          def branch
-            require 'pact_broker/client/git'
-
-            if options.branch.nil? && options.auto_detect_version_properties
-              PactBroker::Client::Git.branch(raise_error: explict_auto_detect_version_properties)
-            else
-              options.branch
-            end
-          end
-
-          def explict_auto_detect_version_properties
-            @explict_auto_detect_version_properties ||= ARGV.include?("--auto-detect-version-properties")
-          end
-
-          def pact_broker_client_options
-            client_options = { verbose: options.verbose, pact_broker_base_url: options.broker_base_url }
-            client_options[:token] = options.broker_token || ENV['PACT_BROKER_TOKEN']
-            if options.broker_username || ENV['PACT_BROKER_USERNAME']
-              client_options[:basic_auth] = {
-                  username: options.broker_username || ENV['PACT_BROKER_USERNAME'],
-                  password: options.broker_password || ENV['PACT_BROKER_PASSWORD']
-                }.compact
-            end
-
-            client_options.compact
-          end
         end
       end
     end

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

@@ -1,14 +1,18 @@
 require 'thor'
+require 'pact_broker/client/hash_refinements'
 
 module PactBroker
   module Client
     module CLI
+      class AuthError < ::Thor::Error; end
+
       ##
       # Custom Thor task allows the following:
       #
       # `--option 1 --option 2` to be interpreted as `--option 1 2` (the standard Thor format for multiple value options)
       #
       class CustomThor < ::Thor
+        using PactBroker::Client::HashRefinements
 
         no_commands do
           def self.start given_args = ARGV, config = {}
@@ -106,6 +110,25 @@ module PactBroker
           def params_from_options(keys)
             keys.each_with_object({}) { | key, p | p[key] = options[key] }
           end
+
+          def pact_broker_client_options
+            client_options = { verbose: options.verbose, pact_broker_base_url: options.broker_base_url }
+            client_options[:token] = options.broker_token || ENV['PACT_BROKER_TOKEN']
+            if options.broker_username || ENV['PACT_BROKER_USERNAME']
+              client_options[:basic_auth] = {
+                  username: options.broker_username || ENV['PACT_BROKER_USERNAME'],
+                  password: options.broker_password || ENV['PACT_BROKER_PASSWORD']
+                }.compact
+            end
+
+            client_options.compact
+          end
+
+          def validate_credentials
+            if options.broker_username && options.broker_token
+              raise AuthError, "You cannot provide both a username/password and a bearer token. If your Pact Broker uses a bearer token, please remove the username and password configuration."
+            end
+          end
         end
       end
     end

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

@@ -0,0 +1,128 @@
+require "pact_broker/client/hash_refinements"
+
+module PactBroker
+  module Client
+    module CLI
+      # Thor::Error will have its backtrace hidden
+      class PactPublicationError < ::Thor::Error; end
+
+      module PactCommands
+        using PactBroker::Client::HashRefinements
+
+        def self.included(thor)
+          thor.class_eval do
+            desc 'publish PACT_DIRS_OR_FILES ...', "Publish pacts to a Pact Broker."
+            method_option :consumer_app_version, required: true, aliases: "-a", desc: "The consumer application version"
+            method_option :branch, aliases: "-h", desc: "Repository branch of the consumer version"
+            method_option :auto_detect_version_properties, hidden: true, type: :boolean, default: false, desc: "Automatically detect the repository branch from known CI environment variables or git CLI."
+            method_option :tag, aliases: "-t", type: :array, banner: "TAG", desc: "Tag name for consumer version. Can be specified multiple times."
+            method_option :tag_with_git_branch, aliases: "-g", type: :boolean, default: false, required: false, desc: "Tag consumer version with the name of the current git branch. Default: false"
+            method_option :build_url, desc: "The build URL that created the pact"
+            method_option :merge, type: :boolean, default: false, require: false, desc: "If a pact already exists for this consumer version and provider, merge the contents. Useful when running Pact tests concurrently on different build nodes."
+            output_option_json_or_text
+            shared_authentication_options
+
+            def publish(*pact_files)
+              require 'pact_broker/client/error'
+              validate_credentials
+              validate_pact_files(pact_files)
+              result = publish_pacts(pact_files)
+              $stdout.puts result.message
+              exit(1) unless result.success
+            rescue PactBroker::Client::Error => e
+              raise PactPublicationError, "#{e.class} - #{e.message}"
+            end
+
+            desc 'list-latest-pact-versions', 'List the latest pact for each integration'
+            shared_authentication_options
+            output_option_json_or_table
+            def list_latest_pact_versions(*required_but_ignored)
+              require 'pact_broker/client/pacts/list_latest_versions'
+              result = PactBroker::Client::Pacts::ListLatestVersions.call(options.broker_base_url, options.output, pact_broker_client_options)
+              $stdout.puts result.message
+              exit(1) unless result.success
+            end
+
+            no_commands do
+              def validate_pact_files pact_files
+                unless pact_files && pact_files.any?
+                  raise ::Thor::RequiredArgumentMissingError, "No value provided for required pact_files"
+                end
+              end
+
+
+              def publish_pacts pact_files
+                require 'pact_broker/client/publish_pacts'
+
+                write_options = options[:merge] ? { write: :merge } : {}
+                consumer_version_params = {
+                  number: options.consumer_app_version,
+                  branch: branch,
+                  tags: tags,
+                  build_url: options.build_url,
+                  version_required: (!!options.branch || !!options.build_url || explict_auto_detect_version_properties)
+                }.compact
+
+                PactBroker::Client::PublishPacts.call(
+                  options.broker_base_url,
+                  file_list(pact_files),
+                  consumer_version_params,
+                  { merge: options[:merge], output: options.output }.compact,
+                  pact_broker_client_options.merge(write_options)
+                )
+              end
+
+              def file_list pact_files
+                require 'rake/file_list'
+
+                correctly_separated_pact_files = pact_files.collect{ |path| path.gsub(/\\+/, '/') }
+                paths = Rake::FileList[correctly_separated_pact_files].collect do | path |
+                  if File.directory?(path)
+                    Rake::FileList[File.join(path, "*.json")]
+                  else
+                    path
+                  end
+                end.flatten
+                validate_pact_path_list(paths)
+              end
+
+              def validate_pact_path_list(paths)
+                paths.collect do | path |
+                  if File.exist?(path)
+                    path
+                  elsif path.start_with?("-")
+                    raise Thor::Error.new("ERROR: pact-broker publish was called with invalid arguments #{[path]}")
+                  else
+                    raise Thor::Error.new("Specified pact file '#{path}' does not exist. This sometimes indicates one of the arguments has been specified with the wrong name and has been incorrectly identified as a file path.")
+                  end
+                end
+              end
+
+              def tags
+                require 'pact_broker/client/git'
+
+                t = [*options.tag]
+                t << PactBroker::Client::Git.branch(raise_error: true) if options.tag_with_git_branch
+                t.compact.uniq
+              end
+
+              def branch
+                require 'pact_broker/client/git'
+
+                if options.branch.nil? && options.auto_detect_version_properties
+                  PactBroker::Client::Git.branch(raise_error: explict_auto_detect_version_properties)
+                else
+                  options.branch
+                end
+              end
+
+              def explict_auto_detect_version_properties
+                @explict_auto_detect_version_properties ||= ARGV.include?("--auto-detect-version-properties")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,102 @@
+module PactBroker
+  module Client
+    module CLI
+      class VersionCreationError < ::Thor::Error; end
+
+      module VersionCommands
+        def self.included(thor)
+          thor.class_eval do
+            method_option :pacticipant, required: true, aliases: "-a", desc: "The name of the pacticipant that the version belongs to."
+            method_option :version, required: false, aliases: "-e", desc: "The pacticipant version number."
+            method_option :latest, required: false, aliases: "-l", banner: '[TAG]', desc: "Describe the latest pacticipant version. Optionally specify a TAG to describe the latest version with the specified tag."
+            method_option :output, aliases: "-o", desc: "json or table or id", default: 'table'
+            shared_authentication_options
+
+            desc 'describe-version', 'Describes a pacticipant version. If no version or tag is specified, the latest version is described.'
+            def describe_version
+              require 'pact_broker/client/versions/describe'
+
+              validate_credentials
+              latest = !options.latest.nil? || (options.latest.nil? && options.version.nil?)
+              params = {
+                pacticipant: options.pacticipant,
+                version: options.version,
+                latest: latest,
+                tag: options.latest != "latest" ? options.latest : nil
+              }
+              opts = {
+                output: options.output
+              }
+              result = PactBroker::Client::Versions::Describe.call(params, opts, options.broker_base_url, pact_broker_client_options)
+              $stdout.puts result.message
+              exit(1) unless result.success
+            end
+
+
+            desc "create-or-update-version", "Create or update pacticipant version by version number"
+            method_option :pacticipant, required: true, aliases: "-a", desc: "The pacticipant name"
+            method_option :version, required: true, aliases: "-e", desc: "The pacticipant version number"
+            method_option :branch, required: false, desc: "The repository branch name"
+            method_option :tag, aliases: "-t", type: :array, banner: "TAG", desc: "Tag name for pacticipant version. Can be specified multiple times."
+            shared_authentication_options
+            output_option_json_or_text
+            verbose_option
+
+            def create_or_update_version(*required_but_ignored)
+              validate_create_version_params
+
+              params = {
+                pacticipant_name: options.pacticipant.strip,
+                version_number: options.version.strip,
+                branch_name: options.branch&.strip,
+                tags: options.tag&.collect(&:strip)
+              }
+
+              execute_version_command(params, "Create")
+            end
+
+            desc 'create-version-tag', 'Add a tag to a pacticipant version'
+            method_option :pacticipant, required: true, aliases: "-a", desc: "The pacticipant name"
+            method_option :version, required: true, aliases: "-e", desc: "The pacticipant version"
+            method_option :tag, aliases: "-t", type: :array, banner: "TAG", desc: "Tag name for pacticipant version. Can be specified multiple times."
+            method_option :auto_create_version, type: :boolean, default: false, desc: "Automatically create the pacticipant version if it does not exist. Default: false"
+            method_option :tag_with_git_branch, aliases: "-g", type: :boolean, default: false, required: false, desc: "Tag pacticipant version with the name of the current git branch. Default: false"
+            shared_authentication_options
+
+            def create_version_tag
+              require 'pact_broker/client/create_tag'
+
+              validate_credentials
+              PactBroker::Client::CreateTag.call(
+                options.broker_base_url,
+                options.pacticipant,
+                options.version,
+                tags,
+                options.auto_create_version,
+                pact_broker_client_options)
+            rescue PactBroker::Client::Error => e
+              raise VersionCreationError.new(e.message)
+            end
+
+            no_commands do
+              def execute_version_command(params, command_class_name)
+                require "pact_broker/client/versions"
+                command_options = { verbose: options.verbose, output: options.output }
+                result = PactBroker::Client::Versions.const_get(command_class_name).call(params, command_options, pact_broker_client_options)
+                $stdout.puts result.message
+                exit(1) unless result.success
+              end
+
+              def validate_create_version_params
+                raise ::Thor::RequiredArgumentMissingError, "Pacticipant name cannot be blank" if options.pacticipant.strip.size == 0
+                raise ::Thor::RequiredArgumentMissingError, "Pacticipant version cannot be blank" if options.version.strip.size == 0
+                raise ::Thor::RequiredArgumentMissingError, "Version branch cannot be blank" if options.branch && options.branch.strip.size == 0
+                raise ::Thor::RequiredArgumentMissingError, "Version tag cannot be blank" if options.tag && options.tag.any?{ | tag | tag.strip.size == 0 }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,9 +1,12 @@
 require 'pact_broker/client/deployments/record_release'
+require "pact_broker/client/hash_refinements"
 
 module PactBroker
   module Client
     module Deployments
       class RecordDeployment < PactBroker::Client::Deployments::RecordRelease
+        using PactBroker::Client::HashRefinements
+
         def initialize(params, options, pact_broker_client_options)
           super
           @application_instance = params.fetch(:application_instance)

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

@@ -1,9 +1,12 @@
 require 'pact_broker/client/base_command'
+require 'pact_broker/client/hash_refinements'
 
 module PactBroker
   module Client
     module Deployments
       class RecordUndeployment < PactBroker::Client::BaseCommand
+        using PactBroker::Client::HashRefinements
+
         def initialize(params, options, pact_broker_client_options)
           super
           @pacticipant_name = params.fetch(:pacticipant_name)

data/lib/pact_broker/client/environments/environment_command.rb

@@ -1,9 +1,12 @@
 require 'pact_broker/client/base_command'
+require 'pact_broker/client/hash_refinements'
 
 module PactBroker
   module Client
     module Environments
       class EnvironmentCommand < PactBroker::Client::BaseCommand
+        using PactBroker::Client::HashRefinements
+
         NOT_SUPPORTED_MESSAGE = "This version of the Pact Broker does not support environments. Please upgrade to version 2.80.0 or later."
         PACTFLOW_NOT_SUPPORTED_MESSAGE = "This version of Pactflow does not support environments or you do not have the required permission to read them. Please upgrade to the latest version if using Pactflow On-Premises and ensure the user has the environment read permission."
 

data/lib/pact_broker/client/git.rb

@@ -25,7 +25,7 @@ module PactBroker
       using PactBroker::Client::HashRefinements
 
       COMMAND = 'git rev-parse --abbrev-ref HEAD'.freeze
-      BRANCH_ENV_VAR_NAMES = %w{GITHUB_REF BUILDKITE_BRANCH CIRCLE_BRANCH TRAVIS_BRANCH GIT_BRANCH GIT_LOCAL_BRANCH APPVEYOR_REPO_BRANCH CI_COMMIT_REF_NAME BITBUCKET_BRANCH}.freeze
+      BRANCH_ENV_VAR_NAMES = %w{GITHUB_HEAD_REF GITHUB_REF BUILDKITE_BRANCH CIRCLE_BRANCH TRAVIS_BRANCH GIT_BRANCH GIT_LOCAL_BRANCH APPVEYOR_REPO_BRANCH CI_COMMIT_REF_NAME BITBUCKET_BRANCH}.freeze
       COMMIT_ENV_VAR_NAMES = %w{GITHUB_SHA BUILDKITE_COMMIT CIRCLE_SHA1 TRAVIS_COMMIT GIT_COMMIT APPVEYOR_REPO_COMMIT CI_COMMIT_ID BITBUCKET_COMMIT}
       BUILD_URL_ENV_VAR_NAMES = %w{BUILDKITE_BUILD_URL CIRCLE_BUILD_URL TRAVIS_BUILD_WEB_URL BUILD_URL }
 

data/lib/pact_broker/client/hal/entity.rb

@@ -91,11 +91,11 @@ module PactBroker
         end
 
         def _link!(key)
-          _link(key) or raise RelationNotFoundError.new("Could not find relation '#{key}' in resource at #{@href}")
+          _link(key) or raise RelationNotFoundError.new(relation_not_found_error_message(key, @href))
         end
 
         def _links!(key)
-          _links(key) or raise RelationNotFoundError.new("Could not find relation '#{key}' in resource at #{@href}")
+          _links(key) or raise RelationNotFoundError.new(relation_not_found_error_message(key, @href))
         end
 
         def embedded_entity
@@ -161,6 +161,10 @@ module PactBroker
         def self_href(entity_hash)
           entity_hash["_links"] && entity_hash["_links"]["self"] && entity_hash["_links"]["self"]["href"]
         end
+
+        def relation_not_found_error_message(key, href)
+          "Could not find relation '#{key}' in resource at #{href}. The most likely reason for this is that you are on an old version of the Pact Broker and you need to upgrade, or you are using Pactflow and you don't have the permissions required for this action."
+        end
       end
 
       class ErrorEntity < Entity

data/lib/pact_broker/client/hal/links.rb

@@ -1,10 +1,13 @@
 require 'uri'
 require 'delegate'
+require 'pact_broker/client/hash_refinements'
 
 module PactBroker
   module Client
     module Hal
       class Links
+        using PactBroker::Client::HashRefinements
+
         def initialize(href, key, links)
           @href = href
           @key = key

data/lib/pact_broker/client/hash_refinements.rb

@@ -13,6 +13,15 @@ module PactBroker
         def compact!
           reject! {|_key, value| value == nil}
         end unless Hash.method_defined? :compact!
+
+        def except(*keys)
+          if keys.size > 4 && size > 4 # index if O(m*n) is big
+            h = {}
+            keys.each { |key| h[key] = true }
+            keys = h
+          end
+          reject { |key, _value| keys.include? key}
+        end unless method_defined? :except
       end
     end
   end