fcheung / typhoeus
watch download tarball
public
Forks21Right
Watchers1Right
Fork of pauldix/typhoeus
Description: Like a modern code version of the mythical beast with 100 serpent heads, Typhoeus runs HTTP requests in parallel while cleanly encapsulating handling logic.
Homepage:
Clone URL: git://github.com/fcheung/typhoeus.git
name age
history
message
file README.textile Loading commit data...
file Rakefile
directory benchmarks/
directory ext/
directory lib/
directory spec/
file typhoeus.gemspec
README.textile

Typhoeus

http://github.com/pauldix/typhoeus/tree/master

the mailing list

Summary

Like a modern code version of the mythical beast with 100 serpent heads, Typhoeus runs HTTP requests in parallel while cleanly encapsulating handling logic.

Description

A library for accessing web services in Ruby. It’s specifically designed for building service oriented architectures in Ruby that need to be fast enough to process calls to multiple services within an HTTP request/response life cycle.

Installation

For now Typhoeus exists only on github. It requires you to have a current version of libcurl installed. I’ve tested this with 7.19.4.



gem sources -a http://gems.github.com # if you haven’t already

gem install pauldix-typhoeus

If you’re on Debian or Ubuntu and getting errors while trying to install, it could be because you don’t have the latest version of libcurl installed. Do this to fix:


sudo apt-get install libcurl4-gnutls-dev

Another problem could be if you are running Mac Ports and you have libcurl installed through there. You need to uninstall it for curb to work! The version in Mac Ports is old and doesn’t play nice. You should download curl and build from source. Then you’ll have to install the gem again.

If you’re still having issues, please let me know on the mailing list.

Usage

  1. This will have to be extensive as there are usage patterns that may be foreign to users.

Benchmarks

  1. Put some notes here about how wickedly, insanely fast this library is.

Next Steps

  • Add support for error handling. Automatic retry, exponential back-off, queuing for later
  • Add server test suite
  • Add in the support for custom get and set methods on the cache
  • Mock out the cache server for tests

LICENSE

(The MIT License)

Copyright © 2009:

Paul Dix

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
‘Software’), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.