vances/oda-api-sdk-rust

Open API SDK for Rust

Build

Building the ODA Open API SDK for Rust.

Tooling

Install Rust.
Install OpenAPI Generator.

Generate

Generate a client and server for each ODA Open API.

TMF634

openapi-generator-cli generate --generator-name rust-server --output tmf634 --additional-properties packageName=oda_sdk_tmf634 -i https://tmf-open-api-table-documents.s3.eu-west-1.amazonaws.com/OpenApiTable/4.1.0/swagger/TMF634-ResourceCatalog-v4.1.0.swagger.json

TMF639

openapi-generator-cli generate --generator-name rust-server --output tmf639 --additional-properties packageName=oda_sdk_tmf639 -i https://tmf-open-api-table-documents.s3.eu-west-1.amazonaws.com/OpenApiTable/4.0.0/swagger/TMF639-ResourceInventory-v4.0.0.swagger.json

Patch

Pending resolution of BUG17136 it is necesssary to patch the generated models for the servers:

sed -ie '/#\[validate(/a            length(min=1)' tmf{634,639}/src/models.rs

Build SDK

cargo build --workspace

Document SDK

cargo doc --workspace

Build Examples

cargo build --examples --workspace

Run Examples

cargo run --package oda_sdk_tmf634 --example client -- --help
cargo run --package oda_sdk_tmf634 --example server -- --help
cargo run --package oda_sdk_tmf639 --example client -- --help
cargo run --package oda_sdk_tmf639 --example server -- --help