Crates.io | dapr |
lib.rs | dapr |
version | 0.16.0-rc.2 |
source | src |
created_at | 2019-10-25 10:23:22.81831 |
updated_at | 2024-11-04 17:36:17.537206 |
description | Rust SDK for dapr |
homepage | |
repository | https://github.com/dapr/rust-sdk |
max_upload_size | |
id | 175571 |
size | 584,687 |
Dapr is a portable, event-driven, serverless runtime for building distributed applications across cloud and edge.
This SDK is currently in Alpha. Work is underway to bring forward a stable release and will likely involve breaking changes.
The maintainers commit to resolving any issues that arise and bringing this SDK to a stable release. With this in mind, the SDK will follow the norms and conventions of a stable SDK so far as is possible.
This SDK will be accounted for as a part of the release process. Support for the latest runtime release is targeted but not guaranteed.
The main tenet of development will be stability and functionality that improves resiliency.
Ensure you have Rust version 1.78 or higher installed. If not, install Rust here.
These crates no longer require protoc unless to recompile the protobuf files.
Add the following to your Cargo.toml
file:
[dependencies]
dapr = "0.16.0-rc.2"
Here's a basic example to create a client:
use dapr;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Get the Dapr port and create a connection
let port: u16 = std::env::var("DAPR_GRPC_PORT")?.parse()?;
let addr = format!("https://127.0.0.1:{}", port);
// Create the client
let mut client = dapr::Client::<dapr::client::TonicClient>::connect(addr).await?;
}
Browse through more examples to understand the SDK better: View examples
To build the SDK run:
cargo build
To fetch the latest .proto files from Dapr execute the script update-protos.sh
:
./update-protos.sh
By default, the script fetches the latest proto updates from the master branch of the Dapr repository. If you need to choose a specific release or version, use the -v flag:
./update-protos.sh -v v1.14.0
You will also need to install protoc.
Protos can then be compiled using:
cargo run proto-gen
Reach out with any questions you may have and we'll be sure to answer them as soon as possible!