Class: Pact::Consumer::PluginAsyncMessageInteractionBuilder

Inherits:
Object
  • Object
show all
Defined in:
lib/pact/consumer/plugin_async_message_interaction_builder.rb

Defined Under Namespace

Classes: CreateInteractionError, InteractionBuilderError, InteractionMismatchesError, PluginInitError

Constant Summary collapse

INIT_PLUGIN_ERRORS =

docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_using_plugin.html

{
  1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
  2 => {reason: :plugin_load_failed, status: 2, description: "Failed to load the plugin"},
  3 => {reason: :invalid_handle, status: 3, description: "Pact Handle is not valid"}
}.freeze
CREATE_INTERACTION_ERRORS =

docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_interaction_contents.html

{
  1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
  2 => {reason: :mock_server_already_running, status: 2, description: "The mock server has already been started"},
  3 => {reason: :invalid_handle, status: 3, description: "The interaction handle is invalid"},
  4 => {reason: :invalid_content_type, status: 4, description: "The content type is not valid"},
  5 => {reason: :invalid_contents, status: 5, description: "The contents JSON is not valid JSON"},
  6 => {reason: :plugin_error, status: 6, description: "The plugin returned an error"}
}.freeze

Instance Method Summary collapse

Constructor Details

#initialize(pact_config, description: nil) ⇒ PluginAsyncMessageInteractionBuilder

Returns a new instance of PluginAsyncMessageInteractionBuilder.



36
37
38
39
40
41
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 36

def initialize(pact_config, description: nil)
  @pact_config = pact_config
  @description = description || ""
  @contents = nil
  @provider_state_meta = nil
end

Instance Method Details

#execute(&block) ⇒ Object 



94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 94

def execute(&block)
  raise InteractionBuilderError.new("interaction is designed to be used one-time only") if defined?(@used)

  validate!

  pact_handle = init_pact
  init_plugin!(pact_handle)

  interaction = PactFfi::AsyncMessageConsumer.new(pact_handle, @description)

  @provider_state_meta&.each_pair do |provider_state, meta|
    if meta.present?
        meta.each_pair do |k, v|
        if v.nil? || (v.respond_to?(:empty?) && v.empty?)
          PactFfi.given(interaction, provider_state)
        else
          PactFfi.given_with_param(interaction, provider_state, k.to_s, v.to_s)
        end
        end
    else
      PactFfi.given(interaction, provider_state)
    end
  end

  result = PactFfi.with_body(interaction, 0, @interaction_content_type, interaction_json)
  if CREATE_INTERACTION_ERRORS[result].present?
    error = CREATE_INTERACTION_ERRORS[result]
    raise CreateInteractionError.new("There was an error while trying to add interaction \"#{@description}\"", error[:reason], error[:status])
  end

  mock_server = MockServer.create_for_transport!(pact: pact_handle, transport: @transport, host: @pact_config.mock_host, port: @pact_config.mock_port)

  yield(pact_handle, mock_server)

ensure
  if mock_server.matched?
    mock_server.write_pacts!(@pact_config.pact_dir)
  else
    msg = mismatches_error_msg(mock_server)
    raise InteractionMismatchesError.new(msg)
  end
  @used = true
  mock_server&.cleanup
  PactFfi::PluginConsumer.cleanup_plugins(pact_handle) if pact_handle
  PactFfi.free_pact_handle(pact_handle) if pact_handle
end

#given(provider_state, metadata = {}) ⇒ Object 



52
53
54
55
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 52

def given(provider_state, metadata = {})
  @provider_state_meta = {provider_state => metadata}
  self
end

#interaction_json ⇒ Object 



82
83
84
85
86
87
88
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 82

def interaction_json
  result = {
    contents: @contents
  }
  result.merge!(@plugin_metadata) if @plugin_metadata.is_a?(Hash)
  JSON.dump(result)
end

#upon_receiving(description) ⇒ Object 



57
58
59
60
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 57

def upon_receiving(description)
  @description = description
  self
end

#validate! ⇒ Object

Raises:



90
91
92
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 90

def validate!
  raise InteractionBuilderError.new("invalid contents format, should be a hash") unless @contents.is_a?(Hash)
end

#with_content_type(content_type) ⇒ Object 



67
68
69
70
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 67

def with_content_type(content_type)
  @interaction_content_type = content_type || @content_type
  self
end

#with_contents(contents_hash) ⇒ Object 



62
63
64
65
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 62

def with_contents(contents_hash)
  @contents = InteractionContents.plugin(contents_hash)
  self
end

#with_plugin(plugin_name, plugin_version) ⇒ Object

Raises:



43
44
45
46
47
48
49
50
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 43

def with_plugin(plugin_name, plugin_version)
  raise InteractionBuilderError.new("plugin_name is required") if plugin_name.blank?
  raise InteractionBuilderError.new("plugin_version is required") if plugin_version.blank?

  @plugin_name = plugin_name
  @plugin_version = plugin_version
  self
end

#with_plugin_metadata(meta_hash) ⇒ Object 



72
73
74
75
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 72

def with_plugin_metadata(meta_hash)
  @plugin_metadata = meta_hash
  self
end

#with_transport(transport) ⇒ Object 



77
78
79
80
 
# File 'lib/pact/consumer/plugin_async_message_interaction_builder.rb', line 77

def with_transport(transport)
  @transport = transport
  self
end