cargo-rx 0.1.0

A simple, modern example runner that extends Cargo to allow you to easily run examples from the command line. It comes with the `rx` command.
Documentation

cargo-rx

cargo-rx is a simple, modern Runner for Examples in a Cargo project.

rx demo

This crate provides a single executable: rx. Basically anywhere you would use cargo run --example in a Rust project, run rx instead.

Installation

Ensure that you have a fairly recent version of rust/cargo installed. Then, run:

$ cargo install cargo-rx

Compiler support: requires rustc 1.58+

(Please check cargo's documentation to learn how cargo install works and how to set up your system so it finds binaries installed by cargo.)

Windows

Note that on a Windows environment, you will also need to have fzf (https://github.com/junegunn/fzf) installed, as the rx command will use the fzf executable as a fuzzy finder instead.

There 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.

Features

  • Fuzzy finder 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.
  • Play back of most recently run example via --replay.

Contributing

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.

License

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.

Authors