pact 1.64.0 → 1.67.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 174a9376cd442f1edd545cd006e1b15f07804077bb91060678e224d1717c6a5b
-  data.tar.gz: 4b5d1a84949fbad2dedeb1233626ef649ac4352840a204ea20c6496d3c0c0493
+  metadata.gz: 8be91a33981b95189c08f545d3746c76f2f2ad8642777f753cc3b414233986de
+  data.tar.gz: 1bc7d8a6e8a08c47b79e73f68e0caed9585a0eafb0bc316a4e589f2b3f9028a3
 SHA512:
-  metadata.gz: 957b95b85b59906f1a59bb23fe2b85674c1574171a0880a508df9c6413bc7fe3f2b54fc3fe766eab3fdd8f18e68eaabf4efda43da50df01c66ebe2e9a0f19111
-  data.tar.gz: 6a34522651d931773d8ee92565ffd5173fd3f2cd99ba1211d25985da499b62d993a5b62b87257afb11a759cf691aa7702efe9e1773d11165794980d1301138e1
+  metadata.gz: a73f8cf2aa2956f7e0c7ed2dc8ab35fefbf1b7a2b0ab88d21bb3936a4761ae60d2fd622c4f2a767f2b6e75837556aeb055011667def9a90b8fbe1f9df74bf0f9
+  data.tar.gz: e27d62a8822b43ded6ccd48b926c2833292617834c7c2b8dda45d93a26a769d1093909d87921f8c15962445d3ef2012b1df2d5417ed7a07259a4275862c9f4b9

data/CHANGELOG.md

