3 stable releases

new 1.1.1	Nov 2, 2024
1.1.0	Oct 28, 2024
1.0.0	Oct 27, 2024

#207 in Command line utilities

237 downloads per month

GPL-3.0-or-later

100KB
82 lines

lookfor

A cross-platform command line utility to find and highlight files that match a pattern.

Installation

From crates.io: cargo install lookfor
From GitHub: cargo install --git https://github.com/DarkCeptor44/lookfor
Manually (after cloning the repo locally): cargo install --path .
From releases.

Usage

usage

$ lookfor -h
Cross-Platform file finder

Usage: lookfor [OPTIONS] <PATTERN>

Arguments:
  <PATTERN>  Pattern to search for

Options:
      --in <PATH>       Path to search in [default: .]
      --color <COLOR>   Color of the highlighted text (off for no color) [default: blue]
  -I, --case-sensitive  Case sensitive search
  -h, --help            Print help
  -V, --version         Print version

Todo

Add support for regular expressions.

Benchmarks

The benchmarks were performed on different machines at the root of the repository after running both cargo build and cargo build -r, to find anything with clap in the target directory.

Machine A: AMD64, 32GB RAM, Ryzen 7 3800X
Machine B: ARM64, 1GB RAM, Orange Pi Zero2

Windows

Ran on Machine A (Windows 10):

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`lookfor clap`	44.8 ± 1.5	43.4	53.1	1.00
`dir /s /b clap`	75.4 ± 1.7	73.2	79.7	1.68 ± 0.07
`findstr /s /m /c:clap *`	694.5 ± 4.8	686.8	702.2	15.51 ± 0.52

Linux

Ran on Machine A (WSL2 Debian 12):

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`lookfor clap`	167.4 ± 7.7	160.6	187.3	1.00
`find . -iname "clap"`	271.9 ± 13.3	250.0	283.1	1.62 ± 0.11

Ran on Machine B (Debian 12):

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`lookfor clap`	14.0 ± 0.2	13.5	14.6	1.06 ± 0.04
`find . -iname "clap"`	13.2 ± 0.4	12.6	15.0	1.00

License

This project is licensed under the terms of the GNU General Public License v3.0.

Dependencies

~1.3–8.5MB
~72K SLoC