Solace-rs

The Unofficial Solace PubSub+ Rust Client Library.

Focuses on providing safe and idiomatic rust API over the C Solace library.

Features

• Publishing and subscribing
  • Direct
  • Persistent
• Solcache - (Untested)
• Request Reply - TODO
• Async - TODO

Installation

cargo add solace-rs

Configuring Solace Library Link

Right now, the library only supports static linking with solace-c-library. You can provide either a path, a url to download the library from or default (will download from default library source). The prority is also in the same order if multiple are defined.

Lib Path

You can configure the lib path to use for the solace c library. It must contain the solcient object files. Just add the following configurable-env to your config.toml file

[env]
SOLCLIENT_LIB_PATH=path_to_c_library_with_object_files

URL

You can configure the url to use for downloading the solace c library. Just add the following configurable-env to your config.toml file

[env]
SOLCLIENT_TARBALL_URL=link_to_c_library_tar_ball

Examples

You can find examples in the examples folder. The examples assume you have solace running on localhost:55554. To run them:

cargo run --example <example_name> -- <example_args>

Minimum supported Rust version (MSRV)

The current minimum supported Rust version (MSRV) is 1.70.0.

OS Support / CI Tests

• linux
• linux-musl
• macos-12
• windows (no plans)