Langohr, a feature-rich Clojure RabbitMQ client that embraces AMQP 0.9.1 Model
Langohr is a Clojure RabbitMQ client that embraces AMQP 0.9.1 Model and does not try to hide it behind many layers of DSLs. It is pre-1.0 only in the sense that API is not completely locked down at this point: otherwise, it is solid and is used very actively to develop commercial products that involve thousands of nodes communicating with it.
- Embrace AMQP 0.9.1 Model. Follow Java client's API conventions instead of inventing new overly opinionated ones
- Provide additional functions/protocols where it actually saves time (we learned a lot from 3+ years history of the Ruby amqp gem development)
- Be well documented. Use Ruby amqp gem guides as a foundation.
- Strict TDD development style (with tests sometimes being freeform examples first)
- Support all of the RabbitMQ extensions to AMQP 0.9.1
- Provide support for testing of AMQP applications, including asynchronous workflows
- Provide additional batteries such as CLI interface to AMQP operations
Here is what Langohr does not try to be:
- A replacement for the RabbitMQ Java client
- Sugar-coated API for task queues that hides all the AMQP machinery from the developer
- A port of Ruby amqp gem to Clojure
If you are only starting out, please see our Getting Started guide.
Documentation guides are incomplete but most of the content is there:
The rest of the guides will be written eventually.
For existing users, there is API reference.
Several code examples used in the guides are kept in a separate Git repository.
Our test suite also can be used for code examples.
Langohr has a mailing list. Feel free to join it and ask any questions you may have.
To subscribe for announcements of releases, important changes and so on, please follow @ClojureWerkz on Twitter.
While the API is largely stabilized at this point, Langohr is a work in progress. Breaking API changes are not out of the question because it is much less painful to do them when the library is still young. Also, not every idea we have is implemented. Keep that in mind.
<dependency> <groupId>com.novemberain</groupId> <artifactId>langohr</artifactId> <version>1.0.0-beta11</version> </dependency>
Langohr is built from the ground up for Clojure 1.3 and up. The most recent stable release is highly recommended.
Langohr depends on RabbitMQ Java client 3.0.x and thus should work with RabbitMQ versions 2.0 and later.
Langohr is slowly approaching 1.0 release. A few remaining items before the release are
- Make the library even more Clojuric
- Finish documentation guides
- Design error handling and recovery
- Some stress tests to set baseline performance expectations
- Finish HTTP API client support
- Test suite cleanup
We expect 1.0 to be released in 2013 (but not before documentation guides are finished).
CI is hosted by travis-ci.org
Langohr uses Leiningen 2. Make sure you have it installed and then run tests against all supported Clojure versions using
lein2 all test
Then create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request on Github.
Copyright (C) 2011-2013 Michael S. Klishin
Distributed under the Eclipse Public License, the same as Clojure.