pact_broker-client 1.62.1 → 1.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b538507a19176ca7164ac025f35358738e9d49ab61a41a20d560fee5478cd2f
-  data.tar.gz: 7e562c453ead13f3bceba18f99ff2ed1fd556e9b07de3088038759514ed95a35
+  metadata.gz: b5ce83ded78258ca61aefff4934a129bde296db9e546db32adb5db1f48ebcbc7
+  data.tar.gz: 1ee2e0c2d0b143c5cc97918c4b4cd2bf6d5d7e281450e1eb194f19295a7c1e21
 SHA512:
-  metadata.gz: 18e472c85e88525ef6c3b7714953db64c14bdc55ba6a80f1eb985b50f5c16dcc3f3d743d900b4ed06d7125581e382e10ddf4b8c6df760582b41f5d5b84b28dd7
-  data.tar.gz: 58bac0fbb0772d36cfe57e085ab465a3ff191f0bfb383428d30476a86b44e9ec0514dc77ee6d9f90cf9d4672c0377a8e46e0c324f825375a0aa63674ce0da613
+  metadata.gz: 19f2f40ef25b345cb64e8a392f580cc5eeee4468d6798eb9c008d5b3adf9d1c18f20dee9250d11d22829f368e3ae90ceef24ea28fec233198331e5f11c2dc5cc
+  data.tar.gz: d980e5fb92df5886697851caa30d419bfda19b3c05af8f2e08c23fb54742c960cf7f49d12638e32a739dc3c3590a8ad36e3a102825bc942bfc1a1a493dfeb1a5

data/.github/workflows/test.yml

@@ -9,19 +9,14 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby_version: ["2.2", "2.7"]
+        ruby_version: ["2.7", "3.0", "3.1"]
         experimental: [false]
-        include:
-          - ruby_version: "3.0"
-            experimental: true
     steps:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby_version }}
       - run: "bundle install"
-      - if: failure()
-        run: cat /opt/hostedtoolcache/Ruby/2.2.10/x64/lib/ruby/gems/2.2.0/extensions/x86_64-linux/2.2.0/approvals-0.0.25/gem_make.out && exit 1
       - run: "bundle exec rake"
   pact:
     runs-on: "ubuntu-latest"

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+<a name="v1.65.0"></a>
+### v1.65.0 (2022-06-24)
+
+#### Features
+
+* add support for automatically detecting the git commit and branch for Azure DevOps	 ([889f83f](/../../commit/889f83f))
+
+<a name="v1.64.0"></a>
+### v1.64.0 (2022-05-27)
+
+#### Features
+
+* remove feature flag for publish-provider-contract	 ([146a2d8](/../../commit/146a2d8))
+* add pactflow specific message for environment not found when recording a release/deployment	 ([6667cbb](/../../commit/6667cbb))
+
+<a name="v1.63.0"></a>
+### v1.63.0 (2022-05-10)
+
+#### Features
+
+* add --verification-exit-code to publish-provider-contract command	 ([d35d908](/../../commit/d35d908))
+
 <a name="v1.62.1"></a>
 ### v1.62.1 (2022-05-10)
 

data/Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:2.6-alpine3.12
+FROM ruby:3.1-alpine
 
 RUN apk add --no-cache -X http://dl-cdn.alpinelinux.org/alpine/edge/testing hub
 RUN apk add --update --no-cache git openssh bash

data/README.md

@@ -1,6 +1,6 @@
 # Pact Broker Client
 
