http_stub 0.25.1 → 0.26.0

data/lib/http_stub/server/views/session.haml

@@ -0,0 +1,3 @@
+%header
+  %h2= "Session: #{session.id}"
+= partial :session, locals: { session: session }

data/lib/http_stub/server/views/sessions.haml

@@ -0,0 +1,6 @@
+= partial :home
+%h2 Sessions
+%section
+  - sessions.each do |session|
+    %a{ href: "/http_stub/sessions?http_stub_session_id=#{session.id}", class: [:session, :link] }= session.id
+    %br

data/lib/http_stub/server/views/stubs.haml

@@ -1,6 +1,3 @@
 %header
   %h1 Stubs
-%section
-  - stubs.each do |the_stub|
-    = partial :stub, locals: { the_stub: the_stub }
-    .header-rule
+= partial :stubs, locals: { stubs: stubs }

data/lib/http_stub/server/views/transactional_session.haml

@@ -0,0 +1,2 @@
+= partial :home
+= partial :session, locals: { session: session }

data/lib/http_stub/version.rb

@@ -1,3 +1,3 @@
 module HttpStub
-  VERSION = "0.25.1".freeze
+  VERSION = "0.26.0".freeze
 end

data/spec/acceptance/configurer_initialization_spec.rb

@@ -1,15 +1,11 @@
 describe "Configurer initialization acceptance" do
   include_context "configurer integration"
 
-  let(:configurer) { HttpStub::Examples::ConfigurerWithComplexInitializer.new }
-
   context "when a configurer is initialized" do
 
-    before(:example) { configurer.class.initialize! }
-
-    context "that contains a class stub" do
+    context "that contains a stub" do
 
-      let(:configurer) { HttpStub::Examples::ConfigurerWithTrivialStub.new }
+      let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithTrivialStub } }
 
       it "registers the stub" do
         response = HTTParty.get("#{server_uri}/a_class_stub")
@@ -18,19 +14,26 @@ describe "Configurer initialization acceptance" do
         expect(response.body).to eql("Class stub body")
       end
 
-      context "and the stub is overridden" do
+      context "and another stub is registered" do
 
         before(:example) do
-          configurer.stub_response!("/a_class_stub", method: :get, response: { body: "Other class stub body" })
+          stub_server.add_stub! do |stub|
+            stub.match_requests(uri: "/another_stub", method: :get)
+            stub.respond_with(body: "Another stub body")
+          end
         end
 
-        context "and the configurer is re-initialized" do
+        context "and the servers stubs are recalled" do
 
-          before(:example) do
-            configurer.class.initialize!
+          before(:example) { stub_server.recall_stubs! }
+
+          it "removes the stub just registered" do
+            response = HTTParty.get("#{server_uri}/another_stub")
+
+            expect(response.code).to eql(404)
           end
 
-          it "re-establishes the class stub as having priority" do
+          it "retains the stub registered during initialization" do
             response = HTTParty.get("#{server_uri}/a_class_stub")
 
             expect(response.code).to eql(201)
@@ -41,40 +44,24 @@ describe "Configurer initialization acceptance" do
 
       end
 
-    end
-
-    context "and the initializer contains conventional stubs" do
-
-      let(:configurer) { HttpStub::Examples::ConfigurerWithComplexInitializer.new }
-
-      it "registers the stub" do
-        response = HTTParty.get("#{server_uri}/stubbed_during_initialization_path")
-
-        expect(response.code).to eql(200)
-        expect(response.body).to eql("Stubbed during initialization body")
-      end
-
-      context "and another stub is registered" do
+      context "and the stub is overridden" do
 
         before(:example) do
-          configurer.stub_response!("/another_stub", method: :get, response: { body: "Another stub body" })
+          stub_server.add_stub! do |stub|
+            stub.match_requests(uri: "/a_class_stub", method: :get)
+            stub.respond_with(body: "Other class stub body")
+          end
         end
 
-        context "and the servers remembered stubs are recalled" do
-
-          before(:example) { configurer.recall_stubs! }
+        context "and the servers stubs are recalled" do
 
-          it "removes the stub registered post-initialization" do
-            response = HTTParty.get("#{server_uri}/another_stub")
-
-            expect(response.code).to eql(404)
-          end
+          before(:example) { stub_server.recall_stubs! }
 
-          it "retains the stub registered during initialization" do
-            response = HTTParty.get("#{server_uri}/stubbed_during_initialization_path")
+          it "re-establishes the class stub" do
+            response = HTTParty.get("#{server_uri}/a_class_stub")
 
