TODO
Bug fixes:
- BUG #1335: Fixes a performance bug when searching plain text files with very long lines.
ripgrep 11.0.2 is a new patch release that fixes a few bugs, including a
performance regression and a matching bug when using the -F/--fixed-strings
flag.
Feature enhancements:
- FEATURE #1293:
Added
--glob-case-insensitive
flag that makes--glob
behave as--iglob
.
Bug fixes:
- BUG #1246: Add translations to README, starting with an unofficial Chinese translation.
- BUG #1259:
Fix bug where the last byte of a
-f file
was stripped if it wasn't a\n
. - BUG #1261:
Document that no error is reported when searching for
\n
with-P/--pcre2
. - BUG #1284:
Mention
.ignore
and.rgignore
more prominently in the README. - BUG #1292:
Fix bug where
--with-filename
was sometimes enabled incorrectly. - BUG #1268:
Fix major performance regression in GitHub
x86_64-linux
binary release. - BUG #1302: Show better error messages when a non-existent preprocessor command is given.
- BUG #1334:
Fix match regression with
-F
flag when patterns contain meta characters.
ripgrep 11.0.1 is a new patch release that fixes a search regression introduced in the previous 11.0.0 release. In particular, ripgrep can enter an infinite loop for some search patterns when searching invalid UTF-8.
Bug fixes:
- BUG #1247: Fix search bug that can cause ripgrep to enter an infinite loop.
ripgrep 11 is a new major version release of ripgrep that contains many bug fixes, some performance improvements and a few feature enhancements. Notably, ripgrep's user experience for binary file filtering has been improved. See the guide's new section on binary data for more details.
This release also marks a change in ripgrep's versioning. Where as the previous
version was 0.10.0
, this version is 11.0.0
. Moving forward, ripgrep's
major version will be increased a few times per year. ripgrep will continue to
be conservative with respect to backwards compatibility, but may occasionally
introduce breaking changes, which will always be documented in this CHANGELOG.
See issue 1172 for a bit
more detail on why this versioning change was made.
This release increases the minimum supported Rust version from 1.28.0 to 1.34.0.
BREAKING CHANGES:
- ripgrep has tweaked its exit status codes to be more like GNU grep's. Namely,
if a non-fatal error occurs during a search, then ripgrep will now always
emit a
2
exit status code, regardless of whether a match is found or not. Previously, ripgrep would only emit a2
exit status code for a catastrophic error (e.g., regex syntax error). One exception to this is if ripgrep is run with-q/--quiet
. In that case, if an error occurs and a match is found, then ripgrep will exit with a0
exit status code. - Supplying the
-u/--unrestricted
flag three times is now equivalent to supplying--no-ignore --hidden --binary
. Previously,-uuu
was equivalent to--no-ignore --hidden --text
. The difference is that--binary
disables binary file filtering without potentially dumping binary data into your terminal. That is,rg -uuu foo
should now be equivalent togrep -r foo
. - The
avx-accel
feature of ripgrep has been removed since it is no longer necessary. All uses of AVX in ripgrep are now enabled automatically via runtime CPU feature detection. Thesimd-accel
feature does remain available (only for enabling SIMD for transcoding), however, it does increase compilation times substantially at the moment.
Performance improvements:
Feature enhancements:
- Added or improved file type filtering for Apache Thrift, ASP, Bazel, Brotli, BuildStream, bzip2, C, C++, Cython, gzip, Java, Make, Postscript, QML, Tex, XML, xz, zig and zstd.
- FEATURE #855:
Add
--binary
flag for disabling binary file filtering. - FEATURE #1078:
Add
--max-columns-preview
flag for showing a preview of long lines. - FEATURE #1099:
Add support for Brotli and Zstd to the
-z/--search-zip
flag. - FEATURE #1138:
Add
--no-ignore-dot
flag for ignoring.ignore
files. - FEATURE #1155:
Add
--auto-hybrid-regex
flag for automatically falling back to PCRE2. - FEATURE #1159: ripgrep's exit status logic should now match GNU grep. See updated man page.
- FEATURE #1164:
Add
--ignore-file-case-insensitive
for case insensitive ignore globs. - FEATURE #1185:
Add
-I
flag as a short option for the--no-filename
flag. - FEATURE #1207:
Add
none
value to-E/--encoding
to forcefully disable all transcoding. - FEATURE da9d7204:
Add
--pcre2-version
for querying showing PCRE2 version information.
Bug fixes:
- BUG #306, BUG #855: Improve the user experience for ripgrep's binary file filtering.
- BUG #373,
BUG #1098:
**
is now accepted as valid syntax anywhere in a glob. - BUG #916:
ripgrep no longer hangs when searching
/proc
with a zombie process present. - BUG #1052: Fix bug where ripgrep could panic when transcoding UTF-16 files.
- BUG #1055:
Suggest
-U/--multiline
when a pattern contains a\n
. - BUG #1063: Always strip a BOM if it's present, even for UTF-8.
- BUG #1064: Fix inner literal detection that could lead to incorrect matches.
- BUG #1079: Fixes a bug where the order of globs could result in missing a match.
- BUG #1089: Fix another bug where ripgrep could panic when transcoding UTF-16 files.
- BUG #1091: Add note about inverted flags to the man page.
- BUG #1093: Fix handling of literal slashes in gitignore patterns.
- BUG #1095:
Fix corner cases involving the
--crlf
flag. - BUG #1101: Fix AsciiDoc escaping for man page output.
- BUG #1103:
Clarify what
--encoding auto
does. - BUG #1106:
--files-with-matches
and--files-without-match
work with one file. - BUG #1121:
Fix bug that was triggering Windows antimalware when using the
--files
flag. - BUG #1125,
BUG #1159:
ripgrep shouldn't panic for
rg -h | rg
and should emit correct exit status. - BUG #1144: Fixes a bug where line numbers could be wrong on big-endian machines.
- BUG #1154: Windows files with "hidden" attribute are now treated as hidden.
- BUG #1173:
Fix handling of
**
patterns in gitignore files. - BUG #1174:
Fix handling of repeated
**
patterns in gitignore files. - BUG #1176:
Fix bug where
-F
/-x
weren't applied to patterns given via-f
. - BUG #1189: Document cases where ripgrep may use a lot of memory.
- BUG #1203: Fix a matching bug related to the suffix literal optimization.
- BUG 8f14cb18: Increase the default stack size for PCRE2's JIT.
This is a new minor version release of ripgrep that contains some major new features, a huge number of bug fixes, and is the first release based on libripgrep. The entirety of ripgrep's core search and printing code has been rewritten and generalized so that anyone can make use of it.
Major new features include PCRE2 support, multi-line search and a JSON output format.
BREAKING CHANGES:
- The minimum version required to compile Rust has now changed to track the latest stable version of Rust. Patch releases will continue to compile with the same version of Rust as the previous patch release, but new minor versions will use the current stable version of the Rust compile as its minimum supported version.
- The match semantics of
-w/--word-regexp
have changed slightly. They used to be\b(?:<your pattern>)\b
, but now it's(?:^|\W)(?:<your pattern>)(?:$|\W)
. This matches the behavior of GNU grep and is believed to be closer to the intended semantics of the flag. See #389 for more details.
Feature enhancements:
- FEATURE #162:
libripgrep is now a thing. The primary crate is
grep
. - FEATURE #176:
Add
-U/--multiline
flag that permits matching over multiple lines. - FEATURE #188:
Add
-P/--pcre2
flag that gives support for look-around and backreferences. - FEATURE #244:
Add
--json
flag that prints results in a JSON Lines format. - FEATURE #321:
Add
--one-file-system
flag to skip directories on different file systems. - FEATURE #404:
Add
--sort
and--sortr
flag for more sorting. Deprecate--sort-files
. - FEATURE #416:
Add
--crlf
flag to permit$
to work with carriage returns on Windows. - FEATURE #917:
The
--trim
flag strips prefix whitespace from all lines printed. - FEATURE #993:
Add
--null-data
flag, which makes ripgrep use NUL as a line terminator. - FEATURE #997:
The
--passthru
flag now works with the--replace
flag. - FEATURE #1038-1:
Add
--line-buffered
and--block-buffered
for forcing a buffer strategy. - FEATURE #1038-2:
Add
--pre-glob
for filtering files through the--pre
flag.
Bug fixes:
- BUG #2: Searching with non-zero context can now use memory maps if appropriate.
- BUG #200: ripgrep will now stop correctly when its output pipe is closed.
- BUG #389:
The
-w/--word-regexp
flag now works more intuitively. - BUG #643: Detection of readable stdin has improved on Windows.
- BUG #441, BUG #690, BUG #980: Matching empty lines now works correctly in several corner cases.
- BUG #764: Color escape sequences now coalesce, which reduces output size.
- BUG #842: Add man page to binary Debian package.
- BUG #922: ripgrep is now more robust with respect to memory maps failing.
- BUG #937: Color escape sequences are no longer emitted for empty matches.
- BUG #940:
Context from the
--passthru
flag should not impact process exit status. - BUG #984:
Fixes bug in
ignore
crate where first path was always treated as a symlink. - BUG #990: Read stderr asynchronously when running a process.
- BUG #1013:
Add compile time and runtime CPU features to
--version
output. - BUG #1028:
Don't complete bare pattern after
-f
in zsh.
This is a new minor version release of ripgrep that contains some minor new features and a panoply of bug fixes.
Releases provided on Github for x86_64
will now work on all target CPUs, and
will also automatically take advantage of features found on modern CPUs (such
as AVX2) for additional optimizations.
This release increases the minimum supported Rust version from 1.20.0 to 1.23.0.
It is anticipated that the next release of ripgrep (0.10.0) will provide multi-line search support and a JSON output format.
BREAKING CHANGES:
- When
--count
and--only-matching
are provided simultaneously, the behavior of ripgrep is as if the--count-matches
flag was given. That is, the total number of matches is reported, where there may be multiple matches per line. Previously, the behavior of ripgrep was to report the total number of matching lines. (Note that this behavior diverges from the behavior of GNU grep.) - Octal syntax is no longer supported. ripgrep previously accepted expressions
like
\1
as syntax for matchingU+0001
, but ripgrep will now report an error instead. - The
--line-number-width
flag has been removed. Its functionality was not carefully considered with all ripgrep output formats. See #795 for more details.
Feature enhancements:
- Added or improved file type filtering for Android, Bazel, Fuchsia, Haskell, Java and Puppet.
- FEATURE #411:
Add a
--stats
flag, which emits aggregate statistics after search results. - FEATURE #646:
Add a
--no-ignore-messages
flag, which suppresses parse errors from reading.ignore
and.gitignore
files. - FEATURE #702:
Support
\u{..}
Unicode escape sequences. - FEATURE #812:
Add
-b/--byte-offset
flag that shows the byte offset of each matching line. - FEATURE #814:
Add
--count-matches
flag, which is like--count
, but for each match. - FEATURE #880:
Add a
--no-column
flag, which disables column numbers in the output. - FEATURE #898:
Add support for
lz4
when using the-z/--search-zip
flag. - FEATURE #924:
termcolor
has moved to its own repository: https://github.com/BurntSushi/termcolor - FEATURE #934:
Add a new flag,
--no-ignore-global
, that permits disabling global gitignores. - FEATURE #967:
Rename
--maxdepth
to--max-depth
for consistency. Keep--maxdepth
for backwards compatibility. - FEATURE #978:
Add a
--pre
option to filter inputs with an arbitrary program. - FEATURE fca9709d: Improve zsh completion.
Bug fixes:
- BUG #135: Release portable binaries that conditionally use SSSE3, AVX2, etc., at runtime.
- BUG #268: Print descriptive error message when trying to use look-around or backreferences.
- BUG #395:
Show comprehensible error messages for regexes like
\s*{
. - BUG #526: Support backslash escapes in globs.
- BUG #795:
Fix problems with
--line-number-width
by removing it. - BUG #832:
Clarify usage instructions for
-f/--file
flag. - BUG #835: Fix small performance regression while crawling very large directory trees.
- BUG #851:
Fix
-S/--smart-case
detection once and for all. - BUG #852:
Be robust with respect to
ENOMEM
errors returned bymmap
. - BUG #853:
Upgrade
grep
crate toregex-syntax 0.6.0
. - BUG #893: Improve support for git submodules.
- BUG #900: When no patterns are given, ripgrep should never match anything.
- BUG #907:
ripgrep will now stop traversing after the first file when
--quiet --files
is used. - BUG #918:
Don't skip tar archives when
-z/--search-zip
is used. - BUG #934: Don't respect gitignore files when searching outside git repositories.
- BUG #948: Use exit code 2 to indicate error, and use exit code 1 to indicate no matches.
- BUG #951: Add stdin example to ripgrep usage documentation.
- BUG #955: Use buffered writing when not printing to a tty, which fixes a performance regression.
- BUG #957:
Improve the error message shown for
--path separator /
in some Windows shells. - BUG #964:
Add a
--no-fixed-strings
flag to disable-F/--fixed-strings
. - BUG #988:
Fix a bug in the
ignore
crate that prevented the use of explicit ignore files after disabling all other ignore rules. - BUG #995:
Respect
$XDG_CONFIG_DIR/git/config
for detectingcore.excludesFile
.
This is a patch release of ripgrep that primarily fixes regressions introduced in 0.8.0 (#820 and #824) in directory traversal on Windows. These regressions do not impact non-Windows users.
Feature enhancements:
- Added or improved file type filtering for csv and VHDL.
- FEATURE #798:
Add
underline
support totermcolor
and ripgrep. See documentation on the--colors
flag for details.
Bug fixes:
- BUG #684:
Improve documentation for the
--ignore-file
flag. - BUG #789:
Don't show
(rev )
if the revision wasn't available during the build. - BUG #791: Add man page to ARM release.
- BUG #797:
Improve documentation for "intense" setting in
termcolor
. - BUG #800:
Fix a bug in the
ignore
crate for custom ignore files. This had no impact on ripgrep. - BUG #807:
Fix a bug where
rg --hidden .
behaved differently fromrg --hidden ./
. - BUG #815: Clarify a common failure mode in user guide.
- BUG #820: Fixes a bug on Windows where symlinks were followed even if not requested.
- BUG #824: Fix a performance regression in directory traversal on Windows.
This is a new minor version releae of ripgrep that satisfies several popular feature requests (config files, search compressed files, true colors), fixes many bugs and improves the quality of life for ripgrep maintainers. This release also includes greatly improved documentation in the form of a User Guide and a FAQ.
This release increases the minimum supported Rust version from 1.17 to 1.20.
BREAKING CHANGES:
Note that these are all very minor and unlikely to impact most users.
- In order to support configuration files, flag overrides needed to be
rethought. In some cases, this changed ripgrep's behavior. For example,
in ripgrep 0.7.1,
rg foo -s -i
will perform a case sensitive search since the-s/--case-sensitive
flag was defined to always take precedence over the-i/--ignore-case
flag, regardless of position. In ripgrep 0.8.0 however, the override rule for all flags has changed to "the most recent flag wins among competing flags." That is,rg foo -s -i
now performs a case insensitive search. - The
-M/--max-columns
flag was tweaked so that specifying a value of0
now makes ripgrep behave as if the flag was absent. This makes it possible to set a default value in a configuration file and then override it. The previous ripgrep behavior was to suppress all matching non-empty lines. - In all globs,
[^...]
is now equivalent to[!...]
(indicating class negation). Previously,^
had no special significance in a character class. - For downstream packagers, the directory hierarchy in ripgrep's archive
releases has changed. The root directory now only contains the executable,
README and license. There is now a new directory called
doc
which contains the man page (previously in the root), a user guide (new), a FAQ (new) and the CHANGELOG (previously not included in release). Thecomplete
directory remains the same.
Feature enhancements:
- Added or improved file type filtering for Apache Avro, C++, GN, Google Closure Templates, Jupyter notebooks, man pages, Protocol Buffers, Smarty and Web IDL.
- FEATURE #196: Support a configuration file. See the new user guide for details.
- FEATURE #261: Add extended or "true" color support. Works in Windows 10! See the FAQ for details.
- FEATURE #539:
Search gzip, bzip2, lzma or xz files when given
-z/--search-zip
flag. - FEATURE #544:
Add support for line number alignment via a new
--line-number-width
flag. - FEATURE #654: Support linuxbrew in ripgrep's Brew tap.
- FEATURE #673:
Bring back
.rgignore
files. (A higher precedent, application specific version of.ignore
.) - FEATURE #676: Provide ARM binaries. WARNING: This will be provided on a best effort basis.
- FEATURE #709:
Suggest
-F/--fixed-strings
flag on a regex syntax error. - FEATURE #740:
Add a
--passthru
flag that causes ripgrep to print every line it reads. - FEATURE #785: Overhaul documentation. Cleaned up README, added user guide and FAQ.
- FEATURE 7f5c07:
Add hidden flags for convenient overrides (e.g.,
--no-text
).
Bug fixes:
- BUG #553: Permit flags to be repeated.
- BUG #633: Fix a bug where ripgrep would panic on Windows while following symlinks.
- BUG #649:
Fix handling of
!**/
in.gitignore
. - BUG #663:
BREAKING CHANGE: Support
[^...]
glob syntax (as identical to[!...]
). - BUG #693: Don't display context separators when not printing matches.
- BUG #705: Fix a bug that prevented ripgrep from searching OneDrive directories.
- BUG #717:
Improve
--smart-case
uppercase character detection. - BUG #725: Clarify that globs do not override explicitly given paths to search.
- BUG #742:
Write ANSI reset code as
\x1B[0m
instead of\x1B[m
. - BUG #747:
Remove
yarn.lock
from YAML file type. - BUG #760:
ripgrep can now search
/sys/devices/system/cpu/vulnerabilities/*
files. - BUG #761:
Fix handling of gitignore patterns that contain a
/
. - BUG #776:
BREAKING CHANGE:
--max-columns=0
now disables the limit. - BUG #779:
Clarify documentation for
--files-without-match
. - BUG #780, BUG #781: Fix bug where ripgrep missed some matching lines.
Maintenance fixes:
- MAINT #772:
Drop
env_logger
in favor of simpler logger to avoid many new dependencies. - MAINT #772: Add git revision hash to ripgrep's version string.
- MAINT #772: (Seemingly) improve compile times.
- MAINT #776: Automatically generate man page during build.
- MAINT #786:
Remove use of
unsafe
inglobset
. 🎉 - MAINT e9d448: Add an issue template (has already drastically improved bug reports).
- MAINT ae2d03:
Remove the
compile
script.
Friends of ripgrep:
I'd like to extend my gratitude to @balajisivaraman for their recent hard work in a number of areas, and in particular, for implementing the "search compressed files" feature. Their work in sketching out a specification for that and other work has been exemplary.
Thanks @balajisivaraman!
This is a patch release of ripgrep that includes a fix to very bad regression introduced in ripgrep 0.7.0.
Bug fixes:
- BUG #648: Fix a bug where it was very easy to exceed standard file descriptor limits.
This is a new minor version release of ripgrep that includes mostly bug fixes.
ripgrep continues to require Rust 1.17, and there are no known breaking changes introduced in this release.
Feature enhancements:
- Added or improved file type filtering for config & license files, Elm, Purescript, Standard ML, sh, systemd, Terraform
- FEATURE #593:
Using both
-o/--only-matching
and-r/--replace
does the right thing.
Bug fixes:
- BUG #200: ripgrep will stop when its pipe is closed.
- BUG #402:
Fix context printing bug when the
-m/--max-count
flag is used. - BUG #521:
Fix interaction between
-r/--replace
and terminal colors. - BUG #559: Ignore test that tried reading a non-UTF-8 file path on macOS.
- BUG #599: Fix color escapes on empty matches.
- BUG #600: Avoid expensive (on Windows) file handle check when using --files.
- BUG #618: Clarify installation instructions for Ubuntu users.
- BUG #633: Faster symlink loop checking on Windows.
This is a new minor version release of ripgrep that includes many bug fixes
and a few new features such as --iglob
and -x/--line-regexp
.
Note that this release increases the minimum supported Rust version from 1.12 to 1.17.
Feature enhancements:
- Added or improved file type filtering for BitBake, C++, Cabal, cshtml, Julia, Make, msbuild, QMake, Yocto
- FEATURE #163:
Add an
--iglob
flag that is like-g/--glob
, but matches globs case insensitively. - FEATURE #520:
Add
-x/--line-regexp
flag, which requires a match to span an entire line. - FEATURE #551,
FEATURE #554:
ignore
: add newmatched_path_or_any_parents
method.
Bug fixes:
- BUG #342: Fix invisible text in some PowerShell environments by changing the default color scheme on Windows.
- BUG #413:
Release binaries on Unix are now
strip
'd by default. This decreases binary size by an order of magnitude. - BUG #483:
When
--quiet
is passed,--files
should be quiet. - BUG #488:
When
--vimgrep
is passed,--with-filename
should be enabled automatically. - BUG #493:
Fix another bug in the implementation of the
-o/--only-matching
flag. - BUG #499: Permit certain flags to override others.
- BUG #523:
wincolor
: Re-fetch Windows console on all calls. - BUG #523:
--version
now shows enabled compile-time features. - BUG #532, BUG #536, BUG #538, BUG #540, BUG #560, BUG #565: Improve zsh completion.
- BUG #578:
Enable SIMD for
encoding_rs
when appropriate. - BUG #580:
Fix
-w/--word-regexp
in the presence of capturing groups. - BUG #581: Document that ripgrep may terminate unexpectedly when searching via memory maps (which can happen using default settings).
Friends of ripgrep:
I'd like to give a big Thank You to @okdana for their recent hard work on
ripgrep. This includes new features like --line-regexp
, heroic effort on
zsh auto-completion and thinking through some thorny argv issues with me.
I'd also like to thank @ericbn for their work on improving ripgrep's argv parsing by allowing some flags to override others.
Thanks @okdana and @ericbn!
Feature enhancements:
- Added or improved file type filtering for Nix.
- FEATURE #362:
Add
--regex-size-limit
and--dfa-size-limit
flags. - FEATURE #444: Improve error messages for invalid globs.
Bug fixes:
- BUG #442:
Fix line wrapping in
--help
output. - BUG #451:
Fix bug with duplicate output when using
-o/--only-matching
flag.
Feature enhancements:
- Added or improved file type filtering for vim.
- FEATURE #34:
Add a
-o/--only-matching
flag. - FEATURE #377: Column numbers can now be customized with a color. (The default is no color.)
- FEATURE #419:
Added
-0
short flag option for--null
.
Bug fixes:
- BUG #381: Include license text in all subcrates.
- BUG #418,
BUG #426,
BUG #439:
Fix a few bugs with
-h/--help
output.
This is a new minor version release of ripgrep that includes one minor breaking change, bug fixes and several new features including support for text encodings other than UTF-8.
A notable accomplishment with respect to Rust is that ripgrep proper now only
contains a single unsafe
use (for accessing the contents of a memory map).
The breaking change is:
- FEATURE #380: Line numbers are now hidden by default when ripgrep is printing to a tty and the only thing searched is stdin.
Feature enhancements:
- Added or improved file type filtering for Ceylon, CSS, Elixir, HTML, log, SASS, SVG, Twig
- FEATURE #1:
Add support for additional text encodings, including automatic detection for
UTF-16 via BOM sniffing. Explicit text encoding support with the
-E/--encoding
flag was also added for latin-1, GBK, EUC-JP and Shift_JIS, among others. The full list can be found here: https://encoding.spec.whatwg.org/#concept-encoding-get - FEATURE #129:
Add a new
-M/--max-columns
flag that omits lines longer than the given number of bytes. (Disabled by default!) - FEATURE #369:
A new flag,
--max-filesize
, was added for limiting searches to files with a maximum file size.
Bug fixes:
- BUG #52, BUG #311: Tweak how binary files are detected and handled. (We are slightly less conservative and will no longer use memory without bound.)
- BUG #326: When --files flag is given, we should never attempt to parse positional arguments as regexes.
- BUG #327: Permit the --heading flag to override the --no-heading flag.
- BUG #340:
Clarify that the
-u/--unrestricted
flags are aliases. - BUG #343:
Global git ignore config should use
$HOME/.config/git/ignore
and not$HOME/git/ignore
. - BUG #345:
Clarify docs for
-g/--glob
flag. - BUG #381: Add license files to each sub-crate.
- BUG #383: Use latest version of clap (for argv parsing).
- BUG #392:
Fix translation of set globs (e.g.,
{foo,bar,quux}
) to regexes. - BUG #401: Add PowerShell completion file to Windows release.
- BUG #405:
Fix bug when excluding absolute paths with the
-g/--glob
flag.
This is a new minor version release of ripgrep that includes a couple very minor breaking changes, a few new features and lots of bug fixes.
This version of ripgrep upgrades its regex
dependency from 0.1
to 0.2
,
which includes a few minor syntax changes:
- POSIX character classes now require double bracketing. Previously, the regex
[:upper:]
would parse as theupper
POSIX character class. Now it parses as the character class containing the characters:upper:
. The fix to this change is to use[[:upper:]]
instead. Note that variants like[[:upper:][:blank:]]
continue to work. - The character
[
must always be escaped inside a character class. - The characters
&
,-
and~
must be escaped if any one of them are repeated consecutively. For example,[&]
,[\&]
,[\&\&]
,[&-&]
are all equivalent while[&&]
is illegal. (The motivation for this and the prior change is to provide a backwards compatible path for adding character class set notation.)
Feature enhancements:
- Added or improved file type filtering for Crystal, Kotlin, Perl, PowerShell, Ruby, Swig
- FEATURE #83: Type definitions can now include other type definitions.
- FEATURE #243:
BREAKING CHANGE: The
--column
flag now implies--line-number
. - FEATURE #263:
Add a new
--sort-files
flag. - FEATURE #275:
Add a new
--path-separator
flag. Useful in cygwin.
Bug fixes:
- BUG #182: Redux: use more portable ANSI color escape sequences when possible.
- BUG #258: Fix bug that caused ripgrep's parallel iterator to spin and burn CPU.
- BUG #262: Document how to install shell completion files.
- BUG #266, BUG #293: Fix handling of bold styling and change the default colors.
- BUG #268: Make lack of backreference support more explicit.
- BUG #271:
Remove
~
dependency on clap. - BUG #277:
Fix cosmetic issue in
globset
crate docs. - BUG #279:
ripgrep did not terminate when
-q/--quiet
was given. - BUG #281:
BREAKING CHANGE: Completely remove
^C
handling from ripgrep. - BUG #284:
Make docs for
-g/--glob
clearer. - BUG #286: When stdout is redirected to a file, don't search that file.
- BUG #287: Fix ZSH completions.
- BUG #295:
Remove superfluous
memmap
dependency ingrep
crate. - BUG #308:
Improve docs for
-r/--replace
. - BUG #313: Update bytecount dep to latest version.
- BUG #318: Fix invalid UTF-8 output bug in Windows consoles.
Feature enhancements:
- Added or improved file type filtering for Less, Sass, stylus, Zsh
Bug fixes:
- BUG #229: Make smart case slightly less conservative.
- BUG #247: Clarify use of --heading/--no-heading.
- BUG #251, BUG #264, BUG #267: Fix matching bug caused by literal optimizations.
- BUG #256:
Fix bug that caused
rg foo
andrg foo/
to have different behavior whenfoo
was a symlink. - BUG #270:
Fix bug where patterns starting with a
-
couldn't be used with the-e/--regexp
flag. (This resolves a regression that was introduced in ripgrep 0.3.0.)
Bug fixes:
- BUG #242:
ripgrep didn't respect
--colors foo:none
correctly. Now it does.
This is a new minor version release of ripgrep that includes two breaking changes with lots of bug fixes and some new features and performance improvements. Notably, if you had a problem with colors or piping on Windows before, then that should now be fixed in this release.
BREAKING CHANGES:
- ripgrep now requires Rust 1.11 to compile. Previously, it could build on Rust 1.9. The cause of this was the move from Docopt to Clap for argument parsing.
- The
-e/--regexp
flag can no longer accept a pattern starting with a-
. There are two work-arounds:rg -- -foo
andrg [-]foo
orrg -e [-]foo
will all search for the same-foo
pattern. The cause of this was the move from Docopt to Clap for argument parsing. This may get fixed in the future..
Performance improvements:
- PERF #33: ripgrep now performs similar to GNU grep on small corpora.
- PERF #136: ripgrep no longer slows down because of argument parsing when given a large argument list.
Feature enhancements:
- Added or improved file type filtering for Elixir.
- FEATURE #7:
Add a
-f/--file
flag that causes ripgrep to read patterns from a file. - FEATURE #51:
Add a
--colors
flag that enables one to customize the colors used in ripgrep's output. - FEATURE #138:
Add a
--files-without-match
flag that shows only file paths that contain zero matches. - FEATURE #230: Add completion files to the release (Bash, Fish and PowerShell).
Bug fixes:
- BUG #37:
Use correct ANSI escape sequences when
TERM=screen.linux
. - BUG #94: ripgrep now detects stdin on Windows automatically.
- BUG #117: Colors should now work correctly and automatically inside mintty.
- BUG #182:
Colors should now work within Emacs. In particular,
--color=always
will emit colors regardless of the current environment. - BUG #189:
Show less content when running
rg -h
. The full help content can be accessed withrg --help
. - BUG #210: Support non-UTF-8 file names on Unix platforms.
- BUG #231: Switch from block buffering to line buffering.
- BUG #241:
Some error messages weren't suppressed when
--no-messages
was used.
Bug fixes:
- BUG #226:
File paths explicitly given on the command line weren't searched in parallel.
(This was a regression in
0.2.7
.) - BUG #228:
If a directory was given to
--ignore-file
, ripgrep's memory usage would grow without bound.
Bug fixes:
- Fixed a bug with the SIMD/AVX features for using bytecount in commit
4ca15a
.
Performance improvements:
- PERF #223: Added a parallel recursive directory iterator. This results in major performance improvements on large repositories.
- PERF #11:
ripgrep now uses the
bytecount
library for counting new lines. In some cases, ripgrep runs twice as fast. UseRUSTFLAGS="-C target-cpu=native" cargo build --release --features 'simd-accel avx-accel'
to get the fastest possible binary.
Feature enhancements:
- Added or improved file type filtering for Agda, Tex, Taskpaper, Markdown, asciidoc, textile, rdoc, org, creole, wiki, pod, C#, PDF, C, C++.
- FEATURE #149:
Add a new
--no-messages
flag that suppresses error messages. Note thatrg foo 2> /dev/null
also works. - FEATURE #159:
Add a new
-m/--max-count
flag that limits the total number of matches printed for each file searched.
Bug fixes:
- BUG #199:
Fixed a bug where
-S/--smart-case
wasn't being applied correctly to literal optimizations. - BUG #203:
Mention the full name, ripgrep, in more places. It now appears in
the output of
--help
and--version
. The repository URL is now also in the output of--help
and the man page. - BUG #215:
Include small note about how to search for a pattern that starts with a
-
.
Feature enhancements:
- Added or improved file type filtering for Fish.
Bug fixes:
- BUG #206:
Fixed a regression with
-g/--glob
flag in0.2.5
.
Feature enhancements:
- Added or improved file type filtering for Groovy, Handlebars, Tcl, zsh and Python.
- FEATURE #9:
Support global gitignore config and
.git/info/exclude
files. - FEATURE #45: Add --ignore-file flag for specifying additional ignore files.
- FEATURE #202:
Introduce a new
ignore
crate that encapsulates all of ripgrep's gitignore matching logic.
Bug fixes:
- BUG #44: ripgrep runs slowly when given lots of positional arguments that are directories.
- BUG #119:
ripgrep didn't reset terminal colors if it was interrupted by
^C
. Fixed in PR #187. - BUG #184: Fixed a bug related to interpreting gitignore files in parent directories.
SKIPPED.
Bug fixes:
Packaging updates:
ripgrep
is now in homebrew-core.brew install ripgrep
will do the trick on a Mac.ripgrep
is now in the Archlinux community repository.pacman -S ripgrep
will do the trick on Archlinux.- Support has been discontinued for i686-darwin.
- Glob matching has been moved out into its own crate:
globset
.
Feature enhancements:
- Added or improved file type filtering for CMake, config, Jinja, Markdown, Spark.
- FEATURE #109: Add a --max-depth flag for directory traversal.
- FEATURE #124: Add -s/--case-sensitive flag. Overrides --smart-case.
- FEATURE #139:
The
ripgrep
repo is now a Homebrew tap. This is useful for installing SIMD accelerated binaries, which aren't available in homebrew-core.
Bug fixes:
- BUG #87, BUG #127, BUG #131: Various issues related to glob matching.
- BUG #116: --quiet should stop search after first match.
- BUG #121: --color always should show colors, even when --vimgrep is used.
- BUG #122: Colorize file path at beginning of line.
- BUG #134: Processing a large ignore file (thousands of globs) was very slow.
- BUG #137: Always follow symlinks when given as an explicit argument.
- BUG #147: Clarify documentation for --replace.
Feature enhancements:
- Added or improved file type filtering for Clojure and SystemVerilog.
- FEATURE #89: Add a --null flag that outputs a NUL byte after every file path.
Bug fixes:
- BUG #98: Fix a bug in single threaded mode when if opening a file failed, ripgrep quit instead of continuing the search.
- BUG #99: Fix another bug in single threaded mode where empty lines were being printed by mistake.
- BUG #105: Fix an off-by-one error with --column.
- BUG #106: Fix a bug where a whitespace only line in a gitignore file caused ripgrep to panic (i.e., crash).
Feature enhancements:
- Added or improved file type filtering for VB, R, F#, Swift, Nim, Javascript, TypeScript
- FEATURE #20: Adds a --no-filename flag.
- FEATURE #26: Adds --files-with-matches flag. Like --count, but only prints file paths and doesn't need to count every match.
- FEATURE #40:
Switch from using
.rgignore
to.ignore
. Note that.rgignore
is still supported, but deprecated. - FEATURE #68: Add --no-ignore-vcs flag that ignores .gitignore but not .ignore.
- FEATURE #70: Add -S/--smart-case flag (but is disabled by default).
- FEATURE #80:
Add support for
{foo,bar}
globs.
Many many bug fixes. Thanks every for reporting these and helping make
ripgrep
better! (Note that I haven't captured every tracking issue here,
some were closed as duplicates.)
- BUG #8: Don't use an intermediate buffer when --threads=1. (Permits constant memory usage.)
- BUG #15: Improves the documentation for --type-add.
- BUG #16, BUG #49, BUG #50, BUG #65: Some gitignore globs were being treated as anchored when they weren't.
- BUG #18: --vimgrep reported incorrect column number.
- BUG #19: ripgrep was hanging waiting on stdin in some Windows terminals. Note that this introduced a new bug: #94.
- BUG #21:
Removes leading
./
when printing file paths. - BUG #22:
Running
rg --help | echo
causedrg
to panic. - BUG #24: Clarify the central purpose of rg in its usage message.
- BUG #25: Anchored gitignore globs weren't applied in subdirectories correctly.
- BUG #30:
Globs like
foo/**
should match contents offoo
, but notfoo
itself. - BUG #35,
BUG #81:
When automatically detecting stdin, only read if it's a file or a fifo.
i.e., ignore stdin in
rg foo < /dev/null
. - BUG #36: Don't automatically pick memory maps on MacOS. Ever.
- BUG #38: Trailing whitespace in gitignore wasn't being ignored.
- BUG #43: --glob didn't work with directories.
- BUG #46: Use one fewer worker thread than what is provided on CLI.
- BUG #47: --help/--version now work even if other options are set.
- BUG #55: ripgrep was refusing to search /proc/cpuinfo. Fixed by disabling memory maps for files with zero size.
- BUG #64: The first path given with --files set was ignored.
- BUG #67:
Sometimes whitelist globs like
!/dir
weren't interpreted as anchored. - BUG #77: When -q/--quiet flag was passed, ripgrep kept searching even after a match was found.
- BUG #90: Permit whitelisting hidden files.
- BUG #93: ripgrep was extracting an erroneous inner literal from a repeated pattern.