-A client for the [Pact Broker](https://docs.pact.io/pact_broker/). Publishes and retrieves pacts, verification results, pacticipants, pacticipant versions and tags. The functionality is available via a CLI, or via Ruby Rake tasks. You can also use the [Pact CLI Docker image](https://hub.docker.com/r/pactfoundation/pact-cli).
+A client for the [Pact Broker](https://docs.pact.io/pact_broker/) and [Pactflow](https://pactflow.io/?utm_source=ossdocs&utm_campaign=pact_broker_client_readme). Publishes and retrieves pacts, pacticipants, pacticipant versions, environments, deployments and releases. Supports publishing provider contracts for Pactflow. The functionality is available via a CLI, or via Ruby Rake tasks. You can also use the [Pact CLI Docker image](https://hub.docker.com/r/pactfoundation/pact-cli).
 
 ![Build status](https://github.com/pact-foundation/pact_broker-client/workflows/Test/badge.svg)
 
@@ -32,6 +32,8 @@ To connect to a Pact Broker that uses custom SSL cerificates, set the environmen
 
 ## Usage - CLI
 
+All commands prefixed with `pact-broker` can be used with the OSS Pact Broker and Pactflow. Commands prefixed with `pactflow` can only be used with Pactflow.
+
 The Pact Broker base URL can be specified either using the environment variable `$PACT_BROKER_BASE_URL` or the `-b` or `--broker-base-url` parameters.
 
 Pact Broker authentication can be performed either using basic auth or a bearer token.
@@ -58,13 +60,17 @@ Options:
               # Repository branch of the consumer version
       [--auto-detect-version-properties], [--no-auto-detect-version-properties]
               # Automatically detect the repository branch from known CI
-                environment variables or git CLI.
+                environment variables or git CLI. Supports Buildkite, Circle
+                CI, Travis CI, GitHub Actions, Jenkins, Hudson, AppVeyor,
+                GitLab, CodeShip, Bitbucket and Azure DevOps.
   -t, [--tag=TAG]
               # Tag name for consumer version. Can be specified multiple
                 times.
   -g, [--tag-with-git-branch], [--no-tag-with-git-branch]
               # Tag consumer version with the name of the current git branch.
-                Default: false
+                Supports Buildkite, Circle CI, Travis CI, GitHub Actions,
+                Jenkins, Hudson, AppVeyor, GitLab, CodeShip, Bitbucket and
+                Azure DevOps. Default: false
       [--build-url=BUILD_URL]
               # The build URL that created the pact
       [--merge], [--no-merge]
@@ -460,7 +466,13 @@ Options:
       [--dry-run], [--no-dry-run]
               # When dry-run is enabled, always exit process with a success
                 code. Can also be enabled by setting the environment variable
-                PACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true.
+                PACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true. This mode is useful when
+                setting up your CI/CD pipeline for the first time, or in a
+                'break glass' situation where you need to knowingly deploy what
+                Pact considers a breaking change. For the second scenario, it
+                is recommended to use the environment variable and just set it
+                for the build required to deploy that particular version, so
+                you don't accidentally leave the dry run mode enabled.
   -b, --broker-base-url=BROKER_BASE_URL
               # The base URL of the Pact Broker
   -u, [--broker-username=BROKER_USERNAME]
@@ -860,6 +872,64 @@ Options:
 
 Generate a UUID for use when calling create-or-update-webhook
 
+### Provider contracts (Pactflow only)
+
+#### publish-provider-contract
+
+```
+Usage:
+  pactflow publish-provider-contract CONTRACT_FILE ... --provider=PROVIDER -a, --provider-app-version=PROVIDER_APP_VERSION -b, --broker-base-url=BROKER_BASE_URL
+
+Options:
+      --provider=PROVIDER
+              # The provider name
+  -a, --provider-app-version=PROVIDER_APP_VERSION
+              # The provider application version
+  -h, [--branch=BRANCH]
+              # Repository branch of the provider version
+  -t, [--tag=TAG]
+              # Tag name for provider version. Can be specified multiple
+                times.
+      [--specification=SPECIFICATION]
+              # The contract specification
+              # Default: oas
+      [--content-type=CONTENT_TYPE]
+              # The content type. eg. application/yml
+      [--verification-success], [--no-verification-success]
+              # Whether or not the self verification passed successfully.
+      [--verification-exit-code=N]
+              # The exit code of the verification process. Can be used instead
+                of --verification-success|--no-verification-success for a
+                simpler build script.
+      [--verification-results=VERIFICATION_RESULTS]
+              # The path to the file containing the output from the
+                verification process
+      [--verification-results-content-type=VERIFICATION_RESULTS_CONTENT_TYPE]
+              # The content type of the verification output eg. text/plain,
+                application/yaml
+      [--verification-results-format=VERIFICATION_RESULTS_FORMAT]
+              # The format of the verification output eg. junit, text
+      [--verifier=VERIFIER]
+              # The tool used to verify the provider contract
+      [--verifier-version=VERIFIER_VERSION]
+              # The version of the tool used to verify the provider contract
+  -o, [--output=OUTPUT]
+              # json or text
+              # Default: text
+  -b, --broker-base-url=BROKER_BASE_URL
+              # The base URL of the Pact Broker
+  -u, [--broker-username=BROKER_USERNAME]
+              # Pact Broker basic auth username
+  -p, [--broker-password=BROKER_PASSWORD]
+              # Pact Broker basic auth password
+  -k, [--broker-token=BROKER_TOKEN]
+              # Pact Broker bearer token
+  -v, [--verbose], [--no-verbose]
+              # Verbose output. Default: false
+```
+
+Publish provider contract to Pactflow
+
 <!-- end-autogenerated-docs -->
 
 ## Usage - Ruby

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

@@ -20,7 +20,7 @@ module PactBroker
             method_option :retry_interval, banner: "SECONDS", type: :numeric, default: 10, required: false, desc: "The time between retries in seconds. Use in conjuction with --retry-while-unknown"
             # Allow limit to be set manually until https://github.com/pact-foundation/pact_broker-client/issues/53 is fixed
             method_option :limit, hide: true
-            method_option :dry_run, type: :boolean, default: false, desc: "When dry-run is enabled, always exit process with a success code. Can also be enabled by setting the environment variable PACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true."
+            method_option :dry_run, type: :boolean, default: false, desc: "When dry-run is enabled, always exit process with a success code. Can also be enabled by setting the environment variable PACT_BROKER_CAN_I_DEPLOY_DRY_RUN=true. This mode is useful when setting up your CI/CD pipeline for the first time, or in a 'break glass' situation where you need to knowingly deploy what Pact considers a breaking change. For the second scenario, it is recommended to use the environment variable and just set it for the build required to deploy that particular version, so you don't accidentally leave the dry run mode enabled."
             shared_authentication_options
 
             def can_i_deploy(*ignored_but_necessary)

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

@@ -14,9 +14,9 @@ module PactBroker
             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 :auto_detect_version_properties, type: :boolean, default: false, desc: "Automatically detect the repository branch from known CI environment variables or git CLI. Supports Buildkite, Circle CI, Travis CI, GitHub Actions, Jenkins, Hudson, AppVeyor, GitLab, CodeShip, Bitbucket and Azure DevOps."
             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 :tag_with_git_branch, aliases: "-g", type: :boolean, default: false, required: false, desc: "Tag consumer version with the name of the current git branch. Supports Buildkite, Circle CI, Travis CI, GitHub Actions, Jenkins, Hudson, AppVeyor, GitLab, CodeShip, Bitbucket and Azure DevOps. 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

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

@@ -64,7 +64,11 @@ module PactBroker
           if environment_exists?
             "Environment '#{environment_name}' is not an available option for recording a deployment of #{pacticipant_name}."
           else
-            "No environment found with name '#{environment_name}'."
+            if is_pactflow?
+              "Environment '#{environment_name}' is not an available option for recording a deployment of #{pacticipant_name}. The environment may not exist, or you may not have the required permissions or team associations to view it."
+            else
+              "No environment found with name '#{environment_name}'."
+            end
           end
         end
 

data/lib/pact_broker/client/git.rb

@@ -13,7 +13,7 @@ CI_COMMIT_REF_NAME https://docs.gitlab.com/ee/ci/variables/predefined_variables.
 CI_BRANCH CI_COMMIT_ID https://documentation.codeship.com/pro/builds-and-configuration/environment-variables/
 bamboo.repository.git.branch https://confluence.atlassian.com/bamboo/bamboo-variables-289277087.html
 BITBUCKET_BRANCH BITBUCKET_COMMIT https://confluence.atlassian.com/bitbucket/variables-in-pipelines-794502608.html
-
+BUILD_SOURCEBRANCHNAME BUILD_SOURCEVERSION Azure
 =end
 
 # Keep in sync with pact-provider-verifier/lib/pact/provider_verifier/git.rb
@@ -25,8 +25,8 @@ module PactBroker
       using PactBroker::Client::HashRefinements
 
       COMMAND = 'git rev-parse --abbrev-ref HEAD'.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}
+      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 BUILD_SOURCEBRANCHNAME}.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_SOURCEVERSION}
       BUILD_URL_ENV_VAR_NAMES = %w{BUILDKITE_BUILD_URL CIRCLE_BUILD_URL TRAVIS_BUILD_WEB_URL BUILD_URL }
 
       def self.commit

