PubSub

Report a Bug · Request a Feature

🌟 Give us a star — your support means the world to us!

All information about this project can be found in our detailed documentation.

SimpleCloud PubSub is a lightweight, high-performance publish-subscribe messaging system built on gRPC. It provides reliable message delivery and automatic reconnection handling for distributed systems.

Features

• gRPC-based Communication: High-performance message delivery using Protocol Buffers
• Automatic Reconnection: Built-in reconnection handling for network interruptions
• Type-Safe Messages: Strongly typed message handling with Protocol Buffers
• Concurrent Processing: Thread-safe message publishing and subscription
• Connection Management: Flexible connection configuration with optional credentials
• Flow-based API: Modern Kotlin Flow-based subscription handling
• Error Handling: Comprehensive error handling and recovery mechanisms

Dependency

For always up-to-date artifacts visit dev artifacts or artifacts.

Note: If you want to use the dev version, you have to use the snapshot repository.

Gradle Kotlin DSL

repositories {
    mavenCentral()
    maven("https://buf.build/gen/maven")
}

dependencies {
    implementation("app.simplecloud:pubsub:VERSION")
}

Gradle Groovy

repositories {
    mavenCentral()
    maven { url 'https://buf.build/gen/maven' }
}

dependencies {
    implementation 'app.simplecloud:pubsub:VERSION'
}

Maven

<repositories>
    <repository>
        <id>buf-build</id>
        <url>https://buf.build/gen/maven</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>app.simplecloud</groupId>
        <artifactId>pubsub</artifactId>
        <version>VERSION</version>
    </dependency>

Contributing

Contributions to SimpleCloud are welcome and highly appreciated. However, before you jump right into it, we would like you to read our Contribution Guide.

License

This repository is licensed under Apache 2.0.