findit-cli 0.1.3

A simple and powerful command line utility that can be used to search for files in a directory hierarchy as an alternative to `find`.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# findit

`findit` is a simple and powerful command line utility that can be used to search for files in a directory hierarchy as an alternative to `find`.

## What can you use it for

You can use this tool to find files within a directory using complex filters over the file properties, content or structure.

For example:

```bash
findit src --where 'extension == "rs" AND not content.contains("#[cfg(test)]")'
```

Will find all the rust files under src without any test code.

## Quick Examples

### Find large files

```bash
findit --where 'size > 1000000' --order-by 'size DESC' --limit 10
```

### Find recent files

```bash
findit --where 'modified > now() - 86400'
```

### Find files by content

```bash
findit --where 'content.contains("TODO")'
```

### Find executable files

```bash
findit --where 'NOT IS DIR AND permissions & 0o111 != 0'
```

## Documentation

- [Quick Start Guide](docs/quick-start.md)
- [Installation](docs/install.md)
- [Usage Guide](docs/usage.md)
- [Syntax Reference](docs/syntax/index.md)
- [Cookbook - Real-world Examples](docs/cookbook.md)
- Quick syntax help: `findit --help-syntax`