@@ -1,3 +1,133 @@
+<a name="v1.67.5"></a>
+### v1.67.5 (2026-02-13)
+
+#### Bug Fixes
+
+* retry HTTP requests on 5xx status codes (502, 503, 504)	 ([2174a31](/../../commit/2174a31))
+
+<a name="v1.67.4"></a>
+### v1.67.4 (2026-02-09)
+
+#### Bug Fixes
+
+* suppress v2 load warning in v1 mode	 ([4f7bab2](/../../commit/4f7bab2))
+* pact-v2 verifier - pact_proxy_port was not honoured	 ([6a60bae](/../../commit/6a60bae))
+
+<a name="v1.67.3"></a>
+### v1.67.3 (2025-11-06)
+
+#### Bug Fixes
+
+* ensure message consumers with plugins cleanup processes	 ([8df23e6](/../../commit/8df23e6))
+
+<a name="v1.67.2"></a>
+### v1.67.2 (2025-10-22)
+
+#### Bug Fixes
+
+* **v2**
+  * allow configurable loggers in verifier	 ([9fad7fa](/../../commit/9fad7fa))
+
+<a name="v1.67.1"></a>
+### v1.67.1 (2025-10-22)
+
+#### Bug Fixes
+
+* **deps**
+  * make pact-ffi optional in v1 releases for pact-ruby-standalone consumption	 ([e3cd0d6](/../../commit/e3cd0d6))
+
+<a name="v1.67.0"></a>
+### v1.67.0 (2025-10-16)
+
+#### Features
+
+* add support for generate_from_provider_state	 ([4ff7812](/../../commit/4ff7812))
+* add pact-ruby v2 generators	 ([4db935b](/../../commit/4db935b))
+* add pact plugin consumer interfaces for http/async/sync messages	 ([ca19f86](/../../commit/ca19f86))
+* add more matchers	 ([ccb82b9](/../../commit/ccb82b9))
+* load pact/v2 into namespace	 ([4ac42ec](/../../commit/4ac42ec))
+* add pact v2 interface	 ([4595015](/../../commit/4595015))
+
+#### Bug Fixes
+
+* ensure we always print mismatchs in consumer tests for better dx	 ([f9cb106](/../../commit/f9cb106))
+* json load diff regression downstream, relax restrictions	 ([481eab9](/../../commit/481eab9))
+
+<a name="v1.66.2"></a>
+### v1.66.2 (2025-10-03)
+
+#### Bug Fixes
+
+* **spec**
+  * update rspec keyword vs arg changes https://github.com/rspec/rspec-mocks/pull/1473	 ([c1c17fc](/../../commit/c1c17fc))
+
+* correct generators import and update specs	 ([d025342](/../../commit/d025342))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([4dfb3f5](/../../commit/4dfb3f5))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([3d8fa31](/../../commit/3d8fa31))
+* example/zoo-app/Gemfile to reduce vulnerabilities	 ([5ff8945](/../../commit/5ff8945))
+
+<a name="v1.66.1"></a>
+### v1.66.1 (2025-01-20)
+
+#### Bug Fixes
+
+* HTTP_HOST headers for sinatra 4.x	 ([173bfb7](/../../commit/173bfb7))
+
+<a name="v1.66.0"></a>
+### v1.66.0 (2024-11-29)
+
+#### Features
+
+* **generators**
+  * Add more generators as per spec	 ([f55adf1](/../../commit/f55adf1))
+  * Pass context and add ProviderState generator	 ([7a1cf3b](/../../commit/7a1cf3b))
+
+#### Bug Fixes
+
+* add HTTPS_HOST header if invoking a Sinatra app	 ([ed44189](/../../commit/ed44189))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([981ebee](/../../commit/981ebee))
+
+<a name="v1.65.3"></a>
+### v1.65.3 (2024-10-23)
+
+#### Bug Fixes
+
+* **test**
+  * explicitly require ostruct as non stdlib in ruby 3.5.x	 ([c9a8525](/../../commit/c9a8525))
+
+<a name="v1.65.2"></a>
+### v1.65.2 (2024-09-26)
+
+<a name="v1.65.1"></a>
+### v1.65.1 (2024-08-08)
+
+#### Bug Fixes
+
+* set color codes even on dumb terms (prev behaviour)	 ([4f01bc9](/../../commit/4f01bc9))
+* use .empty? in handling_no_pacts_found	 ([43bce74](/../../commit/43bce74))
+
+<a name="v1.65.0"></a>
+### v1.65.0 (2024-08-06)
+
+#### Features
+
+* support app_version_branch in MessageProviderDSL	 ([1653128](/../../commit/1653128))
+* allow setting fail_if_no_pacts_found in honours_pacts_from_pact_broker	 ([f0f142e](/../../commit/f0f142e))
+
+#### Bug Fixes
+
+* handle case in no_pacts_found - undefined method empty? for nil	 ([0145d2d](/../../commit/0145d2d))
+* remove unused ConsumerContractBuilder contract_details accessor	 ([fb5488e](/../../commit/fb5488e))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([2bbefe2](/../../commit/2bbefe2))
+* example/zoo-app/Gemfile to reduce vulnerabilities	 ([e10f914](/../../commit/e10f914))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([7560918](/../../commit/7560918))
+* example/zoo-app/Gemfile to reduce vulnerabilities	 ([b4cbe85](/../../commit/b4cbe85))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([4028087](/../../commit/4028087))
+* ConsumerContractBuilder exposing incorrect field	 ([c805c3e](/../../commit/c805c3e))
+
+* **test**
+  * alias Rack/Rackup WEBrick handler in x509 test for backwards compat	 ([cc77498](/../../commit/cc77498))
+
 <a name="v1.64.0"></a>
 ### v1.64.0 (2023-11-09)
 

data/lib/pact/cli/run_pact_verification.rb

@@ -72,7 +72,6 @@ module Pact
 
       def run_with_configured_pacts_from_pact_helper
         pact_urls = Pact.provider_world.pact_urls
-        raise "Please configure a pact to verify" if pact_urls.empty?
         Pact::Provider::PactSpecRunner.new(pact_urls, pact_spec_options).run
       end
 

data/lib/pact/consumer/consumer_contract_builder.rb

@@ -11,7 +11,7 @@ module Pact
 
       include Pact::Logging
 
-      attr_reader :consumer_contract, :mock_service_base_url
+      attr_reader :mock_service_base_url
 
       def initialize(attributes)
         @interaction_builder = nil

data/lib/pact/hal/http_client.rb

@@ -6,6 +6,18 @@ require 'openssl'
 
 module Pact
   module Hal
+    class RetriableHttpStatusError < StandardError
+      RETRIABLE_STATUS_CODES = [502, 503, 504].freeze
+
+      attr_reader :status_code, :response_body
+
+      def initialize status_code, response_body
+        @status_code = status_code
+        @response_body = response_body
+        super("HTTP #{status_code} error: #{response_body}")
+      end
+    end
+
     class HttpClient
       attr_accessor :username, :password, :verbose, :token
 
