rust-coding

Idiomatic Rust uses enums for state machines instead of boolean flags, returns Result instead of panicking, places impl blocks directly below their types, and leverages trait implementations like Display, From, and TryFrom. Run cargo fmt and cargo clippy to enforce consistency.

Speed up Rust builds by using the mold linker on Linux, caching artifacts with sccache, running cargo check instead of cargo build during iteration, minimizing dependencies, and splitting code into lightweight workspace crates.

Use an enum when a value can be one of several variants, such as states in a state machine, and a struct when modeling a single entity with multiple fields. Enums make invalid states unrepresentable, while newtypes wrap primitives to encode invariants.

Rust functions should return Result<T, E> for recoverable errors so callers can handle failures explicitly. Panics are reserved for unrecoverable bugs or violated invariants, keeping APIs predictable and ergonomic.

Use Arc<T> when multiple threads need shared read access to the same data, and message-passing channels when ownership should transfer between threads. The choice depends on whether you need shared state or isolated ownership with communication.