Enum StringRepr 

#[non_exhaustive]
pub enum StringRepr {
    String,
    Custom(String),
}

The Rust type a proto string field maps to in generated owned structs.

The default is String. Custom substitutes any type named by its fully-qualified Rust path — for example ::smol_str::SmolStr, ::ecow::EcoString, or ::compact_str::CompactString for read-mostly schemas — that satisfies the buffa::ProtoString bound. The downstream crate must itself depend on the crate providing that type (buffa does not re-export it).

Select a representation through buffa_build’s string_type / string_type_custom builder methods. The wire format is identical regardless of representation — only the in-memory owned type changes; view types keep borrowing &str, and map<_, string> / map<string, _> keys and values always stay String.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

String

::buffa::alloc::string::String — growable and mutable (the default).

Custom(String)

A custom type named by its fully-qualified Rust path (e.g. "::smol_str::SmolStr"). Must satisfy buffa::ProtoString and be provided by a crate the downstream depends on.

Limitations

• A foreign custom type used as a repeated element fails to compile (the emitted ReflectElement impl violates the orphan rule). Wrap it in a crate-local newtype for that case; singular / optional / oneof / map uses work with a foreign type directly.
• A path that does not parse as a Rust type surfaces as CodeGenError::InvalidTypePath at generation (.compile()) time.
• The per-element impls are deduplicated within a single generation, but the same crate-local type used as a repeated element across two separate compile() invocations in one crate emits the impl twice (a duplicate-impl E0119). Generate from a single compile(), or use distinct element types.

Trait Implementations

impl Clone for StringRepr

fn clone(&self) -> StringRepr

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StringRepr

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StringRepr

fn default() -> StringRepr

Returns the “default value” for a type.

impl Eq for StringRepr

impl PartialEq for StringRepr

fn eq(&self, other: &StringRepr) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StringRepr