Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaelklishin/langohr
A small, feature complete Clojure client for RabbitMQ that embraces the AMQP 0.9.1 model
https://github.com/michaelklishin/langohr
amqp0-9-1 clojure clojurewerkz messaging rabbitmq
Last synced: 3 days ago
JSON representation
A small, feature complete Clojure client for RabbitMQ that embraces the AMQP 0.9.1 model
- Host: GitHub
- URL: https://github.com/michaelklishin/langohr
- Owner: michaelklishin
- Created: 2011-07-24T12:37:33.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T23:34:33.000Z (2 months ago)
- Last Synced: 2024-12-24T04:17:35.182Z (12 days ago)
- Topics: amqp0-9-1, clojure, clojurewerkz, messaging, rabbitmq
- Language: Clojure
- Homepage: http://clojurerabbitmq.info
- Size: 1.54 MB
- Stars: 356
- Watchers: 22
- Forks: 45
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# Langohr, a feature-rich Clojure RabbitMQ client
Langohr is a [Clojure RabbitMQ client](http://clojurerabbitmq.info) that embraces [AMQP 0.9.1 Model](http://www.rabbitmq.com/tutorials/amqp-concepts.html).
## Project Goals
* Embrace [AMQP 0.9.1 Model](http://www.rabbitmq.com/tutorials/amqp-concepts.html). Follow Java client's API conventions instead of inventing new overly opinionated ones
* Be well documented. Use [Ruby amqp gem guides](http://rubyamqp.info) 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](http://www.rabbitmq.com/extensions.html).
* Make error handling and recovery easier
We've learned a lot from years of experience with various RabbitMQ clients
and tried to apply this experience to Langohr design.
## Project Anti-Goals
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 protocol machinery from the developer
* A port of Bunny to Clojure
## Artifacts
Langohr artifacts are [released to Clojars](https://clojars.org/com.novemberain/langohr). If you are using Maven, add the following repository
definition to your `pom.xml`:
``` xml
clojars.org
http://clojars.org/repo
```
### The Most Recent Release
With [Leiningen](http://leiningen.org):
``` clojure
[com.novemberain/langohr "5.5.0"]
```
With `deps.edn`:
``` clojure
com.novemberain/langohr {:mvn/version "5.5.0"}
```
With Maven:
``` xml
com.novemberain
langohr
5.5.0
```
## Documentation & Examples
If you are only starting out, please see our [Getting Started guide](http://clojurerabbitmq.info/articles/getting_started.html).
[Documentation guides](http://clojurerabbitmq.info):
* [AMQP 0.9.1 Concepts](http://www.rabbitmq.com/tutorials/amqp-concepts.html)
* [Connecting To The Broker](http://clojurerabbitmq.info/articles/connecting.html)
* [Queues and Consumers](http://clojurerabbitmq.info/articles/queues.html)
* [Exchanges and Publishing](http://clojurerabbitmq.info/articles/exchanges.html)
* [Bindings](http://clojurerabbitmq.info/articles/bindings.html)
* [Durability](http://clojurerabbitmq.info/articles/durability.html)
* [TLS/SSL](http://clojurerabbitmq.info/articles/tls.html)
### API Reference
For existing users, there is [API reference](http://https://michaelklishin.github.io/langohr/index.html).
### Code Examples
Several code examples used in the guides are kept in [a separate Git repository](https://github.com/clojurewerkz/langohr.examples).
Our [test suite](https://github.com/michaelklishin/langohr/tree/master/test/langohr/test) also can be used for code examples.
## Supported Clojure Versions
Langohr requires Clojure 1.6+. The most recent
stable release is highly recommended.
## Supported RabbitMQ Versions
Langohr depends on RabbitMQ Java client 5.x and requires
a [supported RabbitMQ version](https://www.rabbitmq.com/versions.html).
## Project Maturity
Langohr has been around since 2011. The API is stable.
## Community
[Langohr has a mailing
list](https://groups.google.com/forum/#!forum/clojure-rabbitmq). 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](https://twitter.com/#!/clojurewerkz)
on Twitter.
## Langohr Is a ClojureWerkz Project
Langohr is part of the group of libraries known as [ClojureWerkz](http://clojurewerkz.org), together with
* [[Elastisch](https://github.com/clojurewerkz/elastisch)
* [Cassaforte](https://github.com/clojurewerkz/cassaforte)
* [Monger](https://github.com/clojurewerkz/monger)
* [Neocons](https://github.com/clojurewerkz/neocons)
* [Quartzite](https://github.com/clojurewerkz/quartize)
* [Titanium](https://github.com/clojurewerkz/titanium)
## Development
See [CONTRIBUTING.md](https://github.com/michaelklishin/langohr/blob/master/CONTRIBUTING.md).
## License
Copyright (C) 2011-2024 Michael S. Klishin and the ClojureWerkz Team.
Double licensed under the [Eclipse Public License](http://www.eclipse.org/legal/epl-v10.html) (the same as Clojure) or
the [Apache Public License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html).