xtask — crate card
Reverse-engineered (from source — verify, don't trust the name)
- One-line pitch: The knut workspace task runner — a
publish = falsecargo-xtask crate that is the home of the nornir benchmark suite. - Does:
src/main.rsis a thin stub that just prints a hint; the real content isexamples/nornir-bench.rs(the nornir bench suite), also wired as a[[bench]](benches/nornir.rs,harness = false) socargo bench -p xtaskruns the same suite asnornir bench run, emitting nornir'sBenchRunJSON. Featureskadeadds two benchers:knut.skade_iceberg_export(graph→Iceberg / fast_append) andknut.delta_ingest(Iceberg→FalkorDB delta-vs-full ingest). - Key deps:
anyhow; dev-depsnornir(bench harness),graphar,graphar-falkordb,knut-bifrost,arrow-array/arrow-schema,serde_json,tokio,async-trait,tempfile; feature-gated optionalgraphar-flight+skadefor the Iceberg benchers. - Shape: bin (+ bench + example); small.
src/main.rs(stub),benches/nornir.rs,examples/nornir-bench.rs. - Observed role in the workspace: The benchmarking/task entry point across the whole workspace; exercises graphar, graphar-falkordb, knut-bifrost and (with
skade) graphar-flight, feeding nornir's bench tooling.
Fill in (one line each — only the human knows these)
- Primary consumer(s):
- Why it exists (vs the obvious alternative):
- Hard constraint (airgap / no-C-deps / no-FFI / pure-Rust / etc.):
- Release cadence & independence (rides a parent? own repo someday?):
- Status (production / prototype / experimental / stubbed):
- Must-NOT-change invariant:
- Biggest known gap or TODO:
- Anything a newcomer would get wrong about it: