activemessaging-kestrel-adapter version 1.0.2
    by Douglas A. Seifert
    http://github.org/seifertd/activemessaging-kestrel-adapter

== DESCRIPTION

This is an adapter to the kestrel messaging server for the ActiveMessaging
framework.  Version
1.X and greater compatible with Rails 3.1.3.  Version 0.0.5 and below
compatible with Rails 2.X.

== EXAMPLES

    require 'activemessaging-kestrel-adapter'

    # configure ActiveMessaging broker in an appropriate broker.yml file:
    # development:
    #   adapter: kestrel
    #   servers: localhost:22133
    #   empty_queues_delay: 0.1
    #   retry_policy:
    #     strategy: SimpleRetry
    #     config:
    #       tries: 1
    #       delay: 5
    # the retry_policy: second is optional and should be left out under
    # most circumstances (see below).
    config = YAML.load(File.read("broker.yml"))

    adapter =
ActiveMessaging::Adapters::Kestrel::Connection.new(config[:development])

    adapter.send("arbitrarily_named_queue", "message as string")
    adapter.subscribe("queue1")
    adapter.subscribe("queue2")
    adapter.receive # get a message from any of the subscribed queues, or
nil if they are all empty

== CHANGES

=== 1.0.2 / 2012-02-10
* Scrub queue names of illegal characters (according to kestrel v2.1.5).
 The illegal
  chars are '.', '/', '~'.

=== 1.0.1 / 2012-01-18
* Call load_extensions on ActiveMessaging before registering the adapter.
Avoids
  unresolved references to ActiveMessaging::Gateway.

=== 1.0.0 / 2012-01-17
* Change dependencies for Rails/activesupport 3.1.3.  This version is not
compatible
  with Rails 2.3.X.  Use 0.0.5 for Rails 2.3.X.