https://protobuf.dev/reference/rust/Recent content in Rust Reference on Protocol Buffers DocumentationHugoenhttps://protobuf.dev/reference/rust/rust-generated/Mon, 01 Jan 0001 00:00:00 +0000https://protobuf.dev/reference/rust/rust-generated/This page describes exactly what Rust code the protocol buffer compiler generates for any given protocol definition. This document covers how the protocol buffer compiler generates Rust code for proto2, proto3, and protobuf editions. Any differences between proto2, proto3, and editions generated code are highlighted. You should read the proto2 language guide, proto3 language guide, or editions guide before reading this document. Protobuf Rust Protobuf Rust is an implementation of protocol buffers designed to be able to sit on top of other existing protocol buffer implementations that we refer to as ‘kernels’.https://protobuf.dev/reference/rust/rust-redaction/Mon, 01 Jan 0001 00:00:00 +0000https://protobuf.dev/reference/rust/rust-redaction/Use the standard fmt::Debug ("{:?}" in format strings) on Protobuf messages for human-readable strings for logging, error messages, exceptions, and similar use cases. The output of this debug info is not intended to be machine-readable (unlike TextFormat and JSON which are not be used for debug output). Using fmt::Debug enables redaction of some sensitive fields. Note that under upb kernel this redaction is not yet implemented, but is expected to be added.https://protobuf.dev/reference/rust/building-rust-protos/Mon, 01 Jan 0001 00:00:00 +0000https://protobuf.dev/reference/rust/building-rust-protos/Cargo See the protobuf-example crate for an example of how to set up your build. Bazel The process of building a Rust library for a Protobuf definition is similar to other programming languages: Use the language-agnostic proto_library rule: proto_library( name = "person_proto", srcs = ["person.proto"], ) Create a Rust library: load("//third_party/protobuf/rust:defs.bzl", "rust_proto_library") proto_library( name = "person_proto", srcs = ["person.proto"], ) rust_proto_library( name = "person_rust_proto", deps = [":person_proto"], ) Use the library by including it in a Rust binary:https://protobuf.dev/reference/rust/rust-design-decisions/Mon, 01 Jan 0001 00:00:00 +0000https://protobuf.dev/reference/rust/rust-design-decisions/As with any library, Rust Protobuf is designed considering the needs of both Google’s first-party usage of Rust as well that of external users. Choosing a path in that design space means that some choices made will not be optimal for some users in some cases, even if it is the right choice for the implementation overall. This page covers some of the larger design decisions that the Rust Protobuf implementation makes and the considerations which led to those decisions.