superwhich

superwhich is a cross-platform CLI tool and library that was initially meant to be a faster drop-in replacement for Windows' where command but since it uses Jaro-Winkler distance to calculate the similarity between the strings it can be called a sort of "smart" which, it can handle some typos and highlights the section of the executables that matches the search pattern.

Installation

CLI

• From crates.io: cargo install superwhich
• From GitHub: cargo install --git https://github.com/DarkCeptor44/superwhich
• Manually (after cloning the repo locally): cargo install --path .
• From releases.

Library

cargo add superwhich

Or you can add this to your Cargo.toml file:

[dependencies]
superwhich = "^2"

Usage

$ swhich -h
Cross-platform smart which alternative

Usage: swhich.exe [OPTIONS] <PATTERN>

Arguments:
  <PATTERN>  The search pattern

Options:
  -c, --color <COLOR>          Color of the highlighted text (off or set `NO_COLOR` env var to disable) [default: blue]
  -T, --threshold <THRESHOLD>  String similarity threshold (0.0 to 1.0) [default: 0.7]
  -t, --print-time             Print time elapsed
  -h, --help                   Print help
  -V, --version                Print version

Todo

• Make it faster (currently at ~221ms on Windows).
• Find a better way to match the pattern to the name when printing the result so it highlights similar strings as well.

Tests

You can run the tests with cargo test.

Benchmarks

Library

The library benchmarks can be ran with cargo bench.

CLI

The CLI was benchmarked using Hyperfine.

Windows

• AMD64, 32GB RAM, Ryzen 7 3800X, Windows 10.

Linux

• ARM64, 1GB RAM, Orange Pi Zero2, Debian 12.

License

This project is licensed under the terms of the GNU General Public License v3.0.