Rust Tool Base
A batteries-included CLI application framework for Rust.
Idiomatic, typed, and security-minded.
⚙️ Core Architecture Features¶
🦀 Idiomatic Rust
Embraces standard Rust paradigms from top to bottom. Arc<T> over context-threading, thiserror + miette over stringy errors, and typestate builders over functional options.
📦 Best-in-Class Crates
We don't reinvent the wheel. RTB orchestrates the best crates in the ecosystem: clap, figment, miette, rust-embed, and more into a cohesive framework.
🛡️ Security Minded
Built with enterprise security in mind. Secure credential storage, automatic secret redaction from telemetry, and rigorous validation perimeters built-in.
📚 Documentation Reference¶
Getting Started
- Why RTB? — philosophy, scope, and paradigm mapping.
- Ecosystem Survey — the best-in-class crates RTB wraps.
- Quick Start Guide — how to wire up the minimal application scaffold.
Learn & Look Up
- Build your first tool — scaffold, extend and run a CLI end to end.
- How-to guides — task-focused recipes.
- Reference — every command, flag, feature and config key.
- What RTB does not do — the gaps, stated plainly.
- Explanation — concepts and per-crate background.
Process & Architecture
- Engineering Standards — standing rules for security & idiom.
- BDD pattern — wiring
cucumber-rsinto cargo test. - Specifications — authoritative architectural contracts.
Further reading¶
The blog carries a curated route through this subject: Rust, and what survived the port collects everything written about it, ordered so you can start at the beginning rather than newest-first.
Ask phpbotscout
He answers questions about the projects over on the Discord, citing the docs where they already cover it, and offering to raise an issue where they don't. Bring a bug, an idea, or a questionable engineering decision.