Shared utility library for HyperI Rust applications. Provides configuration management, structured logging, Prometheus metrics, environment detection, transport abstractions, and more.

Rust equivalent of hyperi-pylib (Python) and hyperi-golib (Go).

[dependencies]
hyperi-rustlib = { version = "1.14", registry = "hyperi" }

Default features: config, logger, metrics, env, runtime.

use hyperi_rustlib::{config, logger, env};

fn main() -> anyhow::Result<()> {
    let env = env::Environment::detect();
    logger::setup_default()?;
    config::setup(config::ConfigOptions {
        env_prefix: "MYAPP".into(),
        ..Default::default()
    })?;

    tracing::info!("Running in {env:?}");
    Ok(())
}

This crate dynamically links against system C libraries for several features. Both CI build hosts and deployment targets need the appropriate packages.

Install -dev packages for compilation. hyperi-ci handles this automatically when .hyperi-ci.yaml is present — it detects which -sys crates are in Cargo.lock and installs the matching -dev packages.

All packages except librdkafka-dev are available from Ubuntu's default repositories. For librdkafka-dev >= 2.12.1, add the Confluent APT repo:

curl -fsSL https://packages.confluent.io/clients/deb/archive.key \
  | sudo gpg --dearmor -o /usr/share/keyrings/confluent-clients.gpg
echo "deb [signed-by=/usr/share/keyrings/confluent-clients.gpg] \
  https://packages.confluent.io/clients/deb noble main" \
  | sudo tee /etc/apt/sources.list.d/confluent-clients.list
sudo apt-get update
sudo apt-get install -y librdkafka-dev libssl-dev libsasl2-dev pkg-config

The compiled binary links against .so files at runtime. Install the runtime packages (not -dev) on deployment hosts or in Docker images.

Only install what you use. Downstream binaries (dfe-loader, dfe-receiver, etc.) only link against libraries for the features they enable. Check each project's Cargo.toml features to determine which runtime packages are needed.

# Build stage
FROM rust:1.94 AS builder
RUN apt-get update && apt-get install -y \
    pkg-config libssl-dev librdkafka-dev libgit2-dev libzstd-dev
COPY . .
RUN cargo build --release

# Runtime stage
FROM ubuntu:24.04
RUN apt-get update && apt-get install -y --no-install-recommends \
    librdkafka1 libssl3 libgit2-1.7 libzstd1 ca-certificates \
    && rm -rf /var/lib/apt/lists/*
COPY --from=builder /app/target/release/myapp /usr/local/bin/

For librdkafka1, add the Confluent APT repo to both build and runtime stages.

See docs/DESIGN.md for full architecture documentation.

See docs/CONFIG-CASCADE.md for the 8-layer configuration cascade reference.

Published to hyperi registry (JFrog Artifactory at hypersec.jfrog.io).

# .cargo/config.toml
[registries.hyperi]
index = "sparse+https://hypersec.jfrog.io/artifactory/git/hyperi-cargo-virtual.git"

FSL-1.1-ALv2 — Copyright (c) 2026 HYPERI PTY LIMITED