public
Homepage: http://rubyforge.org/projects/starling
Clone URL: git://github.com/defunkt/starling.git
defunkt (author)
Fri Jan 18 14:33:22 -0800 2008
commit  c64f3b06c362b7f3ed1e496f8b1fcefc84405854
tree    7bb0f25e0b0545833bb11c1494ff4aa7fdf2ef77
parent  cd9afc8151ab5a33eaf0a2833472dcc2e4604374
name age message
file History.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
file License.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
file Manifest.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
file README.txt Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
file Rakefile Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
directory bin/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
directory config/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
directory lib/ Fri Jan 18 14:27:47 -0800 2008 nonblocking writes, no fsync [defunkt]
directory script/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
file setup.rb Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
directory speed/ Fri Jan 18 14:33:22 -0800 2008 whoops, relative path [defunkt]
directory tasks/ Wed Jan 16 04:12:36 -0800 2008 evented starling [defunkt]
directory test/ Fri Jan 18 14:25:50 -0800 2008 tests work [defunkt]
directory 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.