Expand description
Versioned Pack Archive encoding, decoding, read, and write.
Re-exports§
pub use crate::CommitCertainty;
Structs§
- File
Write Error - Evidence and the concrete cause from failed atomic filesystem write.
- File
Write Receipt - Evidence from successful atomic filesystem write.
- Stream
Write Error - Evidence and the concrete cause from failed exact stream write.
- Stream
Write Receipt - Evidence from successful exact stream write.
Enums§
- Archive
Error - A malformed, unsafe, ambiguous, or unsupported raw Pack Archive.
- Decode
Error - A failure in one phase of Pack Archive Decoding.
- Encode
Error - A failure in one phase of Pack Archive Encoding.
- File
Read Error - A failure while reading exact Pack Archive bytes from a file.
- File
Read Phase - The filesystem phase in which Pack Archive Read failed.
- File
Write Error Cause - The concrete cause of a filesystem write failure.
- File
Write Phase - The filesystem write phase reached by an attempt.
- File
Write Policy - The strict atomic policy requested for filesystem write.
- Manifest
Error - A manifest that could not be accepted.
- Open
Pack Error - A failure in bounded file read followed by Pack Archive Decoding.
- Read
Error - A failure while reading exact Pack Archive bytes from a stream.
- Read
Pack Error - A failure in bounded read followed by Pack Archive Decoding.
- Representation
Error - A valid Pack value that version 1 cannot represent.
- Reserved
Member Role - A reserved version-1 archive role that font data cannot occupy.
- Save
Pack Error - A failure in Pack Archive Encoding followed by atomic file write.
- Staging
Residue Status - The observed state of same-directory staging when an attempt returns.
- Stream
Write Phase - The stream write phase reached by an attempt.
- Write
Pack Error - A failure in Pack Archive Encoding followed by stream write.
Constants§
- FORMAT_
VERSION - The pack format version this crate reads and writes.
- MANIFEST_
PATH - The archive entry name of the manifest.
Functions§
- decode
- Decodes one borrowed exact Pack Archive into an authoritative
Pack. - encode
- Encodes one borrowed validated
Packinto uniquely owned exact archive bytes. - encode_
with_ limits - Encodes one borrowed validated
Packunder explicit resource ceilings. - open_
pack - Reads and decodes one Pack file while preserving exact bytes on decode failure.
- read
- Reads exact bytes from a stream under a mandatory finite ceiling.
- read_
file - Reads exact bytes from one file using known-size preflight and metered reads.
- read_
pack - Reads and decodes one Pack while preserving exact bytes on decode failure.
- save_
pack - Encodes and atomically writes one Pack while preserving bytes on failure.
- save_
pack_ with_ limits - Encodes under explicit resource ceilings and atomically writes one Pack.
- write
- Writes exact Pack Archive bytes to a stream and flushes the writer.
- write_
file - Atomically writes exact Pack Archive bytes from same-directory staging.
- write_
pack - Encodes and writes one Pack while preserving exact bytes on write failure.
- write_
pack_ with_ limits - Encodes under explicit resource ceilings and writes one Pack.
Type Aliases§
- Decode
Limit Error - A Pack Archive exceeded a mandatory decode ceiling.
- Decode
Limits - Mandatory finite resource ceilings for Pack Archive Decoding.
- Decode
Resource - A resource bounded during Pack Archive Decoding.
- Encode
Limit Error - A Pack Archive exceeded a mandatory encode ceiling.
- Encode
Limits - Mandatory finite resource ceilings for Pack Archive Encoding.
- Encode
Resource - A resource bounded during Pack Archive Encoding.
- Read
Limit Error - Pack Archive Read exceeded a mandatory ceiling.
- Read
Limits - Mandatory finite resource ceilings for Pack Archive Read.
- Read
Resource - A resource bounded during Pack Archive Read.