iotics-grpc-client-rs

\ IOTICS gRPC client in Rust.

Usage and Version Compatibility with Iotics host:

| iotics-grpc-client-rs | iotics-host | | ------------------------------ | ----------- | | iotics-grpc-client = "3.x.x" | >= 5 | | iotics-grpc-client = "2.x.x" | >= 5 | | iotics-grpc-client = "0.3.x" | >= 4 |

API Docs

Running the examples

Rename .env-sample to .env and give values to the environment variables.

bash git clone --recurse-submodules git@github.com:Iotic-Labs/iotics-grpc-client-rs.git cargo run --features tls --example search

Contributing

Proto files

• Are submoduled in api/ from https://github.com/Iotic-Labs/api.
• proto/google/rpc/status.proto is included as it's a dependency.

Incrementing the API version

Run

```bash cd api git fetch --all --tags git checkout tags/vX.X.X cd .. git add api

git commit -m "Updated api to vX.X.X" git push ```

Updating the API version

bash git submodule update --remote

PRs

Commands to run before creating a PR

bash cargo make format cargo make clippy

Should contain a summary of the changes in CHANGELOG.md under the Unreleased section.

Releasing

• Increment the version in Cargo.toml
• Update README.md and CHANGELOG.md as needed
• Commit
• Tag the commit and push the changes to main

bash git push git tag -a vX.X.X -m "vX.X.X" git push origin vX.X.X

• Release\ Create a new release containing the relevant change log.\ The publish.yaml GitHub Action will pick it up and do the actual release to crates.io.