Expand description
Stable file-format, reader, and in-memory build API.
Re-exports§
pub use crate::ingest::assemble_dataset;pub use crate::ingest::assemble_dataset_with;pub use crate::ingest::assemble_dataset_with_opts;pub use crate::ingest::assemble_dataset_with_opts_algo;pub use crate::ingest::assemble_dataset_with_perms;pub use crate::ingest::parse;pub use crate::ingest::parse_quads;pub use crate::ingest::parse_rdfxml;pub use crate::ingest::parse_statements;pub use crate::ingest::parse_statements_audited_surface;pub use crate::ingest::parse_turtle;pub use crate::ingest::parse_turtle_surface;pub use crate::ingest::BuildStats;pub use crate::ingest::DeferredMetadata;pub use crate::ingest::FinalCounts;pub use crate::ingest::IngestError;pub use crate::ingest::IntoMetadata;pub use crate::ingest::QuotedTripleSurface;pub use crate::ingest::RawQuad;pub use crate::ingest::RawTriple;
Structs§
- Build
Info Plan - Everything needed to splice a build-info section into a finished file without holding the file in memory: the rewritten header, where the section goes, and where the bytes that do not move resume.
- Byte
Range - A byte range in the
.retefile image. - Dump
Plan - What a filtered dump will cost, before it runs — see
Rete::dump_plan. - Header
- Decoded file header. All multi-byte fields are little-endian on disk. The
*_offset/*_lenfields are a convenience view over the section directory (populated from it on parse, emitted back to it on serialize). - Layout
Segment - One labelled byte region of a
.retefile image (seeRete::file_layout).kindis a stable machine tag:header,metadata,dictionary,directory,tile,pyramid,named-graphs. - Rete
- A read-only, in-memory view over a
.retefile image. - Scan
Plan - What a routed scan of one pattern will touch, from the tile directories
alone — see [
GraphIndex::scan_plan]. - Section
- One parsed/encoded section-directory entry: a typed
(offset, length)into the file, plus 16 bits of per-section flags (reserved). - Triple
Provenance - Why a triple-pattern result is present in the file.
Enums§
- File
Error - Header
Error - Section
Kind - A top-level file section, addressed by
SectionKindin the header directory.
Constants§
- CODEC_
NONE - No compression.
- CODEC_
ZSTD - zstd compression (per section).
- CURRENT_
FORMAT_ VERSION - Current format generation written by this crate.
- HEADER_
LEN - Fixed header size in bytes.
- MAGIC
- Magic bytes at offset 0: ASCII
RETE. - MIN_
STABLE_ READ_ VERSION - Oldest stable format generation accepted by this reader.
- RDF_
TYPE rdf:type— the predicate that assigns a class to a resource.
Functions§
- attach_
build_ info - Attach (or replace) a build-info section in a finished file image,
returning the new image. Layout and hash semantics:
plan_build_info. - plan_
build_ info - Plan the splice of a build-info section of
info_lenbytes into a file whose firstHEADER_LENbytes areheadand whose total length isfile_len. - read_
build_ info - The build-info section of a whole file image, or
Noneif absent. The payload is an opaque application-layer blob (the CLI stores build-conditions JSON there); it is not covered by the content hash — seeattach_build_info. - replace_
metadata - Replace the metadata section (the Dataset Card blob) of a finished file image, returning the new image. The section is the first one after the header, so every later section’s offset shifts by the length delta.
- verify
- Recompute the content hash from a file image and check it against the header — detects corruption or truncation of the payload sections.
Type Aliases§
- Term
Triple - A resolved triple as terms.