Metadata-Version: 2.4
Name: filesnap
Version: 0.1.2
Summary: A simple CLI to handle your files
Project-URL: Repository, https://github.com/jesusjsg/filesnap
Author-email: jesus <jesusjsgdev@gmail.com>
License-File: LICENSE
Keywords: cli,files
Requires-Python: >=3.12
Requires-Dist: typer>=0.21.1
Description-Content-Type: text/markdown

# filesnap

`filesnap` is a command-line tool for managing files and directories.

## Commands

### `filesnap scan`

Scans all the files in the path.

| Argument | Description | Default |
|---|---|---|
| `path` | Path to scan | Current directory |

| Option | Alias | Description |
|---|---|---|
| `--recursive` | `-r` | Recursive search. |
| `--pretty` | `-p` | Pretty print the output in a table. |
| `--exclude` | | Exclude files/directories from scanning. |
| `--ext` | `-e` | Scan only files with these extensions. |

### `filesnap count`

Counts all the files by extension in the path selected.

| Argument | Description | Default |
|---|---|---|
| `path` | Path to count | Current directory |

| Option | Alias | Description |
|---|---|---|
| `--recursive` | `-r` | Recursive search. |
| `--exclude` | | Exclude files/directories from counting. |

### `filesnap clean`

Cleans the content of a path.

| Argument | Description |
|---|---|
| `path` | Path to clean |

| Option | Alias | Description |
|---|---|---|
| `--recursive` | `-r` | Recursive cleaning. |
| `--contain` | `-c` | Clean only files containing this string. |
| `--ext` | `-e` | Clean only files with these extensions. |
| `--exclude` | | Exclude files/directories from cleaning. |
| `--force` | `-f` | Force deletion without confirmation. |
| `--dry-run` | `--dry` | Simulate cleaning without deleting files. |

### `filesnap export`

Exports the filenames to a file.

| Argument | Description |
|---|---|
| `path` | Path to scan for filenames |

| Option | Alias | Description |
|---|---|---|
| `--type` | `-t` | The type of file to export to (e.g., `txt`, `csv`, `json`). |
| `--recursive` | `-r` | Recursive scanning. |
| `--output` | `-o` | The output file name. |
| `--format` | `-f` | The format of the output. |
| `--column` | `-c` | The column to export (defaults to `file_name`). |

