Tokio NSQ

A Rust NSQ client built on Tokio. Tokio NSQ aims to be a feature complete NSQ client implementation.

Versioning

This project follows strict semantic versioning. While pre 1.0.0 breaking changes have only a minor version bump.

Basic consumer example

let topic   = NSQTopic::new("names").unwrap();
let channel = NSQChannel::new("first").unwrap();

let mut addresses = HashSet::new();
addresses.insert("http://127.0.0.1:4161".to_string());

let mut consumer = NSQConsumerConfig::new(topic, channel)
    .set_max_in_flight(15)
    .set_sources(
        NSQConsumerConfigSources::Lookup(
            NSQConsumerLookupConfig::new().set_addresses(addresses)
        )
    )
    .build();

let mut message = consumer.consume_filtered().await.unwrap();

let message_body_str = std::str::from_utf8(&message.body).unwrap();
println!("message body = {}", message_body_str);

message.finish();

Basic producer example

let topic = NSQTopic::new("names").unwrap();

let mut producer = NSQProducerConfig::new("127.0.0.1:4150").build();

println!("waiting on status");
let status = producer.consume().await;
println!("status {:?}", status);

producer.publish(&topic, "alice1".to_string().as_bytes().to_vec());

Features

• Subscriptions
• Publication
• NSQLookupd based discovery.
• Message Backoff
• NSQD TLS negotiation
  • Unverified server certificates
  • Custom certificate authority
  • Client certificates
• Deflate NSQD compression
• Snappy NSQD compression
• Sampling
• Auth