A collection of algorithm and data-structure solutions organized by category, each with unit tests living right beside the implementation.

• A stable Rust toolchain (edition 2024 — Rust 1.85 or newer).

# Build
cargo build

# Run all tests
cargo test

# Run the tests for one category or one problem
cargo test arrays::
cargo test two_sum

# Lint and format
cargo clippy --all-targets
cargo fmt

# Run the benchmarks (Criterion) for selected algorithms
cargo bench

src/
  lib.rs                 # declares the category modules
  arrays/
    mod.rs               # declares the problem modules (and any shared types)
    two_sum.rs           # one problem per file: implementation + inline tests
    ...
  linked_lists/
    mod.rs               # shared ListNode + builders
    ...
  ...

Conventions:

• One file per problem. Each holds the solution and a #[cfg(test)] mod tests block — the idiomatic Rust home for unit tests, so the tests and the code they exercise never drift apart.
• Shared helper types (linked-list / tree / graph nodes and their builders) live at the top of their category module.
• Entry points are usually named solve, or something more descriptive when a problem has several approaches (e.g. solve_with_min_heap, solve_optimized).