Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install runfast

It will make the runfast command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall runfast uninstalls.

Back to the crate overview.

Readme

runfast

What is it?

This is a program intended to be run in a project directory to set up a project run command, and remember it so we dont have to type it multiple times. It should run in a single terminal window, and be lightweight. It should also be easy for end-users to add more commands to the default list. There should also be a custom option, for one-off situations.

Why?

I hate typing things out multiple times, and doing more things that are not the work increases my chance of getting distracted, therefore a single command allows me to think less, do more.

How do I use it?

add the binary to your path, and call runfast in your project directory. It will automatically create a default config at ~/.config/runfast/defaults.toml. You can add your own runners in a similar manner in ~/.config/runfast/runners.toml. When running in a new directory, runfast will get you to choose a runner, and cache what you choose. This means you dont have to select the same one each time. However, you can also call runfast -f to force runfast to re-choose and re-cache the runner for a directory.

Additionally, I have mine firing off a tmux bind, see my dotfiles repo, also hosted on github, for an example.

Can I see it working?

Sure, here is an asciinema demo of it:

I want to contribute, how should I do that?

firstly, thanks. secondly, please fork this repo, make your changes, and PR the main branch. When the PR is made, request me as a reviewer, and I'll get around to it at some point. I cant give a timescale since I currently work full time, so it'll get done when it gets done.