Rustlings is an interactive CLI application designed to teach Rust through a series of small, hands-on exercises. It provides a terminal-based learning environment where users edit, compile, test, and run Rust code snippets, progressing through topics from basic variables to async programming. The system is built as a single binary that embeds all exercise files and solutions at compile time using a custom proc macro, eliminating external file dependencies. The CLI offers multiple modes: a watch mode that automatically re-checks exercises on file changes, a list mode for browsing and selecting exercises, and commands for running, hinting, resetting, and checking all exercises. State persistence tracks user progress in a local file. The architecture is modular, with clear separation between exercise execution logic, terminal UI, state management, and developer tooling. External dependencies include clap for argument parsing, crossterm for terminal control, notify for file watching, and serde for serialization. The project is actively maintained by the Rust community and serves as the official companion to 'The Rust Programming Language' book.
This repository is a comprehensive Chinese-language Rust tutorial titled 'Rust Course' (Rust 语言圣经). It is primarily an educational documentation project built with mdBook, producing a static website and a PDF. The content covers Rust from basic syntax to advanced topics like async, unsafe, concurrency, and performance optimization, with over 170 chapters and 1.1 million characters. It also includes a forked and translated version of the rustlings interactive exercise system (rustlings-zh), which provides a CLI tool for hands-on practice. The repository is not a production application but a learning resource; however, the rustlings-zh component is a functional CLI application. The architecture is a static site generator (mdBook) plus a standalone Rust CLI tool. Key entry points are the mdBook configuration (book.toml) and the rustlings-zh main.rs. The project is well-maintained, tracks Rust versions up to 1.89, and has active community contributions.