Find files matching patterns while respecting
.gitignore
FilesFinder (FF) is a command-line tool that aims to search for files within a given repository.
As such, it respects your .gitignore files and exclude the same files from the output.
FF is a simple-to-use alternative to other tools such as find from Findutils.
You can install the latest released version with cargo:
```bash
cargo install filesfinder ```
After that, FilesFinder can be used via the ff alias.
```text
USAGE:
ff [OPTIONS]
ARGS:
OPTIONS: -g, -G Parse pattern as a glob expression. [default behavior]
-r, -R
Parse pattern as a regular expression.
-i, -I
Matching files will be included in the output.
[default behavior]
-e, -E
Matching files will be excluded from the output.
--dir <PATH>
Files will be searched in the directory specified by the PATH.
[default: '.']
--show-hidden
Allow to show hidden files.
--no-gitignore
Ignore gitignore files.
-h, --help
Print help information.
-V, --version
Print version information.
NOTES: - Capitalized options (.e.g. '-G') apply to all subsequent patterns. E.g.: 'ff -g ".rs" -g ".md"' is equivalent to 'ff -G ".rs" ".md"'. You can always unset a flag by overriding it.
- Options can be grouped under the same '-'.
E.g.: 'ff -e -g "*.rs"' is equivalent to 'ff -eg "*.rs"'.
- File exclusion is performed after file inclusion.
- For performance reasons, prefer to use more general patterns first,
and more specific ones at the end.
E.g.: 'ff "*.md" "README.md"' is faster but equivalent to 'ff "README.md" "*.md"'.
```
```bash
ff "*.rs"
List all files with '.rs' extension
ff ".rs" -e "src/*.rs"
List all files with 'rs' extension except those in the 'src' folder
ff -r ".*.md"
List all files with 'md' extension, using regular expression
ff -Re "..md" "."
List all files except those with 'md' extension, using regular expression
```
Contributions are more than welcome!