Getting Started

Install

Most callers only need runi-core — it bundles every other workspace sub-crate behind feature flags, all enabled by default. Cargo's package = "..." alias lets you reach everything through the clean runi:: namespace:

# Cargo.toml
[dependencies]
runi = { package = "runi-core", version = "0.1" }

[dev-dependencies]
runi-test = "0.1"

runi-test stays out of the bundle because it's a development-only helper.

A minimal example

use runi::log::{info, warn};

fn main() {
    runi::log::init();

    info!(app = "demo", "starting up");
    warn!("disk space is low");
}

Run it with:

cargo run
# Control the log level with the RUNI_LOG env var:
RUNI_LOG=debug cargo run

When stderr is a terminal you get Uni-style colored output; when it is piped or redirected the same events are emitted as JSON, so log collectors can parse them directly.

Next steps

• Crates Overview — map of the workspace and how the pieces fit together.
• runi-core — canonical list of bundled features and the foundation types.