Skip to main content

Crate nxs

Crate nxs 

Source
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 f64 reductions 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 .nxb layout 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 .nxb files (TailPtr = 0 until seal).
wal
Span WAL — streaming append layer for NXS span/trace data.
writer

Functions§

compile_source
Compile .nxs source text to .nxb bytes (lex → parse → compile).
compile_source_with_opts
Compile with layout / page-size options (CLI and @layout pragmas).