-            expect(response.code).to eql(200)
-            expect(response.body).to eql("Stubbed during initialization body")
+            expect(response.code).to eql(201)
+            expect(response.body).to eql("Class stub body")
           end
 
         end
@@ -83,9 +70,9 @@ describe "Configurer initialization acceptance" do
 
     end
 
-    context "and the configurer contains an on initialize callback" do
+    context "and the configurer contains an initialize callback" do
 
-      let(:configurer) { HttpStub::Examples::ConfigurerWithInitializeCallback.new }
+      let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithInitializeCallback } }
 
       it "executes the callback" do
         response = HTTParty.get("#{server_uri}/stubbed_on_initialize_path")
@@ -100,20 +87,22 @@ describe "Configurer initialization acceptance" do
 
   context "when a configurer is uninitialized" do
 
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithTrivialStub, initialize: false } }
+
     context "and the configurer is informed that the server has started" do
 
-      before(:example) { configurer.server_has_started! }
+      before(:example) { stub_server.has_started! }
 
       it "does not initialize the configurer" do
-        activation_lambda = lambda { configurer.activate!("an_activator") }
-
-        expect(activation_lambda).to raise_error(/error occurred activating 'an_activator'/i)
+        expect { stub_server.activate!("an_activator") }.to raise_error(/error occurred activating 'an_activator'/i)
       end
 
       context "and an attempt is made to register a stub" do
 
         before(:example) do
-          configurer.stub_response!("/some_stub_path", method: :get, response: { body: "Some stub body" })
+          stub_server.add_stub! do
+            match_requests(uri: "/some_stub_path", method: :get).respond_with(body: "Some stub body")
+          end
         end
 
         it "registers the stub" do
@@ -132,18 +121,18 @@ describe "Configurer initialization acceptance" do
       context "and an attempt is made to activate a stub" do
 
         it "raises an exception indicating an error occurred during activation" do
-          activation_lambda = lambda { configurer.activate!("an_activator") }
-
-          expect(activation_lambda).to raise_error(/error occurred activating 'an_activator'/i)
+          expect { stub_server.activate!("an_activator") }.to raise_error(/error occurred activating 'an_activator'/i)
         end
 
       end
 
     end
 
-    context "and the configurer contains an on initialize callback" do
+    context "and the configurer contains an initialize callback" do
 
-      let(:configurer) { HttpStub::Examples::ConfigurerWithInitializeCallback.new }
+      let(:configurer_specification) do
+        { class: HttpStub::Examples::ConfigurerWithInitializeCallback, initialize: false }
+      end
 
       it "does not execute the callback" do
         response = HTTParty.get("#{server_uri}/stubbed_on_initialize_path")

data/spec/acceptance/configurer_part_spec.rb

@@ -1,11 +1,9 @@
 describe "Configurer Part acceptance" do
   include_context "configurer integration"
 
-  context "when a configurer contains a part" do
-
-    let(:configurer) { HttpStub::Examples::ConfigurerWithParts.new }
+  let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithParts } }
 
-    before(:example) { configurer.class.initialize! }
+  context "when a configurer contains a part" do
 
     context "that contains a configure stub method" do
 
@@ -17,7 +15,7 @@ describe "Configurer Part acceptance" do
 
     end
 
-    context "that contains a configure stubs methods" do
+    context "that contains a configure stubs method" do
 
       let(:response) { issue_request("registered_in_configure_stubs_method") }
 
@@ -27,7 +25,7 @@ describe "Configurer Part acceptance" do
 
     end
 
-    context "that contains a configure scenario methods" do
+    context "that contains a configure scenario method" do
 
       let(:response) { issue_request("registered_in_configure_scenario_method") }
 
@@ -37,7 +35,7 @@ describe "Configurer Part acceptance" do
 
     end
 
-    context "that contains a configure scenarios methods" do
+    context "that contains a configure scenarios method" do
 
       let(:response) { issue_request("registered_in_configure_scenarios_method") }
 

data/spec/acceptance/cross_origin_support_spec.rb

@@ -7,18 +7,14 @@ describe "Cross origin support acceptance" do
   context "when a stub server with cross origin support is initialized" do
     include_context "configurer integration"
 
-    def server_name
-      "cross_origin_stub"
+    let(:configurer_specification) do
+      { class: HttpStub::Examples::ConfigurerWithCrossOriginSupport, name: :cross_origin_stub, port: 8004 }
     end
 
