Langohr, a feature-rich Clojure RabbitMQ client
- Embrace AMQP 0.9.1 Model. Follow Java client's API conventions instead of inventing new overly opinionated ones
- Be well documented. Use Ruby amqp gem guides as a foundation.
- Be well tested.
- Error handling and recovery should be well covered
- Support all of the RabbitMQ features, include extensions to AMQP 0.9.1.
- Make error handling and recovery easier
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
Langohr artifacts are released to Clojars. If you are using Maven, add the following repository
definition to your
<repository> <id>clojars.org</id> <url>http://clojars.org/repo</url> </repository>
The Most Recent Release
<dependency> <groupId>com.novemberain</groupId> <artifactId>langohr</artifactId> <version>2.0.1</version> </dependency>
Documentation & Examples
If you are only starting out, please see our Getting Started guide.
Documentation guides are incomplete but most of the content is there:
- AMQP 0.9.1 Concepts
- Conneciting To The Broker
- Queues and Consumers
- Exchanges and Publishing
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.
Supported Clojure Versions
Langohr requires Clojure 1.4. The most recent stable release is highly recommended.
Supported RabbitMQ Versions
Langohr depends on RabbitMQ Java client 3.0.x and thus should work with RabbitMQ versions 2.0 and later.
Langohr has been around since 2011. The API is stable.
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.
Langohr Is a ClojureWerkz Project
Langohr is part of the group of libraries known as ClojureWerkz, together with
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-2014 Michael S. Klishin