| Repos | \nBurntSushi/ripgrep | \n
|---|---|
| Views | \n![\"views\"](\"https://views.whatilearened.today/views/github/BurntSushi/ripgrep.svg\") | \n
| Stars | \n![\"stars\"](\"https://img.shields.io/github/stars/BurntSushi/ripgrep?color=f2f08d&logo=Undertale&logoColor=eb4630\") | \n
| Forks | \n![\"forks\"](\"https://img.shields.io/github/forks/BurntSushi/ripgrep?color=ba86eb&logo=Handshake&logoColor=ea6aa6\") | \n
| License | \n![\"license\"](\"https://img.shields.io/github/license/BurntSushi/ripgrep?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAACXBIWXMAAAsTAAALEwEAmpwYAAAD3klEQVR4nO3YSUzUUBgH8JroWVrUGJfEm7sXNcSDFxMTL2pi4sHEgxeNRowXgpEWBDURR%2BNANOKOK66ooKJGBXeEGRcWAcEVFGQRHFwQmH5%2F0wHaeWHI9DUDU5L5knehdOb7zfe%2B19cnCJGIRCQiEYlQB7YJIyGL8aosulVZ6iRFQjiGKkudWg5aLlpOppNXnfPqw5U0DYRJmVxjCgFF3BLuZGmAoVUiKEArmX7D7USgsQporgGa3gHfK4H6cuBbCVD3Gqh1A5%2BLgE%2BFwIenQM0joDofqLoHVNwBym8CpTnAm2zQq0sgdxbIdQZUlAkqPAZ6dgj05ADoYRoofy%2FoXiro7k5QXjLopgzKiQNlLDaqoIguEwBjzqP5PfDjE9DyIXyI63FMTwQFMCVrqwNav4QfoRg58QF%2BfrMHQrEK8DToCMqNAyWNHfxmTRoLOrmSRVgGtDfqCEqZOHQrzo4pbCUsA3416Qi6EQ9KGjcEFRgHOrOKnU6WAb9bGETYekKxCvjTag9E4pje54Dk5QP8bbMHYv%2FC3ueAeJkP0OGxB%2BJpBnArYR8EYQQnoN1ANFaBnPP5l8SrseYQL06Adk0FJY8HOWaBMleAHjh0hPosIzlo8v0A%2F34ZiOeHra0qKRPMVSI7tv%2B92tw%2FvhxUeBRq4VELgM7fBqK5GpRmoQLXNpubTu6zoNRpgT8nPQbq84wd%2FICuvyxiKHqiNAfI3wM6uIhBqGkLiiwAOsKDqOht7Itr9Vy8SjRBEWfyAbr%2FhR1BfpVQFdHJB%2FB2hh7x7j6QpwCVeeYQ2krUB5Clcj6A2m0gWj%2BD0mL49zW5cQyCHLN7rjlmmatEyXX%2FCrTzA%2FoQxZkWl9GJTCVo%2ByTj87%2B4giPKcv0qIHo4AV4D0VZrrQI34pnpRM65xue%2FzAreE4%2FT%2FSoglfEByMsiQtATlL3RAJ5YHrSx6ZDfS70s7uMHhBpR%2FYB5s0PW6oERp1b6%2FfrRhK3SDL5Tie6OQUHQlQ3sVDu%2BzPck9vWE9str%2B6IjS9gHmWPahaDJ%2BwCK6NIBBXsHB9HykXsxwDphlCmAdvplabUJNnZPB94%2FNt6xOe8XzEbP2WhM3WAg1Gub6tH%2B3Q1Pg376R9q4uqlno6gdHGjDOQ90eb01AHM6rYiuUJ1Oq4r4FVuj5vR9BzM9WgNvOywDhiIYQFvgbcfwAfwMvHcaPgBPA%2FDyHGjPbN9A8amebcdwAdD5Nf375txqewNUReoyvwBIXYLdQpWlhwFWqtPaCPD3AsFuASV6qqqIlb0JvkVC1FL9WkLUUlUWK3zXZLFC%2B1%2FBroFto6OsXIuEYJP4DzzW2YFV1oJaAAAAAElFTkSuQmCC\") | \n
| UpdatedAt | \n![\"last-commit\"](\"https://img.shields.io/github/last-commit/BurntSushi/ripgrep?display_timestamp=committer&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=UpdatedAt\") | \n
| CreatedAt | \n![\"create-at\"](\"https://img.shields.io/github/created-at/BurntSushi/ripgrep?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=CreatedAt\") | \n
![](\"https://cdn.jsdelivr.net/gh/eryajf/tu@main/img/image_20240420_214408.gif\")
\n| Repos | \nBurntSushi/ripgrep | \n
|---|---|
| Views | \n | \n
| Stars | \n | \n
| Forks | \n | \n
| License | \n | \n
| UpdatedAt | \n | \n
| CreatedAt | \n | \n
\nripgrep is a line-oriented search tool that recursively searches the current
\ndirectory for a regex pattern. By default, ripgrep will respect gitignore rules
\nand automatically skip hidden files/directories and binary files. (To disable
\nall automatic filtering by default, use rg -uuu.) ripgrep has first class
\nsupport on Windows, macOS and Linux, with binary downloads available for every
\nrelease. ripgrep is similar to
\nother popular search tools like The Silver Searcher, ack and grep.
![\"Build](\"https://github.com/BurntSushi/ripgrep/workflows/ci/badge.svg\"){kind=icon}
\n
\n
Dual-licensed under MIT or the UNLICENSE.
\nPlease see the CHANGELOG for a release history.
\nThis example searches the entire
\nLinux kernel source tree
\n(after running make defconfig && make -j8) for [A-Z]+_SUSPEND, where
\nall matches must be words. Timings were collected on a system with an Intel
\ni9-12900K 5.2 GHz.
Please remember that a single benchmark is never enough! See my
\nblog post on ripgrep
\nfor a very detailed comparison with more benchmarks and analysis.
| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep (Unicode) | \nrg -n -w '[A-Z]+_SUSPEND' | \n536 | \n0.082s (1.00x) | \n
| hypergrep | \nhgrep -n -w '[A-Z]+_SUSPEND' | \n536 | \n0.167s (2.04x) | \n
| git grep | \ngit grep -P -n -w '[A-Z]+_SUSPEND' | \n536 | \n0.273s (3.34x) | \n
| The Silver Searcher | \nag -w '[A-Z]+_SUSPEND' | \n534 | \n0.443s (5.43x) | \n
| ugrep | \nugrep -r --ignore-files --no-hidden -I -w '[A-Z]+_SUSPEND' | \n536 | \n0.639s (7.82x) | \n
| git grep | \nLC_ALL=C git grep -E -n -w '[A-Z]+_SUSPEND' | \n536 | \n0.727s (8.91x) | \n
| git grep (Unicode) | \nLC_ALL=en_US.UTF-8 git grep -E -n -w '[A-Z]+_SUSPEND' | \n536 | \n2.670s (32.70x) | \n
| ack | \nack -w '[A-Z]+_SUSPEND' | \n2677 | \n2.935s (35.94x) | \n
Here's another benchmark on the same corpus as above that disregards gitignore
\nfiles and searches with a whitelist instead. The corpus is the same as in the
\nprevious benchmark, and the flags passed to each command ensure that they are
\ndoing equivalent work:
| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep | \nrg -uuu -tc -n -w '[A-Z]+_SUSPEND' | \n447 | \n0.063s (1.00x) | \n
| ugrep | \nugrep -r -n --include='*.c' --include='*.h' -w '[A-Z]+_SUSPEND' | \n447 | \n0.607s (9.62x) | \n
| GNU grep | \ngrep -E -r -n --include='*.c' --include='*.h' -w '[A-Z]+_SUSPEND' | \n447 | \n0.674s (10.69x) | \n
Now we'll move to searching on single large file. Here is a straight-up
\ncomparison between ripgrep, ugrep and GNU grep on a file cached in memory
\n(~13GB, OpenSubtitles.raw.en.gz, decompressed):
| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep (Unicode) | \nrg -w 'Sherlock [A-Z]\\w+' | \n7882 | \n1.042s (1.00x) | \n
| ugrep | \nugrep -w 'Sherlock [A-Z]\\w+' | \n7882 | \n1.339s (1.28x) | \n
| GNU grep (Unicode) | \nLC_ALL=en_US.UTF-8 egrep -w 'Sherlock [A-Z]\\w+' | \n7882 | \n6.577s (6.31x) | \n
In the above benchmark, passing the -n flag (for showing line numbers)
\nincreases the times to 1.664s for ripgrep and 9.484s for GNU grep. ugrep
\ntimes are unaffected by the presence or absence of -n.
Beware of performance cliffs though:
\n| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep (Unicode) | \nrg -w '[A-Z]\\w+ Sherlock [A-Z]\\w+' | \n485 | \n1.053s (1.00x) | \n
| GNU grep (Unicode) | \nLC_ALL=en_US.UTF-8 grep -E -w '[A-Z]\\w+ Sherlock [A-Z]\\w+' | \n485 | \n6.234s (5.92x) | \n
| ugrep | \nugrep -w '[A-Z]\\w+ Sherlock [A-Z]\\w+' | \n485 | \n28.973s (27.51x) | \n
And performance can drop precipitously across the board when searching big
\nfiles for patterns without any opportunities for literal optimizations:
| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep | \nrg '[A-Za-z]{30}' | \n6749 | \n15.569s (1.00x) | \n
| ugrep | \nugrep -E '[A-Za-z]{30}' | \n6749 | \n21.857s (1.40x) | \n
| GNU grep | \nLC_ALL=C grep -E '[A-Za-z]{30}' | \n6749 | \n32.409s (2.08x) | \n
| GNU grep (Unicode) | \nLC_ALL=en_US.UTF-8 grep -E '[A-Za-z]{30}' | \n6795 | \n8m30s (32.74x) | \n
Finally, high match counts also tend to both tank performance and smooth
\nout the differences between tools (because performance is dominated by how
\nquickly one can handle a match and not the algorithm used to detect the match,
\ngenerally speaking):
| Tool | \nCommand | \nLine count | \nTime | \n
|---|---|---|---|
| ripgrep | \nrg the | \n83499915 | \n6.948s (1.00x) | \n
| ugrep | \nugrep the | \n83499915 | \n11.721s (1.69x) | \n
| GNU grep | \nLC_ALL=C grep the | \n83499915 | \n15.217s (2.19x) | \n
![\"Crates.io\"](\"https://img.shields.io/crates/v/ripgrep.svg\")
![\"Packaging](\"https://repology.org/badge/tiny-repos/ripgrep.svg\"){kind=icon}
![\"A](\"https://burntsushi.net/stuff/ripgrep1.png\")
.gitignore/.ignore/.rgignore files, it won't searchrg -uuu.rg -tpy foo limits your search to Python files and rg -Tjs foo excludes JavaScript files from your search. ripgrep can be taught aboutgrep, such as showing the context-P/--pcre2 (use PCRE2--auto-hybrid-regex (use PCRE2 only if needed). An alternative--engine (default|pcre2|auto) option.-E/--encoding flag.)-z/--search-zip flag.In other words, use ripgrep if you like speed, filtering by default, fewer
\nbugs and Unicode support.
Despite initially not wanting to add every feature under the sun to ripgrep,
\nover time, ripgrep has grown support for most features found in other file
\nsearching tools. This includes searching for results spanning across multiple
\nlines, and opt-in support for PCRE2, which provides look-around and
\nbackreference support.
At this point, the primary reasons not to use ripgrep probably consist of one
\nor more of the following:
Generally, yes. A large number of benchmarks with detailed analysis for each is
\navailable on my blog.
Summarizing, ripgrep is fast because:
\n-P/--pcre2 flag.).gitignore files using aRegexSet.crossbeam andignore.Andy Lester, author of ack, has published an
\nexcellent table comparing the features of ack, ag, git-grep, GNU grep and
\nripgrep: https://beyondgrep.com/feature-comparison/
Note that ripgrep has grown a few significant new features recently that
\nare not yet present in Andy's table. This includes, but is not limited to,
\nconfiguration files, passthru, support for searching compressed files,
\nmultiline search and opt-in fancy regex support via PCRE2.
If you'd like to try ripgrep before installing, there's an unofficial
\nplayground and an interactive
\ntutorial.
If you have any questions about these, please open an issue in the tutorial
\nrepo.
The binary name for ripgrep is rg.
Archives of precompiled binaries for ripgrep are available for Windows,
\nmacOS and Linux. Linux and
\nWindows binaries are static executables. Users of platforms not explicitly
\nmentioned below are advised to download one of these archives.
If you're a macOS Homebrew or a Linuxbrew user, then you can install
\nripgrep from homebrew-core:
$ brew install ripgrep\nIf you're a MacPorts user, then you can install ripgrep from the
\nofficial ports:
$ sudo port install ripgrep\nIf you're a Windows Chocolatey user, then you can install ripgrep from the
\nofficial repo:
$ choco install ripgrep\nIf you're a Windows Scoop user, then you can install ripgrep from the
\nofficial bucket:
$ scoop install ripgrep\nIf you're a Windows Winget user, then you can install ripgrep from the
\nwinget-pkgs
\nrepository:
$ winget install BurntSushi.ripgrep.MSVC\nIf you're an Arch Linux user, then you can install ripgrep from the official repos:
\n$ sudo pacman -S ripgrep\nIf you're a Gentoo user, you can install ripgrep from the
\nofficial repo:
$ sudo emerge sys-apps/ripgrep\nIf you're a Fedora user, you can install ripgrep from official
\nrepositories.
$ sudo dnf install ripgrep\nIf you're an openSUSE user, ripgrep is included in openSUSE Tumbleweed
\nand openSUSE Leap since 15.1.
$ sudo zypper install ripgrep\nIf you're a RHEL/CentOS 7/8 user, you can install ripgrep from
\ncopr:
$ sudo yum install -y yum-utils\n$ sudo yum-config-manager --add-repo=https://copr.fedorainfracloud.org/coprs/carlwgeorge/ripgrep/repo/epel-7/carlwgeorge-ripgrep-epel-7.repo\n$ sudo yum install ripgrep\nIf you're a Nix user, you can install ripgrep from
\nnixpkgs:
$ nix-env --install ripgrep\nIf you're a Flox user, you can install ripgrep as follows:
\n$ flox install ripgrep\nIf you're a Guix user, you can install ripgrep from the official
\npackage collection:
$ guix install ripgrep\nIf you're a Debian user (or a user of a Debian derivative like Ubuntu),
\nthen ripgrep can be installed using a binary .deb file provided in each
\nripgrep release.
$ curl -LO https://github.com/BurntSushi/ripgrep/releases/download/14.1.0/ripgrep_14.1.0-1_amd64.deb\n$ sudo dpkg -i ripgrep_14.1.0-1_amd64.deb\nIf you run Debian stable, ripgrep is officially maintained by
\nDebian, although its version may
\nbe older than the deb package available in the previous step.
$ sudo apt-get install ripgrep\nIf you're an Ubuntu Cosmic (18.10) (or newer) user, ripgrep is
\navailable using the same
\npackaging as Debian:
$ sudo apt-get install ripgrep\n(N.B. Various snaps for ripgrep on Ubuntu are also available, but none of them
\nseem to work right and generate a number of very strange bug reports that I
\ndon't know how to fix and don't have the time to fix. Therefore, it is no
\nlonger a recommended installation option.)
If you're an ALT user, you can install ripgrep from the
\nofficial repo:
$ sudo apt-get install ripgrep\nIf you're a FreeBSD user, then you can install ripgrep from the
\nofficial ports:
$ sudo pkg install ripgrep\nIf you're an OpenBSD user, then you can install ripgrep from the
\nofficial ports:
$ doas pkg_add ripgrep\nIf you're a NetBSD user, then you can install ripgrep from
\npkgsrc:
$ sudo pkgin install ripgrep\nIf you're a Haiku x86_64 user, then you can install ripgrep from the
\nofficial ports:
$ sudo pkgman install ripgrep\nIf you're a Haiku x86_gcc2 user, then you can install ripgrep from the
\nsame port as Haiku x86_64 using the x86 secondary architecture build:
$ sudo pkgman install ripgrep_x86\nIf you're a Void Linux user, then you can install ripgrep from the
\nofficial repository:
$ sudo xbps-install -Syv ripgrep\nIf you're a Rust programmer, ripgrep can be installed with cargo.
strip on the binary.$ cargo install ripgrep\nAlternatively, one can use cargo binstall to install a ripgrep
\nbinary directly from GitHub:
$ cargo binstall ripgrep\nripgrep is written in Rust, so you'll need to grab a
\nRust installation in order to compile it.
\nripgrep compiles with Rust 1.72.0 (stable) or newer. In general, ripgrep tracks
\nthe latest stable release of the Rust compiler.
To build ripgrep:
\n$ git clone https://github.com/BurntSushi/ripgrep\n$ cd ripgrep\n$ cargo build --release\n$ ./target/release/rg --version\n0.1.3\nNOTE: In the past, ripgrep supported a simd-accel Cargo feature when
\nusing a Rust nightly compiler. This only benefited UTF-16 transcoding.
\nSince it required unstable features, this build mode was prone to breakage.
\nBecause of that, support for it has been removed. If you want SIMD
\noptimizations for UTF-16 transcoding, then you'll have to petition the
\nencoding_rs project to use stable
\nAPIs.
Finally, optional PCRE2 support can be built with ripgrep by enabling the
\npcre2 feature:
$ cargo build --release --features 'pcre2'\nEnabling the PCRE2 feature works with a stable Rust compiler and will
\nattempt to automatically find and link with your system's PCRE2 library via
\npkg-config. If one doesn't exist, then ripgrep will build PCRE2 from source
\nusing your system's C compiler and then statically link it into the final
\nexecutable. Static linking can be forced even when there is an available PCRE2
\nsystem library by either building ripgrep with the MUSL target or by setting
\nPCRE2_SYS_STATIC=1.
ripgrep can be built with the MUSL target on Linux by first installing the MUSL
\nlibrary on your system (consult your friendly neighborhood package manager).
\nThen you just need to add MUSL support to your Rust toolchain and rebuild
\nripgrep, which yields a fully static executable:
$ rustup target add x86_64-unknown-linux-musl\n$ cargo build --release --target x86_64-unknown-linux-musl\nApplying the --features flag from above works as expected. If you want to
\nbuild a static executable with MUSL and with PCRE2, then you will need to have
\nmusl-gcc installed, which might be in a separate package from the actual
\nMUSL library, depending on your Linux distribution.
ripgrep is relatively well-tested, including both unit tests and integration
\ntests. To run the full test suite, use:
$ cargo test --all\nfrom the repository root.
\nrg --json output format. So all you need to do torg --json pattern | delta. See delta's manual section onFor reporting a security vulnerability, please
\ncontact Andrew Gallant.
\nThe contact page has my email address and PGP public key if you wish to send an
\nencrypted message.
The following is a list of known translations of ripgrep's documentation. These
\nare unofficially maintained and may not be up to date.