@@ -65,9 +77,15 @@ module Pact
             end
             http.verify_mode = OpenSSL::SSL::VERIFY_NONE
           end
-          http.start do |http|
+          result = http.start do |http|
             http.request request
           end
+
+          # Raise error on specific 5xx status codes to trigger retry
+          status_code = result.code.to_i
+          raise RetriableHttpStatusError.new(status_code, result.body) if RetriableHttpStatusError::RETRIABLE_STATUS_CODES.include?(status_code)
+
+          result
         end
         Response.new(response)
       end

data/lib/pact/pact_broker/fetch_pact_uris_for_verification.rb

@@ -39,15 +39,17 @@ module Pact
       end
 
       def call
-        if index.can?(PACTS_FOR_VERIFICATION_RELATION) || index.can?(PACTS_FOR_VERIFICATION_RELATION_BETA)
-          log_message
-          pacts_for_verification
-        else
-          old_selectors = consumer_version_selectors.collect do | selector |
-            { name: selector[:tag], all: !selector[:latest], fallback: selector[:fallbackTag]}
+        handling_no_pacts_found do
+          if index.can?(PACTS_FOR_VERIFICATION_RELATION) || index.can?(PACTS_FOR_VERIFICATION_RELATION_BETA)
+            log_message
+            pacts_for_verification
+          else
+            old_selectors = consumer_version_selectors.collect do | selector |
+              { name: selector[:tag], all: !selector[:latest], fallback: selector[:fallbackTag]}
+            end
+            # Fall back to old method of fetching pacts
+            FetchPacts.call(provider, old_selectors, broker_base_url, http_client_options)
           end
-          # Fall back to old method of fetching pacts
-          FetchPacts.call(provider, old_selectors, broker_base_url, http_client_options)
         end
       end
 
@@ -96,6 +98,15 @@ module Pact
       def log_message
         Pact.configuration.output_stream.puts "INFO: #{pact_selection_description(provider, consumer_version_selectors, options, broker_base_url)}"
       end
+
+      def handling_no_pacts_found
+        pacts_found = yield
+        raise "No pacts found to verify" if pacts_found.empty? && options[:fail_if_no_pacts_found] != false
+        if pacts_found.empty? && options[:fail_if_no_pacts_found] == false
+          Pact.configuration.output_stream.puts "WARN: No pacts found to verify & fail_if_no_pacts_found is set to false."
+        end
+        pacts_found
+      end
     end
   end
 end

data/lib/pact/provider/configuration/message_provider_dsl.rb

@@ -34,6 +34,10 @@ module Pact
             self.tags = tags
           end
 
+          def app_version_branch branch
+            self.branch = branch
+          end
+
           def publish_verification_results publish_verification_results
             self.publish_verification_results = publish_verification_results
             Pact::RSpec.with_rspec_2 do

data/lib/pact/provider/configuration/pact_verification_from_broker.rb

@@ -15,7 +15,7 @@ module Pact
         # in parent scope, it will clash with these ones,
         # so put an underscore in front of the name to be safer.
 
-        attr_accessor :_provider_name, :_pact_broker_base_url, :_consumer_version_tags, :_provider_version_branch, :_provider_version_tags, :_basic_auth_options, :_enable_pending, :_include_wip_pacts_since, :_verbose, :_consumer_version_selectors
+        attr_accessor :_provider_name, :_pact_broker_base_url, :_consumer_version_tags, :_provider_version_branch, :_provider_version_tags, :_basic_auth_options, :_enable_pending, :_include_wip_pacts_since, :_verbose, :_consumer_version_selectors, :_fail_if_no_pacts_found
 
         def initialize(provider_name, provider_version_branch, provider_version_tags)
           @_provider_name = provider_name
@@ -26,6 +26,7 @@ module Pact
           @_enable_pending = false
           @_include_wip_pacts_since = nil
           @_verbose = false
+          @_fail_if_no_pacts_found = true # CLI defaults to false, unfortunately for consistency
         end
 
         dsl do
@@ -46,6 +47,11 @@ module Pact
             self._enable_pending = enable_pending
           end
 