data/lib/pact_broker/client/version.rb

@@ -1,5 +1,5 @@
 module PactBroker
   module Client
-    VERSION = '1.62.1'
+    VERSION = '1.65.0'
   end
 end

data/lib/pactflow/client/cli/provider_contract_commands.rb

@@ -8,33 +8,55 @@ module Pactflow
 
         def self.included(thor)
           thor.class_eval do
+            desc 'publish-provider-contract CONTRACT_FILE ...', "Publish provider contract to Pactflow"
+            method_option :provider, required: true, desc: "The provider name"
+            method_option :provider_app_version, required: true, aliases: "-a", desc: "The provider application version"
+            method_option :branch, aliases: "-h", desc: "Repository branch of the provider 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 provider 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 :specification, default: "oas", desc: "The contract specification"
+            method_option :content_type, desc: "The content type. eg. application/yml"
+            method_option :verification_success, type: :boolean, desc: "Whether or not the self verification passed successfully."
+            method_option :verification_exit_code, type: :numeric, desc: "The exit code of the verification process. Can be used instead of --verification-success|--no-verification-success for a simpler build script."
+            method_option :verification_results, desc: "The path to the file containing the output from the verification process"
+            method_option :verification_results_content_type, desc: "The content type of the verification output eg. text/plain, application/yaml"
+            method_option :verification_results_format, desc: "The format of the verification output eg. junit, text"
+            method_option :verifier, desc: "The tool used to verify the provider contract"
+            method_option :verifier_version, desc: "The version of the tool used to verify the provider contract"
+            #method_option :build_url, desc: "The build URL that created the pact"
 
