Skip to content

@sharkdp sharkdp released this May 19, 2020

Features

  • Add new --owner [user][:group] command-line option See #307 (pull #581) (@alexmaco)
    This can be used to filter results by ownership:
    # files matching the 'exercise' pattern, owned by john
    fd exercise --type file --owner john
    
    # files/directories that are not owned by john
    fd --owner '!john'
    
    # … owned by the 'students' group
    fd --owner ':students'
    
    # … owned by the 'students' group, but not by john
    fd --owner '!john:students'
    Note that the new option is currently not available on Windows.
  • Add support for a global ignore file (~/.config/fd/ignore on Unix), see #575 (@soedirgo)
  • Do not exit immediately if one of the search paths is missing, see #587 (@DJRHails)

Bugfixes

  • Reverted a change from fd 8.0 that enabled colors on all Windows terminals (see below) in order to support older Windows versions again, see #577. Unfortunately, this re-opens #469
  • Fix segfault caused by jemalloc on macOS Catalina, see #498
  • Fix --glob behavior with empty pattern, see #579 (@SeamusConnor)
  • Fix --list-details on FreeBSD, DragonFly BSD, OpenBSD and NetBSD. See #573 (@t6)

Changes

  • Updated documentation for --size, see #584
Assets 19

@sharkdp sharkdp released this Apr 16, 2020

