frep-0.1.3 is not a library.

frep

frep is a fast find-and-replace tool. To replace the string "before" with the string "after" in the current directory:

frep before after

There are a number of command-line flags to change the behaviour of frep, such as:

--fixed-strings (-f) to search without regex
--advanced-regex (-a) to use advanced regex features such as negative lookahead (not enabled by default for improved performance)
--include-files (-I) and --exclude-files (-E) to include or exclude files and directories using glob matching. For instance, -I "*.rs, *.py" matches all files with the .rs or .py extensions, and -E "env/**" excludes all files in the env directory

Run frep --help to see the full list of flags.

Performance

frep is fast. Below is a benchmark for comparison, performing a find and replace across the entire Linux kernel repo, finding and replacing the string "before" with "after":

Command	Mean [s]	Min [s]	Max [s]	Relative
`frep`	4.402 ± 0.032	4.363	4.446	1.00 ± 0.03
`ripgrep + sd`	4.916 ± 0.130	4.792	5.122	1.12 ± 0.04
`fastmod`	4.398 ± 0.109	4.219	4.493	1.00
`fd + sd`	10.011 ± 0.000	10.010	10.011	2.28 ± 0.06

Installation

Homebrew

On macOS and Linux, you can install frep using Homebrew:

brew install thomasschafer/tap/frep

Prebuilt binaries

Download the appropriate binary for your system from the releases page:

Platform	Architecture	Download file
Linux	Intel/AMD	`*-x86_64-unknown-linux-musl.tar.gz`
Linux	ARM64	`*-aarch64-unknown-linux-musl.tar.gz`
macOS	Apple Silicon	`*-aarch64-apple-darwin.tar.gz`
macOS	Intel	`*-x86_64-apple-darwin.tar.gz`
Windows	x64	`*-x86_64-pc-windows-msvc.zip`

After downloading, extract the binary and move it to a directory in your PATH.

Cargo

Ensure you have cargo installed (see here), then run:

cargo install frep

Building from source

Ensure you have cargo installed (see here), then run the following commands:

git clone git@github.com:thomasschafer/frep.git
cd frep
cargo install --path frep --locked