Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hnaderi/lepus
Your principled, purely functional, non-blocking RabbitMQ client for scala, scala js and scala native built on top of fs2
https://github.com/hnaderi/lepus
amqp amqp0-9-1 cats-effect functional-programming rabbitmq rabbitmq-client scala scala-js scala-native scalajs scalanative typelevel
Last synced: 2 months ago
JSON representation
Your principled, purely functional, non-blocking RabbitMQ client for scala, scala js and scala native built on top of fs2
- Host: GitHub
- URL: https://github.com/hnaderi/lepus
- Owner: hnaderi
- License: apache-2.0
- Created: 2021-08-07T16:20:50.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-05T01:09:25.000Z (3 months ago)
- Last Synced: 2024-11-05T02:17:08.020Z (3 months ago)
- Topics: amqp, amqp0-9-1, cats-effect, functional-programming, rabbitmq, rabbitmq-client, scala, scala-js, scala-native, scalajs, scalanative, typelevel
- Language: Scala
- Homepage: http://lepus.hnaderi.dev/
- Size: 1.46 MB
- Stars: 24
- Watchers: 2
- Forks: 5
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Lepus
Purely functional Scala client for RabbitMQ and other AMQP 0.9.1 brokers
[](https://index.scala-lang.org/hnaderi/lepus/lepus-client)
[](https://javadoc.io/doc/dev.hnaderi/lepus-docs_3)
[](https://scala-steward.org)
## Use
This library is published for scala 3 on all scala platforms (JVM, JS, Native);
Add this to your build:
```scala
libraryDependencies += "dev.hnaderi" %% "lepus-client" % ""
```
Then you are ready to use Lepus, for tutorial continue to [documentation site](https://lepus.hnaderi.dev)!
Also please drop a ⭐ if this project interests you. I need encouragement.
## Why?
If you have ever used [Skunk](https://github.com/tpolecat/skunk) you might agree with me on how much it's fun to use and meanwhile insightful for its users. This project started with this in mind and I hope it achieves its goals.
## I mean, why not use the official java client and use Lepus instead?
I'm not in a position to tell you what you should use, but if you are tired of wrappers over the java client,
or want to use more advanced features of RabbitMQ that are not available in other Scala clients, or if you want a clean purely functional client for RabbitMQ (or other AMQP compliant message brokers) take a look at this library and then assess your requirements. You can see [features](https://lepus.hnaderi.dev/features.html) for some more information.
## Examples
Visit [here](https://lepus.hnaderi.dev/examples) or check [example directory](example/src/main/scala/example) for more examples.
## What in the world is Lepus?
Lepus[^1] (/ˈliːpəs/, colloquially /ˈlɛpəs/) is a constellation lying just south of the celestial equator. Its name is Latin for hare. It is located below—immediately south—of Orion (the hunter), and is sometimes represented as a hare being chased by Orion or by Orion's hunting dogs.
## Disclaimer
This software is a perpetual beta release, while it might be totally okay to use it in production for most cases, it's worthy to mention that you need to manage your risks carefully!
[^1]: https://en.wikipedia.org/wiki/Lepus_(constellation)
-----
Logo illustration by Catalina Vásquez
from Los Animales del cielo