-            if ENV.fetch("PACTFLOW_FEATURES", "").include?("publish-provider-contract")
+            output_option_json_or_text
+            shared_authentication_options
 
-              desc 'publish-provider-contract CONTRACT_FILE ...', "Publish provider contract to Pactflow"
-              method_option :provider, required: true, desc: "The provider name"
-              method_option :provider_app_version, required: true, aliases: "-a", desc: "The provider application version"
-              method_option :branch, aliases: "-h", desc: "Repository branch of the provider 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 provider 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 :specification, default: "oas", desc: "The contract specification"
-              method_option :content_type, desc: "The content type. eg. application/yml"
-              method_option :verification_success, type: :boolean
-              method_option :verification_results, desc: "The path to the file containing the output from the verification process"
-              method_option :verification_results_content_type, desc: "The content type of the verification output eg. text/plain, application/yaml"
-              method_option :verification_results_format, desc: "The format of the verification output eg. junit, text"
-              method_option :verifier, desc: "The tool used to verify the provider contract"
-              method_option :verifier_version, desc: "The version of the tool used to verify the provider contract"
-              #method_option :build_url, desc: "The build URL that created the pact"
+            def publish_provider_contract(provider_contract_path)
+              require "pactflow/client/provider_contracts/publish"
 
-              output_option_json_or_text
-              shared_authentication_options
+              validate_publish_provider_contract_options(provider_contract_path)
+              result = ::Pactflow::Client::ProviderContracts::Publish.call(
+                          publish_provider_contract_command_params(provider_contract_path),
+                          command_options,
+                          pact_broker_client_options
+                        )
+              $stdout.puts result.message
+              exit(1) unless result.success
+            end
+
+            no_commands do
+              def command_options
+                { verbose: options.verbose, output: options.output }
+              end
 
-              def publish_provider_contract(provider_contract_path)
-                require "pactflow/client/provider_contracts/publish"
+              def validate_publish_provider_contract_options(provider_contract_path)
+                if !options.verification_success.nil? && options.verification_exit_code
+                  raise Thor::Error, "Cannot use both --verification-success|--no-verification-success and --verification-exit-code"
+                end
+              end
+
+              def publish_provider_contract_command_params(provider_contract_path)
+                success = !options.verification_success.nil? ? options.verification_success : ( options.verification_exit_code && options.verification_exit_code == 0 )
 
-                params = params = {
+                {
                   provider_name: options.provider.strip,
                   provider_version_number: options.provider_app_version.strip,
                   branch_name: options.branch && options.branch.strip,
@@ -45,7 +67,7 @@ module Pactflow
                     specification: options.specification
                   },
                   verification_results: {
-                    success: options.verification_success,
+                    success: success,
                     content: options.verification_results ? File.read(options.verification_results) : nil,
                     content_type: options.verification_results_content_type,
                     format: options.verification_results_format,
@@ -53,11 +75,6 @@ module Pactflow
                     verifier_version: options.verifier_version
                   }
                 }
