http-testing 0.1.1 → 0.1.2

data/README.rdoc

@@ -2,4 +2,76 @@
 
 Library for testing HTTP requests in Ruby.
 
-Samples will come soon :)
+= Install
+
+  gem install http-testing
+
+= General usage pattern
+  #Start HttpTesting context
+  c = HttpTesting::Context.start(30013) do |request, response|
+    # request - instance of WEBrick::HTTPRequest
+    # response - instance of WEBrick::HTTPResponse
+  
+    #Assert request properties
+  
+    #Set response
+  end
+
+  #Your code that will send request goes here
+
+  #Wait for request to complete
+  c.wait
+
+  #Check the result of request
+
+= RSpec sample
+
+  require 'spec_helper'
+  
+  describe "HTTP requests sender" do
+    it "should get '/say-hello'" do
+      #Start HttpTesting context on port 30013
+      c = HttpTesting::Context.start(30013) do |request, response|
+        # request - instance of WEBrick::HTTPRequest
+        # response - instance of WEBrick::HTTPResponse
+        
+        #Check method and path
+        request.request_method.should eql "GET"
+        request.path.should eql '/say-hello'
+        
+        #Set response
+        response.body = "Hello World"
+      end
+      
+      #Send get request
+      result = Net::HTTP.get(URI.parse('http://localhost:30013/say-hello'))
+      
+      #Wait for request to complete
+      c.wait
+      
+      #Check the result
+      result.should eql "Hello World"
+    end  
+    
+    it "should post '/hello-there'" do
+      #Starting context
+      c = HttpTesting::Context.start(30013) do |request, response|
+        #Checking method, path and body of request
+        request.request_method.should eql "POST"
+        request.path.should eql '/hello-there'
+        request.body.should eql "from=Mike"
+        
+        #Set response
+        response.body = "Hello"
+      end
+      
+      #Send post request
+      response = Net::HTTP.post_form(URI.parse('http://localhost:30013/hello-there'), :from => "Mike")
+      
+      #Wait for request to complete
+      c.wait
+      
+      #Check the result
+      response.body.should eql "Hello"
+    end
+  end

data/lib/http_testing/context.rb

@@ -20,6 +20,10 @@ class HttpTesting::Context
     @error     = nil
   end
   
+  def self.start(port, options = {}, &block)
+    new(port, options).start(&block)
+  end
+  
   def start(&block)
     @started   = false
     @completed = false
@@ -51,6 +55,7 @@ class HttpTesting::Context
     @monitor.synchronize do
       @started_cond.wait_until { @started }
     end
+    self
   end
   
   def wait

data/lib/http_testing/samples/rspec_sample.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe "HTTP requests sender" do
+  it "should get '/say-hello'" do
+    #Start HttpTesting context on port 30013
+    c = HttpTesting::Context.start(30013) do |request, response|
+      # request - instance of WEBrick::HTTPRequest
+      # response - instance of WEBrick::HTTPResponse
+      
+      #Check method and path
+      request.request_method.should eql "GET"
+      request.path.should eql '/say-hello'
+      
+      #Set response
+      response.body = "Hello World"
+    end
+    
+    #Send get request
+    result = Net::HTTP.get(URI.parse('http://localhost:30013/say-hello'))
+    
+    #Wait for request to complete
+    c.wait
+    
+    #Check the result
+    result.should eql "Hello World"
+  end  
+  
+  it "should post '/hello-there'" do
+    #Starting context
+    c = HttpTesting::Context.start(30013) do |request, response|
+      #Checking method, path and body of request
+      request.request_method.should eql "POST"
+      request.path.should eql '/hello-there'
+      request.body.should eql "from=Mike"
+      
+      #Setting response
+      response.body = "Hello"
+    end
+    
+    #Send post request
+    response = Net::HTTP.post_form(URI.parse('http://localhost:30013/hello-there'), :from => "Mike")
+    
+    #Wait for request to complete
+    c.wait
+    
+    #Check the result
+    response.body.should eql "Hello"
+  end
+end

data/lib/http_testing/version.rb

@@ -1,3 +1,3 @@
 module HttpTesting
-  VERSION = "0.1.1".freeze
+  VERSION = "0.1.2".freeze
 end

data/spec/context_spec.rb

@@ -1,14 +1,13 @@
 require 'spec_helper'
 
 describe HttpTesting::Context do
-  def context(options = {})
-    HttpTesting::Context.new(30013, options)
+  def context(options = {}, &block)
+    HttpTesting::Context.start(30013, options, &block)
   end
   
   it "should start web server at specified port" do
     started = false
-    c = context
-    c.start do |request, response|
+    c = context do |request, response|
       started = true
     end
     Net::HTTP.get(URI.parse('http://localhost:30013/'))
@@ -18,14 +17,12 @@ describe HttpTesting::Context do
   
   describe "wait" do
     it "should raise exception if no request received withing wait_timeout" do
-      c = context(:wait_timeout => 0)
-      c.start do |request, response| end
+      c = context(:wait_timeout => 0) do |request, response| end
       lambda { c.wait }.should raise_error(HttpTesting::HttpTestingError)
     end
     
     it "should reraise exception that was raised in start block" do
-      c = context(:wait_timeout => 0)
-      c.start do |request, response| 
+      c = context(:wait_timeout => 0) do |request, response| 
         raise "Error in start block"
       end
       Net::HTTP.get(URI.parse('http://localhost:30013/'))

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Evgeny Myasishchev
@@ -48,6 +48,7 @@ files:
 - http-testing.gemspec
 - lib/http_testing.rb
 - lib/http_testing/context.rb
+- lib/http_testing/samples/rspec_sample.rb
 - lib/http_testing/version.rb
 - spec/context_spec.rb
 - spec/spec_helper.rb