polykill 1.2.6

Lightweight command line utility for removing dependencies and build artifacts from unused projects.
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
51
52
53
54
55
56
57
58
59

# Polykill

Lightweight command line utility for removing dependencies and build artifacts from unused local projects. Inspired by [npkill](https://www.npmjs.com/package/npkill#usage).

Supported project types:
- Cargo
- Node
- Mix
- .NET Core
- Gradle
- Composer
- Misc (see "Addional Information")

## Installation

```sh
cargo install polykill
```

## Usage

```sh
polykill [OPTIONS] [DIR]
```

Polykill will recursively search for projects in the provided directory and output a list of all projects found. If no directory is provided, the current directory will be searched.

Move between listed projects using ↓,↑,←,→ and press enter to delete artifacts for the selected project.

Press *q* or *esc* to exit.

**Warning for Node projects:** Some Node applications need their node_modules directory to work and deleting it may break them.

## Options

| Argument         | Description                                   |
| ---------------- | --------------------------------------------- |
| -v, --verbose    | Verbose output                                |
| -n, --no-git     | Include projects not tracked by git           |
| -s, --skip-empty | Hide projects with zero possible disk savings |
| -u, --unsorted   | Don't sort projects                           |
| -h, --help       | Print help                                    |
| -V, --version    | Print version                                 |

*--no-git option will slow down project search

## Additional Information

How projects are identified and which directories are used for dependencies and build artifacts:

| Type      | Identifier(s)      | Directories      |
| --------- | ------------------ | ---------------- |
| Node      | package.json       | node_modules     |
| Cargo     | cargo.toml         | target           |
| Mix       | mix.exs            | _build, deps     |
| .NET Core | .csproj            | bin, obj         |
| Gradle    | build.gradle(.kts) | build            |
| Composer  | composer.json      | vendor           |
| Misc      | bin, build, dist   | bin, build, dist |