public
Homepage: http://rubyforge.org/projects/starling
Clone URL: git://github.com/defunkt/starling.git
Search Repo:
name age message
folder History.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder License.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder Manifest.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder README.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder Rakefile Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder bin/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder config/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder lib/ Wed Jan 30 23:37:54 -0800 2008 whoops, forgot the newslines [defunkt]
folder script/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder setup.rb Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder speed/ Wed Jan 23 16:37:16 -0800 2008 use evans memcached client [defunkt]
folder tasks/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
folder test/ Wed Jan 30 23:27:48 -0800 2008 share the queue [defunkt]
folder website/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
README.txt
= Name

Starling - a light weight server for reliable distributed message passing.

= Synopsis

  # Start the Starling server as a daemonized process:
  starling -h 192.168.1.1 -d

  # Put messages onto a queue:
  require 'memcache'
  starling = MemCache.new('192.168.1.1:22122')
  starling.set('my_queue', 12345)

  # Get messages from the queue:
  require 'memcache'
  starling = MemCache.new('192.168.1.1:22122')
  loop { puts starling.get('my_queue') }

  # See the Starling documentation for more information.

= Description

Starling is a powerful but simple messaging server that enables reliable 
distributed queuing with an absolutely minimal overhead. It speaks the
MemCache protocol for maximum cross-platform compatibility. Any language
that speaks MemCache can take advantage of Starling's queue facilities.

= Known Issues

* Starling is "slow" as far as messaging systems are concerned. In practice,
  it's fast enough. If you'd like to help make it faster please do. Starting
  points would be to use an event-driven interface, and get rid of threading.

= Authors

Blaine Cook <romeda@gmail.com>

= Copyright

Starling - a light-weight server for reliable distributed message passing.
Copyright 2007 Blaine Cook <blaine@twitter.com>, Twitter Inc.