Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/acheronfail/repgrep
An interactive replacer for ripgrep that makes it easy to find and replace across files on the command line.
https://github.com/acheronfail/repgrep
Last synced: 2 months ago
JSON representation
An interactive replacer for ripgrep that makes it easy to find and replace across files on the command line.
- Host: GitHub
- URL: https://github.com/acheronfail/repgrep
- Owner: acheronfail
- License: apache-2.0
- Created: 2020-06-20T23:58:19.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-20T04:44:47.000Z (9 months ago)
- Last Synced: 2024-10-31T12:15:45.452Z (2 months ago)
- Language: Rust
- Size: 8.1 MB
- Stars: 267
- Watchers: 7
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-rust-tools - repgrep
- awesome-ratatui - repgrep - An interactive replacer for ripgrep that makes it easy to find and replace across files on the command line. (💻 Apps / ⌨️ Development Tools)
README
[](https://crates.io/crates/repgrep)
[](https://docs.rs/repgrep)
[](https://isitmaintained.com/project/acheronfail/repgrep "Average time to resolve an issue")
[](https://isitmaintained.com/project/acheronfail/repgrep "Percentage of issues still open")
# repgrep (rgr)
_An interactive replacer for `ripgrep`._
This is an interactive command line tool to make find and replacement easy.
It uses [`ripgrep`] to find, and then provides you with a simple interface to see
the replacements in real-time and conditionally replace matches.
Some features:
* ⚡ Super fast search results
* ✨ Interactive interface for selecting which matches should be replaced or not
* 🕶️ Live preview of the replacements
* 🧠 Replace using capturing groups (e.g., when using `/foo (\w+)/` replace with `bar $1`)
* 🦀 and more!
Supported file encodings:
* ASCII
* UTF8
* UTF16BE
* UTF16LE
Other encodings are possibly supported but untested at the moment.
See [this issue](https://github.com/acheronfail/repgrep/issues/12) for more information.
## Usage
After installing, just use `rgr` (think: `rg` + `replace`).
The arguments are:
```bash
rgr # See `rgr --help` for more details
```
Here's an example where we ran the command:
```bash
rgr -C5 dreamcast
```
And have entered the replacement `flycast`:
## Installation
First and foremost, make sure you've installed `ripgrep` (AKA: `rg`).
To do so see the [`ripgrep` installation instructions].
#### Precompiled binaries
See the [releases] page for pre-compiled binaries.
#### Via Cargo
**NOTE**: The minimum Rust version required is `1.72.0`.
```bash
cargo install repgrep
```
#### Via Pacman (Arch Linux)
[`repgrep`](https://archlinux.org/packages/extra/x86_64/repgrep/) can be installed
from the official repositories using [Pacman](https://wiki.archlinux.org/title/Pacman).
```bash
pacman -S repgrep
```
#### Via MacPorts (macOS)
`repgrep` can also be installed on macOS using [MacPorts](https://www.macports.org):
```bash
sudo port install repgrep
```
More info [here](https://ports.macports.org/port/repgrep/).
#### From Source
**NOTE**: The minimum Rust version required is `1.72.0`.
```bash
git clone https://github.com/acheronfail/repgrep/
cd repgrep
cargo install --path .
```
[`ripgrep`]: https://github.com/BurntSushi/ripgrep
[releases]: https://github.com/acheronfail/repgrep/releases
[`ripgrep` installation instructions]: https://github.com/BurntSushi/ripgrep/#installation
License: Unlicense OR MIT OR Apache-2.0