-
-                command_options = { verbose: options.verbose, output: options.output }
-                result = ::Pactflow::Client::ProviderContracts::Publish.call(params, command_options, pact_broker_client_options)
-                $stdout.puts result.message
-                exit(1) unless result.success
               end
             end
           end

data/lib/pactflow/client/provider_contracts/publish.rb

@@ -23,7 +23,7 @@ module Pactflow
         def do_call
           create_branch_version_and_tags
           create_contract
-          PactBroker::Client::CommandResult.new(true, green("Successfully published provider contract for #{provider_name} version #{provider_version_number}"))
+          PactBroker::Client::CommandResult.new(true, green("Successfully published provider contract for #{provider_name} version #{provider_version_number} to Pactflow"))
         end
 
         def create_branch_version_and_tags
@@ -58,10 +58,10 @@ module Pactflow
                                         }.compact
 
           body_params = {
-                    content: encode_content(contract[:content]),
-                    contractType: contract[:specification],
-                    contentType: contract[:content_type],
-                  }.compact
+                          content: encode_content(contract[:content]),
+                          contractType: contract[:specification],
+                          contentType: contract[:content_type],
+                        }.compact
 
           if verification_results_params.any?
             body_params[:verificationResults] = verification_results_params

data/script/publish-provider-contract.sh

@@ -1,5 +1,21 @@
-export PACT_BROKER_BASE_URL="http://localhost:9292"
-export PACTFLOW_FEATURES=publish-provider-contract
+export PACT_BROKER_BASE_URL=${PACT_BROKER_BASE_URL:-"http://localhost:9292"}
+bundle exec bin/pactflow publish-provider-contract  \
+  script/oas.yml \
+  --provider Foo \
+  --provider-app-version 1013b5650d61214e19f10558f97fb5a3bb082d44 \
+  --branch main \
+  --tag dev \
+  --specification oas \
+  --content-type application/yml \
+  --verification-exit-code 0 \
+  --verification-results script/verification-results.txt \
+  --verification-results-content-type text/plain \
+  --verification-results-format text \
+  --verifier my-custom-tool \
+  --verifier-version "1.0" \
+  --verbose
+
+
 # bundle exec bin/pactflow publish-provider-contract  \
 #   script/oas.yml \
 #   --provider Foo \
@@ -7,21 +23,5 @@ export PACTFLOW_FEATURES=publish-provider-contract
 #   --branch main \
 #   --tag dev \
 #   --specification oas \
-#   --content-type application/yml \
-#   --no-verification-success \
-#   --verification-results script/verification-results.txt \
-#   --verification-results-content-type text/plain \
-#   --verification-results-format text \
-#   --verifier my-custom-tool \
-#   --verifier-version "1.0" \
-#   --verbose
-
+#   --content-type application/yml
 
-  bundle exec bin/pactflow publish-provider-contract  \
-    script/oas.yml \
-    --provider Foo \
-    --provider-app-version 1013b5650d61214e19f10558f97fb5a3bb082d44 \
-    --branch main \
-    --tag dev \
-    --specification oas \
-    --content-type application/yml

data/script/update-cli-usage-in-readme.rb

@@ -1,12 +1,30 @@
 #!/usr/bin/env ruby
 require "stringio"
 require "pact_broker/client/cli/broker"
+require "pactflow/client/cli/pactflow"
 
 ENV["THOR_COLUMNS"] = "160"
 START_MARKER = "<!-- start-autogenerated-docs -->"
 END_MARKER = "<!-- end-autogenerated-docs -->"
 TERMINAL_WIDTH = 80
 
