Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/igrigorik/em-http-request
Asynchronous HTTP Client (EventMachine + Ruby)
https://github.com/igrigorik/em-http-request
Last synced: about 2 months ago
JSON representation
Asynchronous HTTP Client (EventMachine + Ruby)
- Host: GitHub
- URL: https://github.com/igrigorik/em-http-request
- Owner: igrigorik
- Created: 2008-08-22T20:53:40.000Z (about 16 years ago)
- Default Branch: master
- Last Pushed: 2024-01-09T12:55:00.000Z (9 months ago)
- Last Synced: 2024-04-14T16:07:40.528Z (5 months ago)
- Language: Ruby
- Homepage:
- Size: 888 KB
- Stars: 1,218
- Watchers: 28
- Forks: 218
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
Awesome Lists containing this project
- awesome-ruby-toolbox - em-http-request - EventMachine based, async HTTP Request client (Web Apps, Services & Interaction / HTTP clients)
README
# EM-HTTP-Request
[](http://rubygems.org/gems/em-http-request)
[](https://github.com/igrigorik/em-http-request/actions/workflows/ci.yml)
Async (EventMachine) HTTP client, with support for:
- Asynchronous HTTP API for single & parallel request execution
- Keep-Alive and HTTP pipelining support
- Auto-follow 3xx redirects with max depth
- Automatic gzip & deflate decoding
- Streaming response processing
- Streaming file uploads
- HTTP proxy and SOCKS5 support
- Basic Auth & OAuth
- Connection-level & global middleware support
- HTTP parser via [http_parser.rb](https://github.com/tmm1/http_parser.rb)
- Works wherever EventMachine runs: Rubinius, JRuby, MRI
## Getting started
gem install em-http-request
- Introductory [screencast](http://everburning.com/news/eventmachine-screencast-em-http-request)
- [Issuing GET/POST/etc requests](https://github.com/igrigorik/em-http-request/wiki/Issuing-Requests)
- [Issuing parallel requests with Multi interface](https://github.com/igrigorik/em-http-request/wiki/Parallel-Requests)
- [Handling Redirects & Timeouts](https://github.com/igrigorik/em-http-request/wiki/Redirects-and-Timeouts)
- [Keep-Alive and HTTP Pipelining](https://github.com/igrigorik/em-http-request/wiki/Keep-Alive-and-HTTP-Pipelining)
- [Stream processing responses & uploads](https://github.com/igrigorik/em-http-request/wiki/Streaming)
- [Issuing requests through HTTP & SOCKS5 proxies](https://github.com/igrigorik/em-http-request/wiki/Proxy)
- [Basic Auth & OAuth](https://github.com/igrigorik/em-http-request/wiki/Basic-Auth-and-OAuth)
- [GZIP & Deflate decoding](https://github.com/igrigorik/em-http-request/wiki/Compression)
- [EM-HTTP Middleware](https://github.com/igrigorik/em-http-request/wiki/Middleware)
## Extensions
Several higher-order Ruby projects have incorporated em-http and other Ruby HTTP clients:
- [EM-Synchrony](https://github.com/igrigorik/em-synchrony) - Collection of convenience classes and primitives to help untangle evented code (Ruby 1.9 + Fibers).
- [Rack-Client](https://github.com/halorgium/rack-client) - Use Rack API for server, test, and client side. Supports Rack middleware!
- [Example in action](https://gist.github.com/802391)
- [Faraday](https://github.com/lostisland/faraday) - Modular HTTP client library using middleware heavily inspired by Rack.
- [Example in action](https://gist.github.com/802395)
## Testing
- [WebMock](https://github.com/bblimke/webmock) - Library for stubbing and setting expectations on HTTP requests in Ruby.
- Example of [using WebMock, VCR & EM-HTTP](https://gist.github.com/802553)
## Other libraries & applications using EM-HTTP
- [VMWare CloudFoundry](https://github.com/cloudfoundry) - The open platform-as-a-service project
- [PubSubHubbub](https://github.com/igrigorik/PubSubHubbub) - Asynchronous PubSubHubbub ruby client
- [em-net-http](https://github.com/jfairbairn/em-net-http) - Monkeypatching Net::HTTP to play ball with EventMachine
- [chirpstream](https://github.com/joshbuddy/chirpstream) - EM client for Twitters Chirpstream API
- [rsolr-async](https://github.com/mwmitchell/rsolr-async) - An asynchronus connection adapter for RSolr
- [Firering](https://github.com/EmmanuelOga/firering) - Eventmachine powered Campfire API
- [RDaneel](https://github.com/hasmanydevelopers/RDaneel) - Ruby crawler which respects robots.txt
- [em-eventsource](https://github.com/AF83/em-eventsource) - EventSource client for EventMachine
- and many others.. drop me a link if you want yours included!
### License
(MIT License) - Copyright (c) 2011 Ilya Grigorik