Skip to content

MARKDOWN SOURCE

Raw
# Project instructions: grust

Build a standalone Rust grep clone for streaming regular-expression file search with colored output. Support useful grep-style flags, stdin, recursive paths, and clear errors; do not read whole files into memory.

## Rules for this project

- This project is independent: keep all source, tests, assets, and configuration inside `projects/grust`. Do not import or copy code from another showcase.
- Use Rust `1.98.1`, pinned in this directory's `mise.toml`.
- Manage toolchains and external build tools with `mise.toml`. Pin every Rust crate to an exact version (`=x.y.z`) in `Cargo.toml`, commit `Cargo.lock`, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
- Provide `mise run install` and `mise run run` tasks. Add a check task and run Clippy with `all` and `pedantic` enabled; fix warnings rather than suppressing them broadly.
- Do not assume globally installed helper binaries. Implement required behavior in Rust or use pinned libraries/tools; never shell out to another grep implementation.
- Include tests and a README with usage examples. Keep the implementation small, robust, and idiomatic.

Project instructions: grust

Build a standalone Rust grep clone for streaming regular-expression file search with colored output. Support useful grep-style flags, stdin, recursive paths, and clear errors; do not read whole files into memory.

Rules for this project

  • This project is independent: keep all source, tests, assets, and configuration inside projects/grust. Do not import or copy code from another showcase.
  • Use Rust 1.98.1, pinned in this directory's mise.toml.
  • Manage toolchains and external build tools with mise.toml. Pin every Rust crate to an exact version (=x.y.z) in Cargo.toml, commit Cargo.lock, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
  • Provide mise run install and mise run run tasks. Add a check task and run Clippy with all and pedantic enabled; fix warnings rather than suppressing them broadly.
  • Do not assume globally installed helper binaries. Implement required behavior in Rust or use pinned libraries/tools; never shell out to another grep implementation.
  • Include tests and a README with usage examples. Keep the implementation small, robust, and idiomatic.