http_parser.rb
A simple callback-based HTTP request/response parser for writing http servers, clients and proxies.
This gem is built on top of ry/http-parser and its java port a2800276/http-parser.java.
Supported Platforms
This gem aims to work on all major Ruby platforms, including:
- MRI 1.8 and 1.9
- Rubinius
- JRuby
- win32
Usage
require "http/parser"
parser = Http::Parser.new
parser.on_headers_complete = proc do
p parser.http_version
p parser.http_method # for requests
p parser.request_url
p parser.status_code # for responses
p parser.headers
end
parser.on_body = proc do |chunk|
# One chunk of the body
p chunk
end
parser. = proc do |env|
# Headers and body is all parsed
puts "Done!"
end
# Feed raw data from the socket to the parser
parser << raw_data
Advanced Usage
Accept callbacks on an object
module MyHttpConnection
def connection_completed
@parser = Http::Parser.new(self)
end
def receive_data(data)
@parser << data
end
def
@headers = nil
@body = ''
end
def on_headers_complete
@headers = @parser.headers
end
def on_body(chunk)
@body << chunk
end
def
p [@headers, @body]
end
end
Stop parsing after headers
parser = Http::Parser.new
parser.on_headers_complete = proc{ :stop }
offset = parser << request_data
body = request_data[offset..-1]