+          # Underlying code defaults to true if not specified
+          def fail_if_no_pacts_found fail_if_no_pacts_found
+            self._fail_if_no_pacts_found = fail_if_no_pacts_found
+          end
+
           def include_wip_pacts_since since
             self._include_wip_pacts_since = if since.respond_to?(:xmlschema)
               since.xmlschema
@@ -74,7 +80,7 @@ module Pact
             _provider_version_tags,
             _pact_broker_base_url,
             _basic_auth_options.merge(verbose: _verbose),
-            { include_pending_status: _enable_pending, include_wip_pacts_since: _include_wip_pacts_since }
+            { include_pending_status: _enable_pending, include_wip_pacts_since: _include_wip_pacts_since, fail_if_no_pacts_found: _fail_if_no_pacts_found }
           )
 
           Pact.provider_world.add_pact_uri_source fetch_pacts

data/lib/pact/provider/help/console_text.rb

@@ -2,15 +2,13 @@ require 'pact/provider/help/content'
 require 'fileutils'
 require 'pact/consumer/configuration'
 require 'pact/provider/help/write'
-require 'term/ansicolor'
+require 'rainbow'
 
 module Pact
   module Provider
     module Help
       class ConsoleText
 
-        C = ::Term::ANSIColor
-
         def self.call reports_dir = Pact.configuration.reports_dir, options = {color: true}
           new(reports_dir || Pact.configuration.reports_dir, options).call
         end
@@ -46,13 +44,11 @@ module Pact
         end
 
         def error_text_coloured
-          C.red(error_text_plain)
+          Rainbow(error_text_plain).red
         end
 
         class ColorizeMarkdown
 
-          C = ::Term::ANSIColor
-
           def self.call markdown
             markdown.split("\n").collect do | line |
               if line.start_with?("# ")
@@ -66,11 +62,11 @@ module Pact
           end
 
           def self.yellow_underling string
-            C.underline(C.yellow(string))
+            Rainbow(string).yellow.underline
           end
 
           def self.green string
-            C.green(string)
+            Rainbow(string).green
           end
 
         end

data/lib/pact/provider/help/prompt_text.rb

@@ -1,5 +1,5 @@
 require 'pact/consumer/configuration'
-require 'term/ansicolor'
+require 'rainbow'
 require 'pathname'
 
 module Pact
@@ -7,8 +7,6 @@ module Pact
     module Help
       class PromptText
 
-        C = ::Term::ANSIColor
-
         def self.call reports_dir = Pact.configuration.reports_dir, options = {color: Pact.configuration.color_enabled}
           new(reports_dir, options).call
         end
@@ -31,7 +29,7 @@ module Pact
         end
 
         def prompt_text_colored
-          C.yellow(prompt_text_plain)
+          Rainbow(prompt_text_plain).yellow
         end
 
         def rake_args

data/lib/pact/provider/matchers/messages.rb

@@ -1,15 +1,13 @@
-require 'term/ansicolor'
+require 'rainbow'
 require 'pact/term'
 
 module Pact
   module Matchers
     module Messages
 
-      C = ::Term::ANSIColor
-
       def match_term_failure_message diff, actual, diff_formatter, color_enabled
         actual_string = String === actual ? actual : actual.to_json
-        maybe_coloured_string = color_enabled ? C.white(actual_string) : actual_string
+        maybe_coloured_string = color_enabled ? Rainbow(actual_string).white : actual_string
         message = "Actual: #{maybe_coloured_string}\n\n"
         formatted_diff = diff_formatter.call(diff)
         message + colorize_if_enabled(formatted_diff, color_enabled)
@@ -40,7 +38,7 @@ module Pact
           # RSpec wraps each line in the failure message with failure_color, turning it red.
           # To ensure the lines in the diff that should be white, stay white, put an
           # ANSI reset at the start of each line.
-          formatted_diff.split("\n").collect{ |line| ::Term::ANSIColor.reset + line }.join("\n")
+          formatted_diff.split("\n").collect{ |line|"\e[0m#{line}" }.join("\n")
         else
           formatted_diff
         end

data/lib/pact/provider/print_missing_provider_states.rb

@@ -1,11 +1,9 @@
-require 'term/ansicolor'
+require 'rainbow'
 
 module Pact
   module Provider
     class PrintMissingProviderStates
 
