pact_broker-client 1.59.0 → 1.61.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2804ada47fb99f8b84e46b666b3c020e69dd141910e2c4e43f1c90e0a74ebc90
-  data.tar.gz: 55cd1049f68154283ce136834a67aef813bae036139730e89c2c11d8a74a7d7e
+  metadata.gz: 302e6410c4705e3215f63cd3cde0d0f776f2509e06f286fd7dfc3ae6f7762fef
+  data.tar.gz: af9abb55766a45839a59bebfb2dd4eb93698a3f12f207a24e94c8e93219ecc57
 SHA512:
-  metadata.gz: ae440024fcc4e5aab79d3b23c42e4419d36c4c5a35c1d09964c2887c47a2c8dbd4a3043d510536ed2a31935cb1adccc4554ba4a2a36d9b6af369ae322f84b1be
-  data.tar.gz: 7d555adb6428fe3cf3a3e642ca18ff202f9976036b4de02c683a25bbf56eaa64c5cb9cd3946c55ed8baff25a0a675c2e8a8a84497b2786c2b9fca1f26eef50c3
+  metadata.gz: 7cdd9bffc84f8c5ff9a012732510dd9a5df4afe1d8c9bfe538b7173d1b92382982ce4ecde02a57b8fc2968ce83a7c4c6e882f882d9c872a48dcf329f97b059e0
+  data.tar.gz: 3739ba7cd7295b088f5ff0b457c37f7eeb93ce4e03dc1e826b4f924e216d90ae00c04f8def2e32cf8a440f8ad3ea907da2e17908021b17d1b9231df736c6ae7d

data/.github/workflows/release_gem.yml

@@ -31,7 +31,7 @@ jobs:
     - uses: actions/checkout@v2
       with:
         fetch-depth: 0
-    - uses: pact-foundation/release-gem@v0.0.12
+    - uses: pact-foundation/release-gem@v0.0.13
       id: release
       env:
         GEM_HOST_API_KEY: '${{ secrets.RUBYGEMS_API_KEY }}'

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+<a name="v1.61.1"></a>
+### v1.61.1 (2022-05-09)
+
+#### Bug Fixes
+
+* Aushm use ruby 2.2 syntax (#110)	 ([b006ad7](/../../commit/b006ad7))
+
+<a name="v1.61.0"></a>
+### v1.61.0 (2022-05-06)
+
+#### Features
+
+* **create-or-update-version**
+  * support creating or updating a pacticipant version with a branch and/or tags	 ([e38e728](/../../commit/e38e728))
+
+<a name="v1.60.0"></a>
+### v1.60.0 (2022-05-03)
+
+#### Features
+
+* support merging message pacts when publishing	 ([732b22d](/../../commit/732b22d))
+
 <a name="v1.59.0"></a>
 ### v1.59.0 (2022-03-11)
 

data/README.md

@@ -482,8 +482,8 @@ Description:
   support for environments, deployments and releases. For documentation on how to use can-i-deploy with tags, please see
   https://docs.pact.io/pact_broker/client_cli/can_i_deploy_usage_with_tags/
 
-  Before `can-i-deploy` can be used, the relevant environment resources must first be created in the Pact Broker using the `create-environment` command. The
-  "test" and "production" environments will have been seeded for you. You can check the existing environments by running `pact-broker list-environments`. See
+  Before `can-i-deploy` can be used, the relevant environment resources must first be created in the Pact Broker using the `create-environment` command. The "test"
+  and "production" environments will have been seeded for you. You can check the existing environments by running `pact-broker list-environments`. See
   https://docs.pact.io/pact_broker/client_cli/readme#environments for more information.
 
   $ pact-broker create-environment --name "uat" --display-name "UAT" --no-production
@@ -493,8 +493,8 @@ Description:
 
   $ pact-broker record-deployment --pacticipant Foo --version 173153ae0 --environment uat
 
-  Before an application is deployed or released to an environment, the can-i-deploy command must be run to check that the application version is safe to deploy
-  with the versions of each integrated application that are already in that environment.
+  Before an application is deployed or released to an environment, the can-i-deploy command must be run to check that the application version is safe to deploy with
+  the versions of each integrated application that are already in that environment.
 
   $ pact-broker can-i-deploy --pacticipant PACTICIPANT --version VERSION --to-environment ENVIRONMENT
 
@@ -502,8 +502,8 @@ Description:
 
   $ pact-broker can-i-deploy --pacticipant Foo --version 173153ae0 --to-environment test
 
-  Can-i-deploy can also be used to check if arbitrary versions have a successful verification. When asking "Can I deploy this application version with the
-  latest version from the main branch of another application" it functions as a "can I merge" check.
+  Can-i-deploy can also be used to check if arbitrary versions have a successful verification. When asking "Can I deploy this application version with the latest version
+  from the main branch of another application" it functions as a "can I merge" check.
 
   $ pact-broker can-i-deploy --pacticipant Foo 173153ae0 \ --pacticipant Bar --latest main
 
@@ -650,8 +650,8 @@ Options:
 ```
 
 Description:
-  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-webhook" and add the
-  consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-webhook.
+  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-webhook" and add the consumer,
+  provider, event types and broker details. Note that the URL must be the first parameter when executing create-webhook.
 
   Note that the -u option from the curl command clashes with the -u option from the pact-broker CLI. When used in this command, the -u will be used as a curl
   option. Please use the --broker-username or environment variable for the Pact Broker username.
@@ -715,9 +715,9 @@ Options:
 ```
 
 Description:
-  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-or-update-webhook" and
-  add the consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-or-update-webhook and a uuid
-  must also be provided. You can generate a valid UUID by using the `generate-uuid` command.
+  Create a curl command that executes the request that you want your webhook to execute, then replace "curl" with "pact-broker create-or-update-webhook" and add the
+  consumer, provider, event types and broker details. Note that the URL must be the first parameter when executing create-or-update-webhook and a uuid must
+  also be provided. You can generate a valid UUID by using the `generate-uuid` command.
 
   Note that the -u option from the curl command clashes with the -u option from the pact-broker CLI. When used in this command, the -u will be used as a curl
   option. Please use the --broker-username or environment variable for the Pact Broker username.
@@ -814,6 +814,39 @@ Options:
 
 Describes a pacticipant version. If no version or tag is specified, the latest version is described.
 
+#### create-or-update-version
+
+```
+Usage:
+  pact-broker create-or-update-version -a, --pacticipant=PACTICIPANT -b, --broker-base-url=BROKER_BASE_URL -e, --version=VERSION
+
+Options:
+  -a, --pacticipant=PACTICIPANT
+              # The pacticipant name
+  -e, --version=VERSION
+              # The pacticipant version number
+      [--branch=BRANCH]
+              # The repository branch name
+  -t, [--tag=TAG]
+              # Tag name for pacticipant version. Can be specified multiple
+                times.
+  -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
+  -o, [--output=OUTPUT]
+              # json or text
+              # Default: text
+```
+
+Create or update pacticipant version by version number
+
 ### Miscellaneous
 
 #### generate-uuid

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 && options.branch.strip,
+                tags: options.tag && 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