Rust Best Practices

Based on Microsoft Pragmatic Rust Guidelines and Rust community standards.

Core Principles

1. Leverage the type system — Use types to make invalid states unrepresentable
2. Embrace ownership — Work with the borrow checker, not against it
3. Explicit over implicit — Be clear about fallibility, mutability, and lifetimes
4. Zero-cost abstractions — Use iterators, generics, and traits without runtime cost
5. Fail fast, recover gracefully — Validate early, handle errors explicitly

Error Handling

Use thiserror for Libraries

use thiserror::Error;