Expand description
nxs — the Nyxis binary format library.
Compiles .nxs source text to .nxb binary files and provides a zero-copy
query reader for those files.
§Quick start
// Compile .nxs source to bytes
let bytes = nxs::compile_source("r0 { id: =1 score: ~9.5 }").unwrap();
// Query the result
use nxs::query::{Reader, eq};
let reader = Reader::new(&bytes).unwrap();
for rec in reader.where_pred(eq("id", 1i64)) {
println!("{:?}", rec.get_f64("score"));
}Re-exports§
pub use arrow_project::VarColumnView;pub use pax_stream::complete_page_end;pub use pax_stream::PaxPageMeta;pub use pax_stream::PaxPageView;pub use pax_stream::PaxStreamReader;pub use pax_stream::PaxStreamWriter;
Modules§
- arrow_
project - Arrow C Data Interface projection helpers for columnar
.nxb. - col_
reduce - Dense columnar
f64reductions with runtime SIMD dispatch (open-core). - column_
prefetch - Columnar layout column warmup (Adaptive-prefetch-spec §7.4).
- compiler
- consts
- Shared format constants for the NXS binary format (.nxb).
- convert
- Converter suite — JSON/CSV/XML ⇄ .nxb.
- decoder
- error
- layout
- Columnar and PAX
.nxblayout writers (OLAP.md v0.1). - lexer
- parser
- pax_
stream - PAX streaming writer and incremental page reader (OLAP.md §4.5).
- prefetch
- Adaptive prefetch — page cache, pattern detector, strategies (spec §4–§8.4).
- query
- Zero-allocation query engine for .nxb files.
- segment_
reader - Multi-segment span reader — queries across a set of sealed .nxb files plus an optional live .nxsw WAL.
- stream_
reader - Incremental reader for streamable
.nxbfiles (TailPtr = 0until seal). - wal
- Span WAL — streaming append layer for NXS span/trace data.
- writer
Functions§
- compile_
source - Compile
.nxssource text to.nxbbytes (lex → parse → compile). - compile_
source_ with_ opts - Compile with layout / page-size options (CLI and
@layoutpragmas).