ff — Find Files

ff: Just my own fork of [fd] with many incompatible changes. (unstable)

Installation

cargo install ff-find

Usage

``` ff 0.1.0

USAGE: ff [OPTIONS] [DIRECTORY] [PATTERN]

OPTIONS: -g, --glob Match the whole file path with a glob pattern. [default: use regex pattern]

-r, --regex
        The search pattern is a regex pattern by default. It can match part
        of the file path.

-u, --unicode
        Turn on Unicode support for regex patterns. Character classes are
        not limited to ASCII. Only valid UTF-8 byte sequences can be matched
        by the search pattern.

-i, --ignore-case
        Perform a case-insensitive search. This overrides --case-sensitive.

-s, --case-sensitive
        Perform a case-sensitive search. This overrides --ignore-case.

-p, --full-path
        Match the absolute path instead of the filename or directory name.

-L, --follow
        Do not take symlinks as normal files and traverse the symlinked
        directories.

-0, --print0
        Each search result is terminated with NUL instead of LF when
        printed.

-A, --absolute-path
        Relative paths for output are transformed into absolute paths.

-a, --all
        All files and directories are searched. By default, files and
        directories of which the names start with a dot "." are ignored in
        the search.

-I, --no-ignore
        Show search results from files and directories that would otherwise
        be ignored by .*ignore files.

-t, --type <filetype>
        Filter the search by type: [default: no filter]
            directory or d: directories
                 file or f: regular files
              symlink or l: symbolic links
           executable or x: executable regular files

-d, --max-depth <max-depth>
        Limit the directory traversal to a given depth.

-c, --color <when>
        Declare when to use color for the pattern match output:
              auto: use colors for interactive console [default]
             never: do not use colorized output
            always: always use colorized output

-j, --threads <number>
        The number of threads to use for searching & command execution. 0
        means [default: number of available CPU cores]

    --max-buffer-time <milliseconds>
        The amount of time for the search results to be buffered and sorted
        before streaming.

-x, --exec <program [arg]... [;]>
        Run the given command for each search result, which can be
        represented by a pair of braces {} in the command. If the command
        does not contain any {}, then a {} will be appended as an argument
        to the program. A single semicolon ; will terminate the argument
        list.

-h, --help
        Prints help information. Use --help for more details.

-V, --version
        Prints version information

ARGS: The directory where the filesystem search is rooted. If omitted, search the current working directory.

<PATTERN>
        The search pattern, a regular expression or glob string. [optional]

```

References

Regex Syntax: https://docs.rs/regex/0.2.2/regex/#syntax
Glob Syntax: https://docs.rs/globset/0.2.1/globset/#syntax

Note that ff cannot enable Unicode support for glob patterns. Also, the nitty-gritty of supported syntax may change in the future. There are still some todos noted in the source code.

License

Licensed under the [Apache License], Version 2.0 or the [MIT License], at your option. All files in the project carrying such notice may not be copied, modified, or distributed except according to those terms.