solace-rs

Crates.iosolace-rs
lib.rssolace-rs
version
sourcesrc
created_at2023-09-05 04:33:13.499425
updated_at2024-11-07 07:16:49.917812
descriptionThe Unofficial Solace PubSub+ Rust Client Library. It can be used to access the services of a Solace PubSub+ Event Broker. This is a wrapper around the Solace C library. Use under your own risk! The C library is not included.
homepagehttps://github.com/asimsedhain/solace-rs
repositoryhttps://github.com/asimsedhain/solace-rs
max_upload_size
id963932
Cargo.toml error:TOML parse error at line 19, column 1 | 19 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Ashim Sedhain (asimsedhain)

documentation

https://docs.rs/solace-rs

README

Solace-rs

crates.io docs.rs ci

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
  • 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)
Commit count: 237

cargo fmt