-    let(:configurer) { HttpStub::Examples::ConfigurerWithCrossOriginSupport.new }
-
-    before(:example) { configurer.class.initialize! }
-
     context "and a browser page rendered by a different server requests a scenario be activated" do
 
       before(:example) do
-        cross_origin_page.load_and_wait_until_available
+        cross_origin_page.load_and_wait_until_available(server_port)
         cross_origin_page.activate_scenario("Get scenario")
       end
 
@@ -54,7 +50,7 @@ describe "Cross origin support acceptance" do
 
     context "and a scenario configuring OPTIONS request reponses is activated" do
 
-      before(:example) { configurer.activate!("Options scenario") }
+      before(:example) { stub_server.activate!("Options scenario") }
 
       context "and a matching pre-flight request is made" do
 
@@ -84,14 +80,12 @@ describe "Cross origin support acceptance" do
   context "when a stub server without cross origin support is initialized" do
     include_context "configurer integration"
 
-    let(:configurer) { HttpStub::Examples::ConfigurerWithTrivialScenarios.new }
-
-    before(:example) { configurer.class.initialize! }
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithTrivialScenarios } }
 
     context "and a browser page rendered by a different server requests a scenario be activated" do
 
       before(:example) do
-        cross_origin_page.load_and_wait_until_available
+        cross_origin_page.load_and_wait_until_available(server_port)
         cross_origin_page.activate_scenario("Get scenario")
       end
 
@@ -107,7 +101,7 @@ describe "Cross origin support acceptance" do
 
     context "and a scenario is activated" do
 
-      before(:example) { configurer.activate!("Scenario 1") }
+      before(:example) { stub_server.activate!("Scenario 1") }
 
       context "and a matching request is made" do
 

data/spec/acceptance/endpoint_template_spec.rb

@@ -1,11 +1,9 @@
 describe "Endpoint Template acceptance" do
-  include_context "configurer integration"
 
   context "when a configurer contains an endpoint template" do
+    include_context "configurer integration"
 
-    let(:configurer) { HttpStub::Examples::ConfigurerWithEndpointTemplate.new }
-
-    before(:example) { configurer.class.initialize! }
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithEndpointTemplate } }
 
     it "does not register a stub when the template is defined" do
       response = issue_request("template_uri")

data/spec/acceptance/request_reference_spec.rb

@@ -1,9 +1,7 @@
 describe "Request references in response acceptance" do
   include_context "configurer integration"
 
-  let(:configurer) { HttpStub::Examples::ConfigurerWithRequestReferences.new }
-
-  before(:example) { configurer.class.initialize! }
+  let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithRequestReferences } }
 
   context "when a request is made matching a stub that references request attributes" do
 

data/spec/acceptance/scenario_spec.rb

@@ -1,17 +1,15 @@
 describe "Scenario acceptance" do
-  include_context "configurer integration"
 
   context "when a configurer that contains scenarios is initialized" do
+    include_context "configurer integration"
 
-    let(:configurer)  { HttpStub::Examples::ConfigurerWithTrivialScenarios.new }
-
-    before(:example) { configurer.class.initialize! }
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithTrivialScenarios } }
 
     context "and a scenario is activated" do
 
       context "containing stubs" do
 
-        before(:example) { configurer.activate!("Scenario 1") }
+        before(:example) { stub_server.activate!("Scenario 1") }
 
         (1..3).each do |stub_number|
 
@@ -32,7 +30,7 @@ describe "Scenario acceptance" do
 
       context "containing triggered scenarios" do
 
-        before(:example) { configurer.activate!("Activates another scenario") }
+        before(:example) { stub_server.activate!("Activates another scenario") }
 
         (1..3).each do |stub_number|
 
@@ -69,9 +67,9 @@ describe "Scenario acceptance" do
 
     context "and the response contains a file" do
 
-      let(:configurer) { HttpStub::Examples::ConfigurerWithFileResponses.new }
+      let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithFileResponses } }
 
-      before(:example) { configurer.activate!("Scenario with file") }
+      before(:example) { stub_server.activate!("Scenario with file") }
 
       context "and the stub request is made" do
 
@@ -79,7 +77,7 @@ describe "Scenario acceptance" do
 
         it "replays the stubbed response" do
           expect(response.code).to eql(200)
-          expect_response_to_contain_file(HttpStub::Examples::ConfigurerWithFileResponses::FILE_PATH)
+          expect(response).to contain_file(HttpStub::Examples::ConfigurerWithFileResponses::FILE_PATH)
         end
 
       end

data/spec/acceptance/server_defaults_spec.rb

