pact_broker-client 1.61.1 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 302e6410c4705e3215f63cd3cde0d0f776f2509e06f286fd7dfc3ae6f7762fef
-  data.tar.gz: af9abb55766a45839a59bebfb2dd4eb93698a3f12f207a24e94c8e93219ecc57
+  metadata.gz: 03d1e24dc52514c490a7d3aa1825ae71cba4e313662d7bab06d23091c42d9686
+  data.tar.gz: 7f66cf8204b1089c896d3ea3294a926a5dc5c4c0b8b8cc20ef74306f96fe4e0c
 SHA512:
-  metadata.gz: 7cdd9bffc84f8c5ff9a012732510dd9a5df4afe1d8c9bfe538b7173d1b92382982ce4ecde02a57b8fc2968ce83a7c4c6e882f882d9c872a48dcf329f97b059e0
-  data.tar.gz: 3739ba7cd7295b088f5ff0b457c37f7eeb93ce4e03dc1e826b4f924e216d90ae00c04f8def2e32cf8a440f8ad3ea907da2e17908021b17d1b9231df736c6ae7d
+  metadata.gz: 30f083d1dc9c6effdd2cd9972ca252551ba3f13ce44dbe42f150fe11195a653a40aff596baa16f85dec1994a85161a0564a3ca822d9fb4286fa5ea0086bedc84
+  data.tar.gz: 75b6386136cfc65d1487cc2a4428195dc4655143e7cc81a8c033cb7723a3986fc8691bacf0c078658200d2930ae3ff619b0774cb67e5235c3fea0c96d01d426f

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+<a name="v1.62.0"></a>
+### v1.62.0 (2022-05-10)
+
+#### Features
+
+* add command to publish provider contracts to pactflow (feature toggle required) (#107)	 ([80cc10e](/../../commit/80cc10e))
+
+#### Bug Fixes
+
+* use ruby < 2.3 syntax. (#108)	 ([20f1e01](/../../commit/20f1e01))
+
 <a name="v1.61.1"></a>
 ### v1.61.1 (2022-05-09)
 

data/bin/pactflow

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "pactflow/client/cli/pactflow"
+
+Pactflow::Client::CLI::Pactflow.start

data/doc/pacts/markdown/Pact Broker Client - Pactflow.md

@@ -4,6 +4,8 @@
 
 * [A request for the index resource](#a_request_for_the_index_resource)
 
+* [A request to create a provider contract](#a_request_to_create_a_provider_contract)
+
 * [A request to create a webhook for a team](#a_request_to_create_a_webhook_for_a_team_given_a_team_with_UUID_2abbc12a-427d-432a-a521-c870af1739d9_exists) given a team with UUID 2abbc12a-427d-432a-a521-c870af1739d9 exists
 
 #### Interactions
@@ -41,6 +43,40 @@ Pactflow will respond with:
   }
 }
 ```
+<a name="a_request_to_create_a_provider_contract"></a>
+Upon receiving **a request to create a provider contract** from Pact Broker Client, with
+```json
+{
+  "method": "put",
+  "path": "/contracts/provider/Bar/version/1",
+  "headers": {
+    "Content-Type": "application/json",
+    "Accept": "application/hal+json"
+  },
+  "body": {
+    "content": "LS0tCjpzb21lOiBjb250cmFjdAo=",
+    "contractType": "oas",
+    "contentType": "application/yaml",
+    "verificationResults": {
+      "success": true,
+      "content": "c29tZSByZXN1bHRz",
+      "contentType": "text/plain",
+      "format": "text",
+      "verifier": "my custom tool",
+      "verifierVersion": "1.0"
+    }
+  }
+}
+```
+Pactflow will respond with:
+```json
+{
+  "status": 201,
+  "headers": {
+    "Content-Type": "application/hal+json;charset=utf-8"
+  }
+}
+```
 <a name="a_request_to_create_a_webhook_for_a_team_given_a_team_with_UUID_2abbc12a-427d-432a-a521-c870af1739d9_exists"></a>
 Given **a team with UUID 2abbc12a-427d-432a-a521-c870af1739d9 exists**, upon receiving **a request to create a webhook for a team** from Pact Broker Client, with
 ```json

data/lib/pact_broker/client/hal_client_methods.rb

@@ -8,6 +8,10 @@ module PactBroker
         PactBroker::Client::Hal::EntryPoint.new(pact_broker_base_url, create_http_client(pact_broker_client_options))
       end
 
+      def create_entry_point(entry_point, pact_broker_client_options)
+        PactBroker::Client::Hal::EntryPoint.new(entry_point, create_http_client(pact_broker_client_options))
+      end
+
       def create_http_client(pact_broker_client_options)
         PactBroker::Client::Hal::HttpClient.new(pact_broker_client_options.merge(pact_broker_client_options[:basic_auth] || {}))
       end

data/lib/pact_broker/client/version.rb

@@ -1,5 +1,5 @@
 module PactBroker
   module Client
-    VERSION = '1.61.1'
+    VERSION = '1.62.0'
   end
 end

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

@@ -0,0 +1,12 @@
+require "pactflow/client/cli/provider_contract_commands"
+require "pact_broker/client/cli/custom_thor"
+
+module Pactflow
+  module Client
+    module CLI
+      class Pactflow < PactBroker::Client::CLI::CustomThor
+        include ::Pactflow::Client::CLI::ProviderContractCommands
+      end
+    end
+  end
+end

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

@@ -0,0 +1,68 @@
+require "pact_broker/client/hash_refinements"
+
+module Pactflow
+  module Client
+    module CLI
+      module ProviderContractCommands
+        using PactBroker::Client::HashRefinements
+
+        def self.included(thor)
+          thor.class_eval do
+
+            if ENV.fetch("PACTFLOW_FEATURES", "").include?("publish-provider-contract")
+
+              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"
+
+              output_option_json_or_text
+              shared_authentication_options
+
+              def publish_provider_contract(provider_contract_path)
+                require "pactflow/client/provider_contracts/publish"
+
+                params = params = {
+                  provider_name: options.provider.strip,
+                  provider_version_number: options.provider_app_version.strip,
+                  branch_name: options.branch && options.branch.strip,
+                  tags: (options.tag && options.tag.collect(&:strip)) || [],
+                  contract: {
+                    content: File.read(provider_contract_path),
+                    content_type: options.content_type,
+                    specification: options.specification
+                  },
+                  verification_results: {
+                    success: options.verification_success,
+                    content: options.verification_results ? File.read(options.verification_results) : nil,
+                    content_type: options.verification_results_content_type,
+                    format: options.verification_results_format,
+                    verifier: options.verifier,
+                    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
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,79 @@
+require "pact_broker/client/base_command"
+require "pact_broker/client/versions/create"
+require "base64"
+
+module Pactflow
+  module Client
+    module ProviderContracts
+      class Publish < PactBroker::Client::BaseCommand
+        attr_reader :branch_name, :tags, :provider_name, :provider_version_number, :contract, :verification_results
+
+        def initialize(params, options, pact_broker_client_options)
+          super
+          @provider_name = params[:provider_name]
+          @provider_version_number = params[:provider_version_number]
+          @branch_name = params[:branch_name]
+          @tags = params[:tags] || []
+          @contract = params[:contract]
+          @verification_results = params[:verification_results]
+        end
+
+        private
+
+        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}"))
+        end
+
+        def create_branch_version_and_tags
+          if branch_name || tags.any?
+            pacticipant_version_params = {
+              pacticipant_name: provider_name,
+              version_number: provider_version_number,
+              branch_name: branch_name,
+              tags: tags
+            }
+            result = PactBroker::Client::Versions::Create.call(pacticipant_version_params, options, pact_broker_client_options)
+            if !result.success
+              raise PactBroker::Client::Error.new(result.message)
+            end
+          end
+        end
+
+        def create_contract
+          contract_path = "#{pact_broker_base_url}/contracts/provider/{provider}/version/{version}"
+          entrypoint = create_entry_point(contract_path, pact_broker_client_options)
+          entrypoint.expand(provider: provider_name, version: provider_version_number).put!(contract_params)
+        end
+
+        def contract_params
+          verification_results_params = {
+                                          success: verification_results[:success],
+                                          content:  verification_results[:content] ? encode_content(verification_results[:content]) : nil,
+                                          contentType: verification_results[:content_type],
+                                          format: verification_results[:format],
+                                          verifier: verification_results[:verifier],
+                                          verifierVersion: verification_results[:verifier_version]
+                                        }.compact
+
+          body_params = {
+                    content: encode_content(contract[:content]),
+                    contractType: contract[:specification],
+                    contentType: contract[:content_type],
+                  }.compact
+
+          if verification_results_params.any?
+            body_params[:verificationResults] = verification_results_params
+          end
+
+          body_params
+        end
+
+        def encode_content oas
+          Base64.strict_encode64(oas)
+        end
+      end
+    end
+  end
+end

data/script/oas.yml

@@ -0,0 +1,49 @@
+openapi: 3.0.0
+info:
+  title: Sample API
+  description: Optional multiline or single-line description in [CommonMark](http://commonmark.org/help/) or HTML.
+  version: 0.1.9
+servers:
+  - url: https://test.pactflow.io
+    description: Prod
+  - url: https://test.test.pactflow.io
+    description: Test
+paths:
+  /admin/teams/{uuid}:
+    get:
+      summary: Returns a team
+      parameters:
+        - name: uuid
+          in: path
+          description: The UUID of the team to return
+          required: true
+          example: 85ad09f5-e014-4e0f-a146-4377fa64b5ef
+          schema:
+            type: string
+      responses:
+        '200':
+          description: A JSON team
+          content:
+            application/json:
+              schema:
+                type: object
+                additionalProperties: false
+                properties:
+                  name:
+                    type: string
+                    example: Team Awesome
+                  uuid:
+                    type: string
+                    example: 85ad09f5-e014-4e0f-a146-4377fa64b5ef
+                  numberOfMembers:
+                    type: integer
+                    example: 4
+                  _links:
+                    type: object
+                    properties:
+                      self:
+                        type: object
+                        properties:
+                          href:
+                            type: string
+                            example: http://test.pactflow.io/admin/teams/85ad09f5-e014-4e0f-a146-4377fa64b5ef

data/script/publish-provider-contract.sh

@@ -0,0 +1,27 @@
+export PACT_BROKER_BASE_URL="http://localhost:9292"
+export PACTFLOW_FEATURES=publish-provider-contract
+# 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 \
+#   --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
+
+
+  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/verification-results.txt

@@ -0,0 +1 @@
+These are some results.

data/spec/pacts/pact_broker_client-pactflow.json

@@ -6,6 +6,36 @@
     "name": "Pactflow"
   },
   "interactions": [
+    {
+      "description": "a request to create a provider contract",
+      "request": {
+        "method": "put",
+        "path": "/contracts/provider/Bar/version/1",
+        "headers": {
+          "Content-Type": "application/json",
+          "Accept": "application/hal+json"
+        },
+        "body": {
+          "content": "LS0tCjpzb21lOiBjb250cmFjdAo=",
+          "contractType": "oas",
+          "contentType": "application/yaml",
+          "verificationResults": {
+            "success": true,
+            "content": "c29tZSByZXN1bHRz",
+            "contentType": "text/plain",
+            "format": "text",
+            "verifier": "my custom tool",
+            "verifierVersion": "1.0"
+          }
+        }
+      },
+      "response": {
+        "status": 201,
+        "headers": {
+          "Content-Type": "application/hal+json;charset=utf-8"
+        }
+      }
+    },
     {
       "description": "a request for the index resource",
       "request": {

data/spec/service_providers/pactflow_publish_provider_contract_spec.rb

@@ -0,0 +1,92 @@
+require_relative "pact_helper"
+require "pactflow/client/provider_contracts/publish"
+require "yaml"
+
+RSpec.describe "publishing a provider contract to Pactflow", pact: true do
+  before do
+    # no point re-testing this
+    allow(PactBroker::Client::Versions::Create).to receive(:call).and_return(double("result", success: true))
+  end
+
+  include_context "pact broker"
+  include PactBrokerPactHelperMethods
+
+  let(:command_params) do
+    {
+      provider_name: "Bar",
+      provider_version_number: "1",
+      branch_name: "main",
+      tags: ["dev"],
+      contract: {
+        content: { some: "contract" }.to_yaml,
+        content_type: "application/yaml",
+        specification: "oas"
+      },
+      verification_results: {
+        success: true,
+        content: "some results",
+        content_type: "text/plain",
+        format: "text",
+        verifier: "my custom tool",
+        verifier_version: "1.0"
+      }
+    }
+  end
+
+  let(:body) { { some: "body" }.to_json }
+
+  let(:request_body) do
+     {
+        "content" => "LS0tCjpzb21lOiBjb250cmFjdAo=",
+        "contractType" => "oas",
+        "contentType" => "application/yaml",
+        "verificationResults" => {
+          "success" => true,
+          "content" => "c29tZSByZXN1bHRz",
+          "contentType" => "text/plain",
+          "format" => "text",
+          "verifier" => "my custom tool",
+          "verifierVersion" => "1.0"
+        }
+     }
+  end
+
+  let(:response_status) { 201 }
+  let(:success_response) do
+    {
+      status: response_status,
+      headers: pact_broker_response_headers
+    }
+  end
+
+  let(:options) do
+    {
+      verbose: false
+    }
+  end
+
+  let(:pact_broker_client_options) do
+    { pact_broker_base_url: pactflow.mock_service_base_url }
+  end
+
+  subject { Pactflow::Client::ProviderContracts::Publish.call(command_params, options, pact_broker_client_options) }
+
+  context "creating a provider contract with valid parameters" do
+    before do
+      pactflow
+        .upon_receiving("a request to create a provider contract")
+        .with(
+            method: :put,
+            path: "/contracts/provider/Bar/version/1",
+            headers: put_request_headers,
+            body: request_body)
+        .will_respond_with(success_response)
+    end
+
+    it "returns a CommandResult with success = true" do
+      expect(subject).to be_a PactBroker::Client::CommandResult
+      expect(subject.success).to be true
+      expect(subject.message).to include "Successfully published provider contract for Bar version 1"
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pact_broker-client
 version: !ruby/object:Gem::Version
-  version: 1.61.1
+  version: 1.62.0
 platform: ruby
 authors:
 - Beth Skurrie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-09 00:00:00.000000000 Z
+date: 2022-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -204,6 +204,7 @@ email:
 - beth@bethesque.com
 executables:
 - pact-broker
+- pactflow
 extensions: []
 extra_rdoc_files: []
 files:
@@ -220,6 +221,7 @@ files:
 - Rakefile
 - appveyor.yml
 - bin/pact-broker
+- bin/pactflow
 - ci.sh
 - doc/CAN_I_DEPLOY_USAGE_WITH_TAGS.md
 - doc/pacts/markdown/Pact Broker Client - Pact Broker.md
@@ -314,17 +316,23 @@ files:
 - lib/pact_broker/client/webhooks/create.rb
 - lib/pact_broker/client/webhooks/test.rb
 - lib/pact_broker_client.rb
+- lib/pactflow/client/cli/pactflow.rb
+- lib/pactflow/client/cli/provider_contract_commands.rb
+- lib/pactflow/client/provider_contracts/publish.rb
 - pact-broker-client.gemspec
 - script/approve-all.sh
 - script/can-i-deploy.sh
 - script/create-pacticipant.sh
+- script/oas.yml
 - script/publish-pact.sh
+- script/publish-provider-contract.sh
 - script/record-deployment.sh
 - script/record-deployments-and-releases.sh
 - script/record-undeployment.sh
 - script/release.sh
 - script/trigger-release.sh
 - script/update-cli-usage-in-readme.rb
+- script/verification-results.txt
 - script/webhook-commands.sh
 - spec/fixtures/approvals/can_i_deploy_failure_dry_run.approved.txt
 - spec/fixtures/approvals/can_i_deploy_ignore.approved.txt
@@ -389,6 +397,7 @@ files:
 - spec/service_providers/pact_broker_client_tags_spec.rb
 - spec/service_providers/pact_broker_client_versions_spec.rb
 - spec/service_providers/pact_helper.rb
+- spec/service_providers/pactflow_publish_provider_contract_spec.rb
 - spec/service_providers/pactflow_webhooks_create_spec.rb
 - spec/service_providers/pacticipants_create_spec.rb
 - spec/service_providers/publish_pacts_spec.rb
@@ -497,6 +506,7 @@ test_files:
 - spec/service_providers/pact_broker_client_tags_spec.rb
 - spec/service_providers/pact_broker_client_versions_spec.rb
 - spec/service_providers/pact_helper.rb
+- spec/service_providers/pactflow_publish_provider_contract_spec.rb
 - spec/service_providers/pactflow_webhooks_create_spec.rb
 - spec/service_providers/pacticipants_create_spec.rb
 - spec/service_providers/publish_pacts_spec.rb