CloudEvents v0.8.0

What's Changed

• Governance
  • add some missing governance docs by @duglin in #213
  • Governance docs per CE PR 1226 by @duglin in #215
  • add link to our security mailing list by @duglin in #217
• Simplify warp doctest in order to pass with latest v0.3.6 by @jcrossley3 in #218
• remove unnecessary clones by @DirkRusche in #224
• Add WASI support
  • WASI support by @No9 in #202
  • WASI example by @No9 in #228
• Add AttributeValue::Binary; align order of AttributeValue with spec by @bobby in #238
• Fix wasm-bindgen-maro issue. by @ozabalaferrera in #248

Dependency updates

• chore: remove dep claim, bump axum version by @xiaoas in #206
• Bump webpack from 5.75.0 to 5.76.0 in /example-projects/reqwest-wasm-example by @dependabot in #208
• Bump postcss from 8.3.5 to 8.4.31 in /example-projects/reqwest-wasm-example by @dependabot in #216
• Bump follow-redirects from 1.14.8 to 1.15.4 in /example-projects/reqwest-wasm-example by @dependabot in #219
• Bump ip from 1.1.5 to 1.1.9 in /example-projects/reqwest-wasm-example by @dependabot in #220
• Bump webpack-dev-middleware and webpack-dev-server in /example-projects/reqwest-wasm-example by @dependabot in #222
• Bump follow-redirects from 1.15.4 to 1.15.6 in /example-projects/reqwest-wasm-example by @dependabot in #221
• Bump express from 4.18.2 to 4.19.2 in /example-projects/reqwest-wasm-example by @dependabot in #223
• Update rdkafka-lib version to ^0.36 by @k3rn31 in #226
• Bump ws from 8.16.0 to 8.17.1 in /example-projects/reqwest-wasm-example by @dependabot in #232
• Bump braces from 3.0.2 to 3.0.3 in /example-projects/reqwest-wasm-example by @dependabot in #231
• Bump cookie and express in /example-projects/reqwest-wasm-example by @dependabot in #239
• Bump webpack from 5.76.0 to 5.95.0 in /example-projects/reqwest-wasm-example by @dependabot in #241
• Upgrade dependencies, including http and hyper, where possible. by @ozabalaferrera in #233
• Update rdkafka, axum, and http. by @ozabalaferrera in #249

New Contributors

• @xiaoas made their first contribution in #206
• @DirkRusche made their first contribution in #224
• @k3rn31 made their first contribution in #226
• @No9 made their first contribution in #202
• @bobby made their first contribution in #238
• @ozabalaferrera made their first contribution in #233

Full Changelog: 0.7.0...0.8.0

CloudEvents v0.7.0

• Batch Event implementation for reqwest bindings #200
• dependency updates

CloudEvents v0.6.0

A few critical fixes and dependency updates.

And a new NATS binding!

CloudEvents v0.5.0

Includes support for the latest official actix-web release: v4

Introducing experimental support for the new Rust web libraries: axum and poem.

Reorganized integration with external libraries

On the behalf of CloudEvents community, I'm pleased to announce the 0.4 release of cloudevents/sdk-rust!

No more integration crates!

From now on, integrations are not going to be shipped as separate crates anymore, but as features within the cloudevents-sdk crate, under the cloudevents::binding module. These features are:

• actix to use the cloudevents::binding::actix module
• reqwest to use the cloudevents::binding::reqwest module
• rdkafka to use the cloudevents::binding::rdkafka module
• warp to use the cloudevents::binding::warp module (details below)

Check out the refreshed examples for more details: https://github.com/cloudevents/sdk-rust/tree/master/example-projects

Deeper actix-web integration

Thanks to the change described above, we can now provide deeper integrations with the various libraries. As an example, now we provide implementations of actix_web::FromRequest and actix_web::Responder for cloudevents::Event, which allows you to read and write CloudEvents in HTTP envelopes without invoking any additional method:

#[post("/")]
async fn post_event(event: Event) -> Event {
    println!("Received Event: {:?}", event);
    event
}

#[get("/")]
async fn get_event() -> Event {
    EventBuilderV10::new()
        .id("0001")
        .ty("example.test")
        .source("http://localhost/")
        .data("application/json", json!({"hello": "world"}))
        .extension("someint", "10")
        .build()
        .unwrap()
}

Check out the updated actix-web example: https://github.com/cloudevents/sdk-rust/blob/master/example-projects/actix-web-example/

seanmonstar/warp integration

We have a new integration with the web server framework warp, please check it out! For more details: #97

API Breaking changes

There is a breaking change in the type of the source attribute, which now uses an alias type for String. As described in the original issue, because the url::Url type cannot store URI references, we had to modify the type to String to fix incompatibilities. For more details: #106

And more

Other notable changes:

• Updated warp to 0.3, rdkafka to 0.25 and reqwest to 0.11: #113
• Fix null attributes in the json unmarshalling, per recent spec update: #142

I wish to thank all the contributors involved in this release!

For a complete list check out the milestone: https://github.com/cloudevents/sdk-rust/milestone/4?closed=1

Serde hotfix

This release includes an important hotfix that prevents sdk-rust to work with the latest version of serde: #110
It also includes an internal refactoring that removes serde-value dependency: #107

For a complete changelog, look at: https://github.com/cloudevents/sdk-rust/milestone/5?closed=1

Refreshed APIs and aligned with Rust conventions

On the behalf of CloudEvents community, I'm pleased to announce the 0.3 release of cloudevents/sdk-rust!

Changes to the APIs

This release includes important (breaking) changes, in order to align with the Rust API Guidelines. Below you'll find a non exhaustive list of all the relevant changes.

Event APIs

• The getters were renamed from get_x to x, following C-GETTER
• Now all setters returns the previous value of the field
• Now Data is exported in the main crate
• Implemented the various std traits Debug, Display, Eq/PartialEq, whenever possible, in public data types
• Reworked read/write data apis in Event. Now there are no more hidden copies. To read data, you can get a borrow with get_data or the ownership with take_data. To set the data, you can use both set_data or set_data_unchecked and you must manually invoke the conversion from T to event::Data (usually with try_into())
• set_datacontenttype and set_dataschema now are part of Event public API
• Removed Data::from_* methods, since they were not really useful and they were confusing

Message APIs

• Now message::Error is Send and Sync
• Renamed some variants of message::Error, following G-GOOD-ERR

Integrations

• Actix-web integration: Renamed RequestExt::into_event to RequestExt::to_event, following C-CONV
• Actix-web integration: Renamed cloudevents_sdk_actix_web::RequestExt to cloudevents_sdk_actix_web::HttpRequestExt for consistency
• All integrations: All *Ext trait are now sealed, following C-SEALED

Other changes

• Actix-web updated to 3.0
• Now our CI runs the matrix of different supported build targets (glibc/musl/wasm) in each PR and run more lints
• Now our CI test examples
• A lot of additions to our docs

For a complete changelog, look at: https://github.com/cloudevents/sdk-rust/milestone/3?closed=1

What's next

In the next releases, we'll focus on improving the stability of the main crate cloudevents-sdk. We're also working on adding support for no_std and we hope to receive new contributions for new integrations!

Huge thanks to all people involved in this release!

0.2: Kafka and new APIs to work with Event

On the behalf of CloudEvents community, I'm pleased to announce the 0.2 release of cloudevents/sdk-rust.

New features

• New crate cloudevents-sdk-rdkafka: Integration with https://fede1024.github.io/rust-rdkafka. Now you can easily send and receive CloudEvents to/from Kafka using rust! #60 by @pranav-bhatt
• New nice apis in cloudevents-sdk-reqwest and cloudevents-sdk-actix-web: #57 & #58 by @pranav-bhatt
• New APIs on Event to iterate through context attributes, extensions and both: #55 & #66 by @pranav-bhatt & @slinkydeveloper
• Redesigned the event builder, now it doesn't require manual parsing of url and time and it can be cloned (to use it as template): #53 by @slinkydeveloper

Improvements & bug fixes

• Improvements in docs: #51 & #71
• Now Event deserialization does not assume default values anymore (and it fails if some mandatory attributes are not there): #41

Breaking changes

• Removed hardcoded constants from specversion crate: #52
• Redesigned the event builder, now it requires importing the EventBuilder trait and returns Result on build(). It also does not assume anymore the default values: #53

For a complete changelog, look at: https://github.com/cloudevents/sdk-rust/milestone/2?closed=1

Huge thanks to all people involved in this release!

First release of sdk-rust

Yes, this time it's for real! We're pleased to announce you the first release of sdk-rust! Look at https://github.com/cloudevents/sdk-rust#get-started to start using it

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

First release!

The first release is out on crates.io: https://crates.io/crates/cloudevents-sdk