#zeromq #native

zeromq

A native Rust implementation of ZeroMQ

2 unstable releases

0.2.0 Dec 28, 2020
0.1.0-pre Dec 18, 2014

40 downloads per month

MIT license

115KB
3K SLoC

zmq.rs - A native Rust implementation of ZeroMQ

DISCLAIMER: The codebase is very much a work in progress and feature incomplete. DO NOT USE IN PRODUCTION

ZeroMQ is a high-performance asynchronous messaging library that provides many popular messaging patterns for many transport types. They look and feel like Berkeley style sockets, but are fault tolerant and easier to use. This project aims to provide a native rust alternative to the reference implementation, and leverage Rust's async ecosystem.

Current status

A basic ZMTP implementation is working, but is not yet fully compliant to the spec. Integration tests against the reference implementation are also missing. External APIs are still subject to change - there are no semver or stability guarantees at the moment.

Supported transport types:

We plan to support most of the basic ZMQ sockets. The current list is as follows:

  • TCP
  • IPC (unix only)

Supported socket patterns:

We plan to support most of the basic ZMQ messaging patterns. The current list is as follows:

  • Request/Response (REQ, REP, DEALER, ROUTER)
  • Publish/Subscribe (PUB, SUB)
  • Pipeline (PUSH, PULL)

Usage

See the examples for some ways to get up and running quickly. You can also generate the documentation by doing cargo doc --open on the source code.

Choosing your async runtime

The project currently supports both tokio and async-std, controllable via feature flags. tokio is used by default. See the section about feature flags for more info.

Feature Flags

Feature flags provide a way to customize the functionality provided by this library. Refer to the cargo guide for more info.

Features:

  • (default) tokio-runtime: Use tokio as your async runtime.
  • async-std-runtime: Use async-std as your async runtime.

Contributing

Contributions are welcome! See our issue tracker for a list of the things we need help with.

Useful links

Dependencies

~4–7.5MB
~152K SLoC