igrigorik-em-http-request

= EM-HTTP-Client

EventMachine based HTTP Request interface. Supports streaming response processing, uses Ragel HTTP parser.

• Simple interface for single & parallel requests via deferred callbacks
• Automatic gzip & deflate decoding
• Basic-Auth support
• Custom timeouts

Screencast / Demo of using EM-HTTP-Request:

• http://everburning.com/news/eventmachine-screencast-em-http-request/

== Simple client example

EventMachine.run { http = EventMachine::HttpRequest.new('http://127.0.0.1/').get :query => {'keyname' => 'value'}, :timeout => 10

http.callback {
  p http.response_header.status
  p http.response_header
  p http.response

  EventMachine.stop
}

}

== Multi request example

EventMachine.run { multi = EventMachine::MultiRequest.new

# add multiple requests to the multi-handler
multi.add(EventMachine::HttpRequest.new('http://www.google.com/').get)
multi.add(EventMachine::HttpRequest.new('http://www.yahoo.com/').get)
  
multi.callback  {
  p multi.responses[:succeeded]
  p multi.responses[:failed]
   
  EventMachine.stop
}

}

== Basic-Auth example

EventMachine.run { http = EventMachine::HttpRequest.new('http://www.website.com/').get :head => {'authorization' => ['user', 'pass']}

http.errback { failed }
http.callback {
  p http.response_header

  EventMachine.stop
}

}

== POST example

EventMachine.run { http1 = EventMachine::HttpRequest.new('http://www.website.com/').post :body => {"key1" => 1, "key2" => [2,3]} http2 = EventMachine::HttpRequest.new('http://www.website.com/').post :body => "some data"

# ...

}

== Streaming body processing EventMachine.run { http = EventMachine::HttpRequest.new('http://www.website.com/').get http.stream { |chunk| print chunk }

# ...

}