@@ -1,11 +1,9 @@
 describe "Server defaults acceptance" do
-  include_context "configurer integration"
 
   context "when a configurer defines server defaults" do
+    include_context "configurer integration"
 
-    let(:configurer) { HttpStub::Examples::ConfigurerWithServerDefaults.new }
-
-    before(:example) { configurer.class.initialize! }
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithServerDefaults } }
 
     it "matches requests that match the request default rules" do
       response = issue_matching_request("has_defaults")

data/spec/acceptance/server_memory_spec.rb

@@ -0,0 +1,20 @@
+describe "Server memory acceptance" do
+
+  context "when a configurer with a stub is initialized" do
+    include_context "configurer integration"
+
+    let(:configurer_specification) { { class: HttpStub::Examples::ConfigurerWithTrivialStub } }
+
+    describe "GET /http_stub/memory" do
+
+      let(:response) { HTTParty.get("#{server_uri}/http_stub/memory") }
+
+      it "lists the stubs registered during initialization" do
+        expect(response.body).to include("Class stub body")
+      end
+
+    end
+
+  end
+
+end

data/spec/acceptance/session_spec.rb

@@ -0,0 +1,125 @@
+describe "Session acceptance" do
+
+  context "when a configurer that has a session support enabled is initialized" do
+    include_context "configurer integration"
+
+    let(:configurer_specification) do
+      { class: HttpStub::Examples::ConfigurerWithSessions, name: :session_based_stub, port: 8003 }
+    end
+
+    context "when a stub is added to a session" do
+
+      let(:stub_session_id) { "some_session" }
+      let(:stub_session)    { stub_server.session(stub_session_id) }
+
+      let(:match_response) { HTTParty.get("#{server_uri}/matching_path", request_session_id_header) }
+
+      before(:example) { stub_session.activate!("Some Scenario") }
+
+      context "and a matching request is made "do
+
+        before(:example) { match_response }
+
+        context "that is issued from the same session" do
+
+          let(:request_session_id) { stub_session_id }
+
+          let(:match_list_response) { HTTParty.get("#{server_uri}/http_stub/stubs/matches", request_session_id_header) }
+
+          it "matches" do
+            expect(match_response.code).to eql(200)
+          end
+
+          it "registers a match" do
+            expect(match_list_response.body).to include("matching_path")
+          end
+
+        end
+
+        context "that is issued from another session" do
+
+          let(:request_session_id) { "another_session" }
+
+          let(:miss_list_response) { HTTParty.get("#{server_uri}/http_stub/stubs/misses", request_session_id_header) }
+
+          it "does not match" do
+            expect(match_response.code).to eql(404)
+          end
+
+          it "registers a miss" do
+            expect(miss_list_response.body).to include("matching_path")
+          end
+
+        end
+
+      end
+
+      context "and the session is reset" do
+
+        let(:request_session_id) { stub_session_id }
+
+        before(:example) { stub_session.reset! }
+
+        context "and a matching request is issued from the same session" do
+
+          it "does not match" do
+            expect(match_response.code).to eql(404)
+          end
+
+        end
+
+      end
+
+      def request_session_id_header
+        { headers: { "http_stub_session_id" => request_session_id } }
+      end
+
+    end
+
+    context "when many sessions have been created" do
+
+      let(:session_ids) { (1..3).map { |i| "session#{i}"} }
+      let(:sessions)    { session_ids.map { |session_id| stub_server.session(session_id) } }
+
+      before(:example) { sessions.each { |session| session.activate!("Some Scenario") } }
+
+      describe "the administration landing page" do
+
+        let(:landing_page_response) { HTTParty.get("#{server_uri}/http_stub") }
+
+        it "lists the sessions" do
+          session_ids.each { |session_id| expect(landing_page_response.body).to include(session_id) }
+        end
+
+        it "does not link to stubs" do
+          expect(landing_page_response.body).to_not include("/stubs")
+        end
+
+      end
+
+    end
+
+  end
+
+  context "when a configurer that has a session support disabled is initialized" do
+    include_context "configurer integration"
+
+    let(:configurer_specification) { { class: HttpStub::EmptyConfigurer } }
+
+    describe "the administration landing page" do
+
+      let(:landing_page_response) { HTTParty.get("#{server_uri}/http_stub") }
+
+      it "links to stubs" do
+        expect(landing_page_response.body).to include("/stubs")
+      end
+
+      it "does not list sessions" do
+        expect(landing_page_response.body).to_not include("/sessions")
+      end
+
+    end
+
+  end
+
+end