Solace-rs

The Unofficial Solace PubSub+ Rust Client Library.

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

Features

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

Installation

```bash 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

```toml [env] SOLCLIENTLIBPATH=pathtoclibrarywithobjectfiles

```

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

```toml [env] SOLCLIENTTARBALLURL=linktoclibrarytar_ball

```

Examples

You can find examples in the examples folder. To run them:

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

Minimum supported Rust version (MSRV)

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

OS Support / CI Tests

• [x] linux
• [x] linux-musl
• [x] macos-12
• [ ] windows (no plans)