Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alex179ohm/nsq-client-rs
NSQ client written in rust
https://github.com/alex179ohm/nsq-client-rs
actix crate nsq nsq-client rust rust-crate rust-nsq rustlang
Last synced: 29 days ago
JSON representation
NSQ client written in rust
- Host: GitHub
- URL: https://github.com/alex179ohm/nsq-client-rs
- Owner: alex179ohm
- License: mit
- Created: 2019-02-13T17:00:40.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-11T13:03:41.000Z (almost 5 years ago)
- Last Synced: 2024-10-01T17:09:00.961Z (about 1 month ago)
- Topics: actix, crate, nsq, nsq-client, rust, rust-crate, rust-nsq, rustlang
- Language: Rust
- Homepage:
- Size: 328 KB
- Stars: 13
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# NSQ client written in rust [](https://travis-ci.com/alex179ohm/nsq-client-rs) [](https://ci.appveyor.com/project/alex179ohm/nsq-client-rs/branch/master) [](https://crates.io/crates/nsq-client)
Sponsored by 
---
A [Actix](https://actix.rs/) based client implementation for the [NSQ](https://nsq.io) realtime message processing system.
Nsq-client it's designed to support by default multiple Readers for Multiple Connections, readers are routed per single connection by a round robin algorithm.
## Usage
To use nsq-client, add this to your Cargo.toml:
```toml
[dependencies]
actix = "0.7"
nsq-client = "0.1.12"
```
### Create your first consumer
In order to use nsq-client you first need to create a Reader actor which implement Handler for the type of messages you want to receive
from the connections and then subscribe it to the connections to be able to receive the type of messages you've selected.
Available messages are:
- [Msg](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.Msg.html)
- [InFlight](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.InFlight.html)
- [OnIdentify](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.OnIdentify.html)
- [OnAuth](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.OnAuth.html)
- [OnClose](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.OnClose.html)
- [OnBackoff](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.OnBackoff.html)
- [OnResume](https://docs.rs/nsq-client/0.1.11/nsq_client/struct.OnResume.html)
### Simple Consumer (SUB)
```rust
extern crate actix;
extern crate nsq_client;
use std::sync::Arc;
use actix::prelude::*;
use nsq_client::{Connection, Msg, Fin, Subscribe, Config};
struct MyReader {
pub conn: Arc>,
}
impl Actor for MyReader {
type Context = Context;
fn started(&mut self, ctx: &mut Self::Context) {
self.subscribe::(ctx, self.conn.clone());
}
}
impl Handler for MyReader {
fn handle(&mut self, msg: Msg, _: &mut Self::Context) {
println!("MyReader received {:?}", msg);
if let Ok(body) = String::from_utf8(msg.body) {
println!("utf8 msg: {}", body);
}
self.conn.do_send(Fin(msg.id));
}
}
fn main() {
let sys = System::new("consumer");
let config = Config::default().client_id("consumer");
let c = Supervisor::start(|_| Connection::new(
"test", // <- topic
"test", // <- channel
"0.0.0.0:4150", // <- nsqd tcp address
Some(config), // <- config (Optional)
None, // secret for Auth (Optional)
Some(2) // <- RDY (Optional default: 1)
));
let conn = Arc::new(c);
let _ = MyReader{ conn: conn.clone() }.start(); // <- Same thread reader
let _ = Arbiter::start(|_| MyReader{ conn: conn }); // <- start another reader in different thread
sys.run();
}
```
### launch nsqd
```bash
$ nsqd -verbose
```
### launch the reader
```bash
$ RUST_LOG=nsq_client=debug cargo run
```
### launch the producer
```bash
$ cargo run
```
[](https://asciinema.org/a/8dZ5QgjN3WCwDhgU8mAX9BMsR)
## Examples
- [Simple Processing Message](https://github.com/alex179ohm/nsq-client-rs/tree/master/examples/reader)
- [Simple Producer](https://github.com/alex179ohm/nsq-client-rs/tree/master/examples/producer)
### ToDo
- [ ] Discovery
- [ ] TLS
- [ ] Snappy
- [ ] First-ready-first-served readers routing algorithm.
## License
Licensed under
* MIT license (see [LICENSE](LICENSE) or )