+PACT_BROKER_COMMAND_GROUPS = [
+  [PactBroker::Client::CLI::Broker, "Pacts", %w[publish list-latest-pact-versions] ],
+  [PactBroker::Client::CLI::Broker, "Environments", %w[create-environment update-environment describe-environment delete-environment list-environments]],
+  [PactBroker::Client::CLI::Broker, "Deployments", %w[record-deployment record-undeployment]],
+  [PactBroker::Client::CLI::Broker, "Releases", %w[record-release record-support-ended]],
+  [PactBroker::Client::CLI::Broker, "Matrix", %w[can-i-deploy]],
+  [PactBroker::Client::CLI::Broker, "Pacticipants", %w[create-or-update-pacticipant describe-pacticipant list-pacticipants]],
+  [PactBroker::Client::CLI::Broker, "Webhooks", %w[create-webhook create-or-update-webhook test-webhook]],
+  [PactBroker::Client::CLI::Broker, "Tags", %w[create-version-tag]],
+  [PactBroker::Client::CLI::Broker, "Versions", %w[describe-version create-or-update-version]],
+  [PactBroker::Client::CLI::Broker, "Miscellaneous", %w[generate-uuid]]
+]
+
+PACTFLOW_COMMAND_GROUPS = [
+  [Pactflow::Client::CLI::Pactflow, "Provider contracts (Pactflow only)", %w[publish-provider-contract]]
+]
+
 def print_wrapped(message, options = {})
   out = StringIO.new
   indent = options[:indent] || 0
@@ -44,29 +62,16 @@ def format_banner(banner)
   banner_lines
 end
 
-def generate_thor_docs
+def generate_thor_docs(command_groups)
   begin
     out = StringIO.new
     $stdout = out
 
-    command_groups = [
-      ["Pacts", %w[publish list-latest-pact-versions] ],
-      ["Environments", %w[create-environment update-environment describe-environment delete-environment list-environments]],
-      ["Deployments", %w[record-deployment record-undeployment]],
-      ["Releases", %w[record-release record-support-ended]],
-      ["Matrix", %w[can-i-deploy]],
-      ["Pacticipants", %w[create-or-update-pacticipant describe-pacticipant list-pacticipants]],
-      ["Webhooks", %w[create-webhook create-or-update-webhook test-webhook]],
-      ["Tags", %w[create-version-tag]],
-      ["Versions", %w[describe-version create-or-update-version]],
-      ["Miscellaneous", %w[generate-uuid]]
-    ]
-
-    command_groups.collect do | group, commands |
+    command_groups.collect do | cli, group, commands |
       puts "### #{group}\n\n"
       commands.each do | command |
         puts "#### #{command}\n\n"
-        PactBroker::Client::CLI::Broker.start(["help", command])
+        cli.start(["help", command])
         puts "\n"
       end
     end
@@ -110,7 +115,7 @@ end
 @current_state = :start
 @old_state = nil
 
-def reformat_docs(generated_thor_docs)
+def reformat_docs(generated_thor_docs, command)
   generated_thor_docs.split("\n").collect do | line |
     @old_state = @current_state
 
@@ -142,7 +147,7 @@ def reformat_docs(generated_thor_docs)
     .collect { | line | line.gsub(/\s+$/, "") }
     .join("\n")
     .gsub("/go/", "/")
-    .gsub(File.basename(__FILE__), "pact-broker")
+    .gsub(File.basename(__FILE__), command)
 end
 
 def update_readme(usage_docs)
@@ -153,4 +158,7 @@ def update_readme(usage_docs)
   File.open("README.md", "w") { |file| file << new_readme_text }
 end
 
-update_readme(reformat_docs(generate_thor_docs))
+pact_broker_docs = reformat_docs(generate_thor_docs(PACT_BROKER_COMMAND_GROUPS), "pact-broker")
+pactflow_docs = reformat_docs(generate_thor_docs(PACTFLOW_COMMAND_GROUPS), "pactflow")
+
+update_readme(pact_broker_docs + "\n\n" + pactflow_docs)

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

@@ -164,6 +164,15 @@ module PactBroker
                 expect(subject.success).to be false
                 expect(subject.message).to include "No environment found with name 'test'. Available options: prod"
               end
+
+              context "when the server is Pactflow" do
+                let(:index_headers) { { "Content-Type" => "application/hal+json", "X-Pactflow-Sha" => "123" } }
+
+                it "returns a customised message" do
+                  expect(subject.message).to include "Environment 'test' is not an available option for recording a deployment of Foo"
+                  expect(subject.message).to include "permissions"
+                end
+              end
             end
 
             context "when the environment does exist" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pact_broker-client
 version: !ruby/object:Gem::Version
-  version: 1.62.1
+  version: 1.65.0
 platform: ruby
 authors:
 - Beth Skurrie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-10 00:00:00.000000000 Z
+date: 2022-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -438,7 +438,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.13
+rubygems_version: 3.3.16
 signing_key:
 specification_version: 4
 summary: See description