Struct EncodeOptions 

pub struct EncodeOptions {
    pub hash_algorithm: Option<HashAlgorithm>,
    pub emit_preceders: bool,
    pub compression_backend: CompressionBackend,
    pub threads: u32,
    pub parallel_threshold_bytes: Option<usize>,
}

Options for encoding.

Fields

hash_algorithm: Option<HashAlgorithm>

Hash algorithm to use for payload integrity. None = no hashing.

emit_preceders: bool

Reserved for future buffered-mode preceder support.

Currently, setting this to true in buffered mode (encode()) returns an error — use StreamingEncoder::write_preceder instead. The streaming encoder ignores this field; it emits preceders only when write_preceder() is called explicitly.

compression_backend: CompressionBackend

Which backend to use for szip / zstd when both FFI and pure-Rust implementations are compiled in.

Defaults to Ffi on native (faster, battle-tested) and Pure on wasm32 (FFI cannot exist). Override with TENSOGRAM_COMPRESSION_BACKEND=pure env variable, or set this field explicitly.

threads: u32

Thread budget for the multi-threaded coding pipeline.

• 0 (default) — sequential (current behaviour). Can be overridden at runtime via TENSOGRAM_THREADS=N.
• 1 — explicit single-threaded execution (bypasses env).
• N ≥ 2 — scoped pool of N workers. Output bytes are byte-identical to the sequential path regardless of N.

When more than one data object is being encoded the budget is spent axis-B-first (intra-codec parallelism) — this codebase tends to have a small number of very large messages. See the multi-threaded pipeline guide for the full policy.

Ignored with a one-time tracing::warn! when the threads cargo feature is disabled.

parallel_threshold_bytes: Option<usize>

Minimum total payload bytes below which the parallel path is skipped even when threads > 0.

None uses crate::DEFAULT_PARALLEL_THRESHOLD_BYTES (64 KiB). Set to Some(0) to force the parallel path for testing; set to Some(usize::MAX) to force sequential.

Trait Implementations

impl Clone for EncodeOptions

fn clone(&self) -> EncodeOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EncodeOptions

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

Formats the value using the given formatter.

impl Default for EncodeOptions

fn default() -> EncodeOptions

Returns the “default value” for a type.