-      C = ::Term::ANSIColor
-
       # Hash of consumer names to array of names of missing provider states
       def self.call missing_provider_states, output
         if missing_provider_states.any?
@@ -15,8 +13,8 @@ module Pact
 
       def self.colorize string
         lines = string.split("\n")
-        first_line = C.cyan(C.underline(lines[0]))
-        other_lines = C.cyan(lines[1..-1].join("\n"))
+        first_line = Rainbow(lines[0]).cyan.underline
+        other_lines = Rainbow(lines[1..-1].join("\n")).cyan
         first_line + "\n" + other_lines
       end
 

data/lib/pact/provider/request.rb

@@ -1,6 +1,7 @@
 require 'json'
 require 'pact/reification'
 require 'pact/shared/null_expectation'
+require 'pact/generators'
 
 module Pact
   module Provider
@@ -10,8 +11,9 @@ module Pact
         # See https://github.com/rack/rack/blob/e7d741c6282ca4cf4e01506f5681e6e6b14c0b32/SPEC#L87-89
         NO_HTTP_PREFIX = ["CONTENT-TYPE", "CONTENT-LENGTH"]
 
-        def initialize expected_request
+        def initialize expected_request, state_params = nil
           @expected_request = expected_request
+          @state_params = state_params
         end
 
         def method
@@ -19,7 +21,7 @@ module Pact
         end
 
         def path
-          expected_request.full_path
+          Pact::Generators.apply_generators(expected_request, "path", expected_request.full_path, @state_params)
         end
 
         def body
@@ -27,17 +29,22 @@ module Pact
           when String then expected_request.body
           when NullExpectation then ''
           else
-            reified_body
+            generated_body
           end
         end
 
         def headers
           request_headers = {}
+          # https://github.com/pact-foundation/pact-ruby/pull/327
+          request_headers.merge!('HOST' => 'localhost') if defined?(Sinatra)
           return request_headers if expected_request.headers.is_a?(Pact::NullExpectation)
+
           expected_request.headers.each do |key, value|
-            request_headers[rack_request_header_for(key)] = Pact::Reification.from_term(value)
+            request_headers[key] = Pact::Reification.from_term(value)
           end
-          request_headers
+
+          request_headers = Pact::Generators.apply_generators(expected_request, "header", request_headers, @state_params)
+          request_headers.map{ |key,value| [rack_request_header_for(key), value]}.to_h
         end
 
         private
@@ -53,6 +60,19 @@ module Pact
           end
         end
 
+        def generated_body
+          result = Pact::Generators.apply_generators(expected_request, "body", reified_body, @state_params)
+
+          case result
+          when Hash
+            result.to_json
+          when String
+            result
+          else
+            raise "Expected body to be a String or Hash, but was #{result.class} with value #{result.inspect}"
+          end
+        end
+
         def rack_request_header_for header
           with_http_prefix(header.to_s.upcase).tr('-', '_')
         end

data/lib/pact/provider/rspec/formatter_rspec_2.rb

@@ -1,6 +1,6 @@
 require 'pact/provider/print_missing_provider_states'
 require 'rspec/core/formatters/documentation_formatter'
-require 'term/ansicolor'
+require 'rainbow'
 require 'pact/provider/help/prompt_text'
 
 module Pact
@@ -13,8 +13,6 @@ module Pact
           end
         end
 
-        C = ::Term::ANSIColor
-
         def dump_commands_to_rerun_failed_examples
           return if failed_examples.empty?
 

data/lib/pact/provider/rspec/formatter_rspec_3.rb

@@ -1,6 +1,6 @@
 require 'pact/provider/print_missing_provider_states'
 require 'rspec/core/formatters'
-require 'term/ansicolor'
+require 'rainbow'
 require 'pact/provider/help/prompt_text'
 
 module Pact
@@ -22,8 +22,6 @@ module Pact
                                     :example_passed, :example_pending, :example_failed
         end
 
-        C = ::Term::ANSIColor
-
         def example_group_started(notification)
           # This is the metadata on the top level "Verifying a pact between X and Y" describe block
           if @group_level == 0

data/lib/pact/provider/rspec/pact_broker_formatter.rb

