cargo-rx is a simple fuzzy finder and Runner for Examples in a Cargo project.
This crate provides a single executable: rx.
Basically anywhere you would use cargo run --example in a
Rust project, try rx instead.
If this project has helped you, please consider making a donation.
Ensure that you have a fairly recent version of rust/cargo installed. Then, run:
$ cargo install cargo-rxCompiler support: requires rustc 1.58+
Check out the Releases page for pre-built binaries compatible with various architectures.
Note that on a Windows environment, you will also need to have fzf installed and available in your $PATH variable.
An easy way to install fzf is via Chocolatey:
choco install fzfThere is currently a feature request open on skim which proposes adding
support for Windows, but this has not been currently implemented yet --
thus, the fzf tool serves as a stand-in alternative for now.
- Fuzzy finder, which leverages skim to sort and search for examples in a Cargo project -- when called with just
rx. - Pass arguments after
--to the selected example. - Automatically enables required-features when running an example.
- Support for nested crates with binary targets.
- Play back of most recently run example via the
--replayoption. - Automatically enables
+nightlytoolchain when passed in unstable options tocargo run, such as--unit-graph.
Contributions are welcome! Open a pull request to fix a bug, or open an issue to discuss a new feature or change.
Check out the Contributing section in the docs for more info.
Liked some of my work? Buy me a coffee (or more likely a beer)
This project is proudly licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT).
cargo-rx can be distributed according to the MIT license. Contributions
will be accepted under the same license.
cargo-rxis brought to you by Ritvik Nag.