backbeat_cli/lib.rs
1// Copyright (c) 2026 Cameron Bytheway
2// SPDX-License-Identifier: MIT
3
4//! Library half of the `backbeat` CLI: the schema-driven dump tooling.
5//!
6//! Everything is driven by each dump's embedded schema registry, with no compiled-in knowledge of
7//! the producer's event types. Living in a library (not just the binary) lets integration tests —
8//! and other tools — call these directly.
9//!
10//! * [`model`] — load + decode one or more `.bb` dumps into a common in-memory form.
11//! * [`convert`] — write the decoded records to sparse-wide Parquet.
12//! * [`trace`] — write them to Chrome / Perfetto trace JSON, pairing spans into duration slices.
13//! * [`inspect`] — summarize a dump (envelope, registry, per-shard counts).
14//! * [`merge`] — splice several `.bb` dumps into one multi-instance `.bb`.
15//! * [`views`] — generate DuckDB query DDL from a dump's registry + its registered view sets.
16
17pub mod convert;
18pub mod inspect;
19pub mod merge;
20pub mod model;
21pub mod trace;
22pub mod views;