Module determinism 

Determinism validation for decode, encode, and round-trip operations. Determinism validation for COBOL copybook encoding and decoding operations.

This module verifies that encode/decode operations produce identical outputs across repeated runs with the same schema, data, and options.

Structs

ByteDiff

Details about a byte difference found during determinism checking.

DeterminismResult

Result of a determinism check operation.

Enums

DeterminismMode

Mode of determinism checking (decode-only, encode-only, or full round-trip).

Constants

BLAKE3_HEX_LEN

Hex-encoded BLAKE3 digest length in characters.

DEFAULT_MAX_DIFFS

Default cap used when collecting byte-level differences.

Functions

blake3_hex

Compute a lowercase hex BLAKE3 hash for a byte slice.

check_decode_determinism

Check that decoding the same binary data twice produces identical JSON output.

check_encode_determinism

Check that encoding the same JSON twice produces identical binary output.

check_round_trip_determinism

Check full round-trip determinism: decode->encode->decode.

compare_outputs

Compare two byte slices and build a determinism result with the default diff limit.

compare_outputs_with_limit

Compare two byte slices and build a determinism result with an explicit diff limit.

find_byte_differences

Find byte-level differences between two slices using DEFAULT_MAX_DIFFS entries at most.

find_byte_differences_with_limit

Find byte-level differences between two slices with an explicit limit.