rbkb-http 0.2.0 → 0.2.1

data/History.txt

@@ -1,3 +1,6 @@
+== 0.2.1 / 2009-12-30
+  * Requests default to 'GET / HTTP/1.0'
+
 == 0.2.0 / 2009-10-06
   * split off rbkb/http from rbkb core.
   * added MultiPartFormParams support and TextPlainFormParams

data/README.rdoc

@@ -6,13 +6,56 @@ HTTP protocol addons for the Ruby BlackBag (rbkb-http)
 
 == DESCRIPTION
 
-This library various includes HTTP protocol tools and libraries based on and 
+This library includes HTTP protocol tools and libraries based on and 
 complementary to the Ruby BlackBag library.
 
+At it's core rbkb-http is simply a set of serializable and desieralizable 
+objects for HTTP request and response messages.
+
 == REQUIREMENTS
 
 * ruby blackbag (rbkb) - http://emonti.github.com/rbkb
 
+
+== SYNOPSIS
+
+  require 'rubygems'
+  require 'rbkb/http'
+
+  # we start with a raw HTTP request string
+  rawdat = "POST /foo HTTP/1.0
+  Content-Length: 10
+
+  a=12345678"
+
+  # ... which we parse into an abstract object
+  req = Rbkb::Http::Request.new()
+  req.capture(rawdat) 
+
+  # Or you could just say this in one shot
+  #req = Rbkb::Http::Request.parse(rawdat)
+
+  # now we can mess with the request body
+  req.body << "extrastuff"
+
+  # .. and/or action line
+  req.action.version="HTTP/1.1"
+
+  # ... and/or headers
+  req.headers.set_header("Host", "somehost.com")
+
+  # and spit out a new request string (content-length is auto-calculated!)
+  puts req.to_raw
+  -/snip-
+
+Which produces:
+
+  POST /foo HTTP/1.1
+  Content-Length: 20
+  Host: somehost.com
+
+  a=12345678extrastuff
+
 == Copyright
 
 Copyright (c) 2009 Eric Monti. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

data/lib/rbkb/http/headers.rb

@@ -316,7 +316,7 @@ module Rbkb::Http
       _common_init(*args)
       @verb ||= "GET"
       @uri ||= URI.parse("/")
-      @version ||= "HTTP/1.1"
+      @version ||= "HTTP/1.0"
     end
 
     def to_raw

data/lib/rbkb/http/request.rb

@@ -3,13 +3,19 @@ module Rbkb::Http
   # A Request encapsulates all the entities in a HTTP request message
   # including the action header, general headers, and body.
   class Request < Base
-    attr_accessor :action
+    def action
+      @action ||= RequestAction.new
+    end
+
+    def action=(a)
+      @action = a
+    end
 
     alias first_entity action
     alias first_entity= action=
 
     def action_parameters
-      @action.parameters
+      action.parameters
     end
     
     def body_parameters
@@ -43,10 +49,8 @@ module Rbkb::Http
       Body.new(*args)
     end
 
-    # Returns a raw HTTP request for this instance. The instance must have 
-    # an action element defined at the bare minimum.
-    def to_raw(tmp_body=@body)
-      raise "this request has no action entity" unless first_entity()
+    # Returns a raw HTTP request for this instance. 
+    def to_raw()
       self.headers ||= default_headers_obj()
       self.body ||= default_body_obj()
 
@@ -57,8 +61,8 @@ module Rbkb::Http
         @headers.delete_header("Content-Length")
       end
 
-      bstr = tmp_body.to_raw
-      hdrs = (@headers).to_raw_array.unshift(first_entity.to_raw)
+      bstr = @body.to_raw
+      hdrs = @headers.to_raw_array.unshift(first_entity.to_raw)
       return "#{hdrs.join("\r\n")}\r\n\r\n#{bstr}"
     end
 

data/rbkb-http.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rbkb-http}
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Eric Monti"]
-  s.date = %q{2009-11-12}
+  s.date = %q{2009-12-30}
   s.description = %q{HTTP libraries and tools based on and complementary to Ruby BlackBag}
   s.email = %q{emonti@matasano.com}
   s.extra_rdoc_files = [

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rbkb-http
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - Eric Monti
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-12 00:00:00 -06:00
+date: 2009-12-30 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency