beam-proto-rs

Rust codes generated from protocol buffer files in the apache/beam repository.

This repository also provides a build script to compile the protobuf into Rust codes.

Versioning

This crate basically follows the beam's versions.

v2.41.0 is generated from .protos from apache/beam tag:v2.41.0.
Some versions may have build numbers like v2.41.0+N, which means the N-th build (N > 1) generated from beam's tag:v2.41.0. 2nd and later builds are typically for bugfixes.

Development

Build

Generating .rs from beam's .proto requires build-proto feature flag.

bash cargo build --features build-proto -vv

-vv is to show eprintln!() strings to your terminal.

Updating Beam

beam/ is a git submodule.

console cd beam git fetch --tags git checkout v<NEW VERSION> cd .. git commit -am 'build: bump up beam to v<NEW VERSION>'

Deployment

Change version in Cargo.toml.
Update Beam.
Shrink submodule size to avoid 413 error from crates.io: cd beam; git sparse-checkout set model; cd ..
In the main branch: cargo publish.

License

Licensed under Apache License, Version 2.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in beam-proto-rs by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.