Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/igrigorik/em-http-request

Asynchronous HTTP Client (EventMachine + Ruby)
https://github.com/igrigorik/em-http-request

Last synced: 5 days 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 (over 16 years ago)
Default Branch: master
Last Pushed: 2024-08-03T13:51:46.000Z (6 months ago)
Last Synced: 2024-10-29T14:59:17.370Z (3 months ago)
Language: Ruby
Homepage:
Size: 899 KB
Stars: 1,219
Watchers: 27
Forks: 221
Open Issues: 16
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 

[![Gem Version](https://badge.fury.io/rb/em-http-request.svg)](http://rubygems.org/gems/em-http-request)

[![CI](https://github.com/igrigorik/em-http-request/actions/workflows/ci.yml/badge.svg)](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