Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/smallrye/smallrye-mutiny
An Intuitive Event-Driven Reactive Programming Library for Java
https://github.com/smallrye/smallrye-mutiny
asynchronous java jvm programming quarkus reactive reactive-extensions reactive-streams streams vertx
Last synced: about 1 month ago
JSON representation
An Intuitive Event-Driven Reactive Programming Library for Java
- Host: GitHub
- URL: https://github.com/smallrye/smallrye-mutiny
- Owner: smallrye
- License: apache-2.0
- Created: 2019-07-22T12:48:27.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-30T09:57:40.000Z (about 1 month ago)
- Last Synced: 2024-10-01T05:22:32.815Z (about 1 month ago)
- Topics: asynchronous, java, jvm, programming, quarkus, reactive, reactive-extensions, reactive-streams, streams, vertx
- Language: Java
- Homepage: https://smallrye.io/smallrye-mutiny
- Size: 21.8 MB
- Stars: 807
- Watchers: 26
- Forks: 124
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚡️ Mutiny, an Intuitive Event-Driven Reactive Programming Library for Java
[Mutiny is a modern reactive programming library for Java](https://smallrye.io/smallrye-mutiny/).
Mutiny provides a simple but powerful asynchronous development model to build reactive applications.
This project is sponsored by [Red Hat](https://www.redhat.com/).
## 🚀 Overview
Mutiny can be used in any Java application exhibiting asynchrony.
From reactive microservices, data streaming, event processing to API gateways and network utilities, Mutiny is a great fit.
### Event-Driven
Mutiny places events at the core of its design.
With Mutiny, you observe events, react to them, and create elegant and readable processing pipelines.
**💡 A PhD in functional programming is not required.**
### Navigable
Even with smart code completion, classes with hundred of methods are confusing.
Mutiny provides a navigable and explicit API driving you towards the operator you need.
### Non-Blocking I/O
Mutiny is the perfect companion to tame the asynchronous nature of applications with non-blocking I/O.
Declaratively compose operations, transform data, enforce progress, recover from failures and more.
### Quarkus and Vert.x native
Mutiny is integrated in [Quarkus](https://quarkus.io) where every reactive API uses Mutiny, and [Eclipse Vert.x](https://vertx.io) clients are made available using [Mutiny bindings](https://github.com/smallrye/smallrye-mutiny-vertx-bindings).
Mutiny is however an independent library that can ultimately be used in any Java application.
### Reactive Converters Built-In
Mutiny is based on the [Reactive Streams protocol](https://www.reactive-streams.org/), and so it can be integrated with any other reactive programming library.
In addition, Mutiny offers converters to interact with other popular libraries and [Kotlin](https://kotlinlang.org/).
## 👓 Mutiny workshop examples
You can learn about Mutiny from the [documentation and website](https://smallrye.io/smallrye-mutiny).
This repository also contains the [Mutiny workshop examples](workshop-examples) that cover the common concerns through self-contained executable [JBang](https://www.jbang.dev/) scripts.
## 📦 Build instructions
Mutiny is built with Apache Maven, so all you need is:
```shell
./mvnw install
```
If you want to run a _quick_ build without running tests or generating API docs, then run:
```shell
./mvnw -Dquickly
```
| Git branch | Versions | Baseline | Compliance |
|------------|----------------------------------|---------------------------------------|----------------------------|
| `main` | 2.x.y *(in development)* | Java 11, `java.util.concurrent.Flow ` | Reactive Streams TCK 1.0.4 |
| `2.5.x` | 2.5.y *(backports, bug fixes)* | Java 11, `java.util.concurrent.Flow ` | Reactive Streams TCK 1.0.4 |
| `1.x` | 1.x.y *(sunset, rare bug fixes)* | Java 8, Reactive Streams 1.0.4 | Reactive Streams TCK 1.0.4 |
## ✨ Contributing
See [the contributing guidelines](CONTRIBUTING.md)
Mutiny is an open project, feel-free to:
- [report issues](https://github.com/smallrye/smallrye-mutiny/issues), and
- [propose enhancements via pull-requests](https://github.com/smallrye/smallrye-mutiny/pulls).
## 👋 Discussions and support
For anything related to the usage of Mutiny in Quarkus, please refer to the [Quarkus support](https://quarkus.io/support/)
For more general discussions about Mutiny, you can:
- [start a new discussion thread in GitHub Discussions (preferred option)](https://github.com/smallrye/smallrye-mutiny/discussions), or
- [use the `mutiny` tag on StackOverflow](https://stackoverflow.com/questions/tagged/mutiny).
## 🧪 Publications
Julien Ponge, Arthur Navarro, Clément Escoffier, and Frédéric Le Mouël. 2021. **[Analysing the Performance and Costs of Reactive Programming Libraries in Java](https://doi.org/10.1145/3486605.3486788).** *In Proceedings of the 8th ACM SIGPLAN International Workshop on Reactive and Event-Based Languages and Systems (REBLS ’21)*, October 18, 2021, Chicago, IL, USA. ACM, New York, NY, USA, 10 pages. [(PDF)](https://hal.inria.fr/hal-03409277/document)
## Stargazers over time
[](https://starchart.cc/smallrye/smallrye-mutiny)