@@ -1,6 +1,6 @@
 require 'rspec/core/formatters'
 require 'pact/provider/verification_results/publish_all'
-require 'term/ansicolor'
+require 'rainbow'
 require 'pact/matchers/extract_diff_messages'
 
 module Pact
@@ -43,7 +43,7 @@ module Pact
             if example.exception
               hash[:exception] =  {
                 class: example.exception.class.name,
-                message: ::Term::ANSIColor.uncolor(example.exception.message)
+                message: "\e[0m#{example.exception.message}"
               }
             end
 

data/lib/pact/provider/rspec.rb

@@ -25,6 +25,7 @@ module Pact
           pact_uri = pact_source.uri
           Pact.configuration.output_stream.puts "INFO: Reading pact at #{pact_uri}"
           consumer_contract = Pact::ConsumerContract.from_json(pact_json)
+
           suffix = pact_uri.metadata[:pending] ? " [PENDING]": ""
           example_group_description = "Verifying a pact between #{consumer_contract.consumer.name} and #{consumer_contract.provider.name}#{suffix}"
           example_group_metadata = { pactfile_uri: pact_uri, pact_criteria: options[:criteria] }
@@ -77,7 +78,6 @@ module Pact
         end
 
         def describe_interaction interaction, options
-
           # pact_uri and pact_interaction are used by
           # Pact::Provider::RSpec::PactBrokerFormatter
 
@@ -103,8 +103,9 @@ module Pact
             before do | example |
               interaction_context.run_once :before do
                 Pact.configuration.logger.info "Running example '#{Pact::RSpec.full_description(example)}'"
-                set_up_provider_states interaction.provider_states, options[:consumer]
-                replay_interaction interaction, options[:request_customizer]
+                provider_states_result = set_up_provider_states interaction.provider_states, options[:consumer]
+                state_params = provider_states_result[interaction.provider_state];
+                replay_interaction interaction, options[:request_customizer], state_params
                 interaction_context.last_response = last_response
               end
             end
@@ -129,6 +130,7 @@ module Pact
           include Pact::RSpec::Matchers
           extend Pact::Matchers::Messages
 
+
           let(:expected_contents) { expected_response.body[:contents].as_json }
           let(:response) { interaction_context.last_response }
           let(:differ) { Pact.configuration.body_differ_for_content_type diff_content_type }

data/lib/pact/provider/test_methods.rb

@@ -14,8 +14,8 @@ module Pact
       include Pact::Logging
       include Rack::Test::Methods
 
-      def replay_interaction interaction, request_customizer = nil
-        request = Request::Replayable.new(interaction.request)
+      def replay_interaction interaction, request_customizer = nil, state_params = nil
+        request = Request::Replayable.new(interaction.request, state_params)
         request = request_customizer.call(request, interaction) if request_customizer
         args = [request.path, request.body, request.headers]
 
@@ -42,11 +42,17 @@ module Pact
       end
 
       def set_up_provider_states provider_states, consumer, options = {}
+        provider_states_result = {};
         # If there are no provider state, execute with an nil state to ensure global and base states are executed
         Pact.configuration.provider_state_set_up.call(nil, consumer, options) if provider_states.nil? || provider_states.empty?
         provider_states.each do | provider_state |
-          Pact.configuration.provider_state_set_up.call(provider_state.name, consumer, options.merge(params: provider_state.params))
+          result = Pact.configuration.provider_state_set_up.call(provider_state.name, consumer, options.merge(params: provider_state.params))
+          if result.is_a?(Hash)
+            provider_states_result[provider_state.name] = result
+          end
         end
+
+        provider_states_result
       end
 
       def tear_down_provider_states provider_states, consumer, options = {}

data/lib/pact/v2/configuration.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pact
+  module V2
+    class Configuration
+      attr_reader :before_provider_state_proc, :after_provider_state_proc
+
+      class GlobalProviderConfigurationError < ::Pact::V2::Error; end
+
+      def before_provider_state_setup(&block)
+        raise GlobalProviderConfigurationError, "no block given" unless block
+
+        @before_provider_state_proc = block
+      end
+
+      def after_provider_state_teardown(&block)
+        raise GlobalProviderConfigurationError, "no block given" unless block
+
+        @after_provider_state_proc = block
+      end
+    end
+  end
+end