README.md

CloudEvents SDK Rust

This project implements the CloudEvents Spec for Rust.

Note: This project is WIP under active development, hence all APIs are considered unstable.

Spec support

	v0.3	v1.0
CloudEvents Core	✓	✓
AMQP Protocol Binding	✕	✕
AVRO Event Format	✕	✕
HTTP Protocol Binding	✓	✓
JSON Event Format	✓	✓
Kafka Protocol Binding	✓	✓
MQTT Protocol Binding	✕	✕
NATS Protocol Binding	✕	✕
Web hook	✕	✕

Crates

• cloudevents-sdk: Provides Event data structure, JSON Event format implementation. This module is tested to work with GNU libc, WASM and musl toolchains.
• cloudevents-sdk-actix-web: Integration with Actix Web.
• cloudevents-sdk-reqwest: Integration with reqwest.
• cloudevents-sdk-rdkafka: Integration with rust-rdkafka.
• cloudevents-sdk-warp: Integration with warp.

Get Started

To get started, add the dependency to Cargo.toml:

[dependencies]
cloudevents-sdk = "0.3.1"

Now you can start creating events:

use cloudevents::{EventBuilder, EventBuilderV10};
use url::Url;

let event = EventBuilderV10::new()
    .id("aaa")
    .source(Url::parse("http://localhost").unwrap())
    .ty("example.demo")
    .build()?;

Checkout the examples using our integrations to learn how to send and receive events:

• Actix Web Example
• Reqwest/WASM Example
• Kafka Example
• Warp Example

Development & Contributing

If you're interested in contributing to sdk-rust, look at Contributing documentation

Community

• There are bi-weekly calls immediately following the Serverless/CloudEvents call at 9am PT (US Pacific). Which means they will typically start at 10am PT, but if the other call ends early then the SDK call will start early as well. See the CloudEvents meeting minutes to determine which week will have the call.
• Slack: #cloudeventssdk (or #cloudevents-sdk-rust) channel under CNCF's Slack workspace.
• Email: https://lists.cncf.io/g/cncf-cloudevents-sdk
• Contact for additional information: Francesco Guardiani (@slinkydeveloper on slack).

Each SDK may have its own unique processes, tooling and guidelines, common governance related material can be found in the CloudEvents community directory. In particular, in there you will find information concerning how SDK projects are managed, guidelines for how PR reviews and approval, and our Code of Conduct information.