https://github.com/night-crawler/fgr
Find & GRep program
https://github.com/night-crawler/fgr
find grep query rust
Last synced: 15 days ago
JSON representation
Find & GRep program
- Host: GitHub
- URL: https://github.com/night-crawler/fgr
- Owner: night-crawler
- License: mit
- Created: 2022-10-20T09:39:19.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-30T11:45:03.000Z (about 1 year ago)
- Last Synced: 2025-03-31T06:41:29.162Z (about 1 month ago)
- Topics: find, grep, query, rust
- Language: Rust
- Homepage:
- Size: 144 KB
- Stars: 18
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fgr
[](https://github.com/night-crawler/fgr/actions/workflows/main.yml)
[](https://crates.io/crates/fgr-rs)
[](./LICENSE)
Find & Grep utility with SQL-like query language.
## Examples
```bash
# Find all files with name equal to sample under the current directory:
fgr -e name=sample
# Find files with containing 's' and 777 permissions:
fgr /home /bin -e 'name=*s* and perm=777'
# Find files with name containing SAMPLE
fgr /home -e 'name="*SAMPLE*"'
# Find files with name containing SAMPLE ignore case
fgr /home -e 'name=i"*SAMPLE*"'
# Find files with name containing SAMPLE (regex)
fgr /home -e 'name=r".+SAMPLE.+"'
# Find files with name containing SAMPLE ignore case (regex)
fgr /home -e 'name=ri".+SAMPLE.+"'
# Find files under the /bin directory not owned by root:
fgr /bin -e 'user > 0'
# Find files under the /bin directory having suid bit (but not limited to):
fgr /bin -e 'perms>4000'
# Find recently accessed files (but not in future):
fgr /home -e 'atime > now - 1h and atime < now'
# Find stuff in files:
fgr /home -e 'type=text and contains=*stuff*'
# Other examples:
fgr /home /bin -e 'name=*s* and perm=777 or (name=*rs and contains=r".+user.is_birthday.*")'
fgr /home /bin -e 'name=*s* and perm=777 or (name=*rs and contains=*birth*)'
fgr /home /bin -e 'ext=so and mtime >= now - 1d'
fgr /home -e 'size>=1Mb and name != *.rs and type=vid'
# xargs & -print0 support
fgr /home -e 'perms=777' -p | xargs -0 -n1 | sort
```
## Features
- Filter files by:
- Size
- Depth
- Type (text, app, archive, audio, book, doc, font, img, vid)
- atime, mtime
- name, extension
- contents
- user, group, permissions
- Timeout IO operations (does not hang parsing files like `/sys/kernel/security/apparmor/revision`)
- Regex & Glob name matching
- Regex & Glob contents matching
- Nexted expressions
- Human-readable atime/mtime search patterns
- `.ignore` support, thanks to [ignore](https://docs.rs/ignore/latest/ignore/) crate
## Speed
By default, it acts like the `find` and visits all directories.
Search by name is quite fast
```bash
du -h /home
# 98G /home
# About 100G of .gradle, caches and all the whatnot
sudo sh -c 'echo 1 >/proc/sys/vm/drop_caches'
sudo sh -c 'echo 2 >/proc/sys/vm/drop_caches'
sudo sh -c 'echo 3 >/proc/sys/vm/drop_caches'
fgr /home -e 'name=*sample*' # 1.09s user 2.70s system 169% cpu 2.239 total
sudo sh -c 'echo 1 >/proc/sys/vm/drop_caches'
sudo sh -c 'echo 2 >/proc/sys/vm/drop_caches'
sudo sh -c 'echo 3 >/proc/sys/vm/drop_caches'
find /home -name '*sample*' # 0.71s user 2.09s system 12% cpu 22.156 total
```
## TODO
- [x] Query precedence evaluation
- [ ] Run command
- [ ] Exclude patterns & default exclude patterns (handling `/proc/**/pagemap` scenarios)
- [x] Binary/Text type detector
- [x] Ignore case searches
- [ ] Error printing
- [ ] Documentation
- [ ] AUR