Features

  • Add a new -l/--list-details option to show more details about the search results. This is
    basically an alias for --exec-batch ls -l with some additional ls options.
    This can be used in order to:
    • see metadata like permissions, owner, file size, modification times (#491)
    • see symlink targets (#482)
    • achieve a deterministic output order (#324, #196, #159)
  • Add a new --max-results=<count> option to limit the number of search results, see #472, #476 and #555
    This can be useful to speed up searches in cases where you know that there are only N results.
    Using this option is also (slightly) faster than piping to head -n <count> where fd can only
    exit when it finds the search results <count> + 1.
  • Add the alias -1 for --max-results=1, see #561. (@SimplyDanny).
  • Add new --type socket and --type pipe filters, see #511.
  • Add new --min-depth <depth> and --exact-depth <depth> options in addition to the existing option
    to limit the maximum depth. See #404.
  • Support additional ANSI font styles in LS_COLORS: faint, slow blink, rapid blink, dimmed, hidden and strikethrough.

Bugfixes

  • Preserve non-UTF8 filenames: invalid UTF-8 filenames are now properly passed to child-processes
    when using --exec, --exec-batch or --list-details. In fd's output, we replace non-UTF-8
    sequences with the "�" character. However, if the output of fd goes to another process, we
    print the actual bytes of the filename. For more details, see #558 and #295.
  • LS_COLORS entries with unsupported font styles are not completely ignored, see #552

Changes

  • Colored output will now be enabled by default on older Windows versions.
    This allows the use of colored output if the terminal supports it (e.g.
    MinTTY, Git Bash). On the other hand, this will be a regression for users
    on older Windows versions with terminals that do not support ANSI escape
    sequences. Affected users can use an alias fd="fd --color=never" to
    continue using fd without colors. There is no change of behavior for
    Windows 10. See #469.
  • When using --glob in combination with --full-path, a * character does not match a path
    separation character (/ or \\) anymore. You can use ** for that. This allows things like
    fd -p -g '/some/base/path/*/*/*.txt' which would previously match to arbitrary depths (instead
    of exactly two folders below /some/base/path. See #404.
  • "Legacy" support to use fd -exec (with a single dash) has been removed. Use fd -x or
    fd --exec instead.
  • Overall improved error handling and error messages.

Other

  • Package maintainers on MacOS and Windows might think about adding (GNU) ls as an optional dependency for fd to make full use of fds new -l/--list-details option. For MacOS, fd relies on gls which should be available via coreutils.
  • Korean translation of the README, see: 한국어 (@spearkkk)
Assets 19

@sharkdp sharkdp released this Mar 22, 2020

Features

  • Added --one-file-system (aliases: --mount, --xdev) to not cross file system boundaries on Unix and Windows, see #507 (@FallenWarrior2k).
  • Added --base-directory to change the working directory in which fd is run, see #509 and #475 (@hajdamak).
  • fd will not use colored output if the NO_COLOR environment variable is set, see #550 and #551 (@metadave).
  • fd --exec will return exit code 1 if one of the executed commands fails, see #526 and #531 (@fusillicode and @Giuffre)

Bug Fixes

Changes

  • A flag can now be passed multiple times without producing an error, see #488 and #496 (@rootbid).
  • Search results are sorted when using the -X option to match the behaviour of piping to xargs, see #441 and #524 (@Marcoleni @crash-g).
Assets 19

@sharkdp sharkdp released this Sep 15, 2019

Performance improvements

  • Reduce number of stat syscalls, improving the performance for searches where file metadata is
    required (--type, --size, --changed-within, …), see #434 (@tavianator)
  • Use jemalloc by default, improving the performance for almost all searches, see #481. Note that
    Windows and *musl* builds do not profit from this.

Features

  • Added a new -g/--glob option to switch to glob-based searches (instead of regular expression
    based searches). This is accompanied by a new --regex option that can be used to switch back,
    if users want to alias fd="fd --glob". See #284
  • Added a new --path-separator <sep> option which can be useful for Windows users who
    want/need fd to use / instead of \, see #428 and #153 (@mookid)
  • Added support for hidden files on Windows, see #379
  • When fd is run with the --exec-batch/-X option, it now exposes the exit status of the
    command that was run, see #333.
  • Exit immediately when Ctrl-C has been pressed twice, see #423

Bugfixes

  • Make --changed-within/--changed-before work for directories, see #470

Other

  • Pre-built fd binaries should now be available for armhf targets, see #457 (@detly)
  • fd is now available on Alpine Linux, see #451 (@5paceToast)
  • fd is now in the officla FreeBSD repositories, see #412 (@t6)
  • Added OpenBSD install instructions, see #421 (@evitalis)
  • Added metadata to the Debian package, see #416 (@cathalgarvey)
  • fd can be installed via npm, see #438 (@pablopunk)
Assets 19

@sharkdp sharkdp released this Feb 13, 2019

Features

  • New --exec-batch <cmd>/-X <cmd> option for batch execution of commands, see #360 (@kimsnj).
    This allows you to do things like:
    fd … -X vim  # open all search results in vim (or any other editor)
    fd … -X ls -l  # view detailed stats about the search results with 'ls'
    fd -e svg -X inkscape  # open all SVG files in Inkscape
  • Support for 24-bit color codes (when specified via LS_COLORS) as well as
    different font styles (bold, italic, underline).

Changes

  • A few performance improvements, in particular when printing lots of colorized
    results to the console, see #370
  • The LS_COLORS handling has been "outsourced" to a separate crate (https://github.com/sharkdp/lscolors) that is now being used by other tools as well: fselect, lsd. For details, see #363.

Other

  • fd will be available in Ubuntu Disco DIngo (19.04), see #373 (@sylvestre)
  • This release should come with a static ARM binary (arm-unknown-linux-musleabihf), see #320 (@duncanfinney)
  • Various documentation improvements, see #389

Thanks

Special thanks to @alexmaco for his awesome work on refactoring and code improvements! (see #401, #398, and #383)

Assets 17

@sharkdp sharkdp released this Oct 27, 2018 · 286 commits to master since this release

Features

  • Added support for filtering by file modification time by adding two new options --changed-before <date|duration> and --changed-within <..>. For more details, see the --help text, the man page, the relevant issue #165 and the PR #339 (@kimsnj)
  • Added --show-errors option to enable the display of filesystem error messages such as "permission denied", see #311 (@psinghal20 and @majecty)
  • Added --maxdepth as a (hidden) alias for --max-depth, see #323 (@mqudsi)
  • Added --search-path option which can be supplied to replace the positional path argument at any position.

Changes

  • Loosen strict handling of missing --ignore-file, see #280 (@psinghal20)
  • Re-enabled .ignore files, see #156.

Bugfixes

  • fd could previously get stuck when run from the root directory in the
    presence of zombie processes. This curious bug has been fixed in Rust 1.29 and higher. For more details, see #288, rust-lang/rust#50619 and the fix

Other

  • fd has officially landed in Debian! See #345 for details. Thanks goes to @sylvestre, @paride and possibly others I don't know about.
  • Added Chinese translation of README (@chinanf-boy)

Thanks

A special thanks goes to @joshleeb for his amazing improvements throughout
the code base (new tests, refactoring work and various other things)!

Assets 16

@sharkdp sharkdp released this Aug 19, 2018 · 321 commits to master since this release

Features

Changes

  • With the new version, .gitignore files will only be respected in Git repositories, not outside.
  • A few performance improvements for --type searches, see 641976c and 50a2bab

Other

  • Starting with this release, we will offer pre-built ARM binaries, see #244
  • Added instructions on how to use fd with emacs, see #282 (@redguardtoo)
  • fd is now in the official openSUSE repositories, see #275 (@avindra)
  • fd is now available via MacPorts, see #291 (@raimue)
Assets 16

@sharkdp sharkdp released this Mar 26, 2018 · 353 commits to master since this release

Features

  • Added --type executable (or -t x) to search for executable files only, see #246 (@PramodBisht)
  • Added support for .fdignore files, see #156 and #241.
  • Added --ignore-file option to add custom ignore files, see #156.
  • Suggest --fixed-strings on invalid regular expressions, see #234 (@PramodBisht)
  • Detect when user supplied path instead of pattern, see #235.

Changes

  • .ignore and .rgignore files are not parsed anymore. Use .fdignore files
    or add custom files via --ignore-file instead.
  • Updated to regex-syntax 0.5 (@cuviper)

Bugfixes

  • Properly normalize absolute paths, see #268
  • Invalid utf8 filenames displayed when -e is used, see #250
  • If --type is used, fifos/sockets/etc. are always shown, see #260

Other

  • Packaging:
    • The Arch Linux package is now simply called fd.
    • There is now a fd ebuild for Gentoo Linux.
    • There is a scoop package for fd (Windows).
    • There is a Chocolatey package for fd (Windows).
    • There is a Fedora copr package for fd.
Assets 15

@sharkdp sharkdp released this Feb 10, 2018 · 390 commits to master since this release

Features

  • Files with multiple extensions can now be found via --extension/-e, see #214 (@althonos)

    > fd -e tar.gz
  • Added new -F/--fixed-strings/--literal option that treats the pattern as a literal string instead of a regular expression, see #157

    > fd -F 'file(1).txt'
  • Allow -exec to work as --exec, see #226 (@stevepentland)

Bugfixes

  • Fixed Ctrl-C handling when using --exec, see #224 (@Doxterpepper)

  • Fixed wrong file owner for files in deb package, see #213

Other

Assets 15
You can’t perform that action at this time.