cargo-features-manager 0.7.1

A tui tool to enable/disable & prune dependency features
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# Cargo Features Manger

A TUI-like cli tool to manage the features of your rust-projects dependencies.

You can view all available features and easily toggle (enable & disable) them with one button click. All of your changes
will directly be reflected in your Cargo.toml file.

## install

`cargo install cargo-features-manager`

## usage

### viewer

To start the tool run `cargo features` in your project root dir.

This will open the dependency-selector:

![dependencySelector](resources/dependencySelector.png)

Now you can select the dependency for which you want to change the enabled features.

Selecting a dependency will open the feature-selector:

![featureSelector](resources/featureSelector.png)

When using `cargo features -d <dependency name>` it will directly open the corresponding feature-selector.

#### navigation

<kbd>↑</kbd> to move up

<kbd>↓</kbd> to move down

<kbd>Space</kbd> | <kbd>Enter</kbd> | <kbd>→</kbd> to select

<kbd>ESC</kbd> | <kbd>←</kbd> to move back

#### dependency selector

Dependency which do not have any features are marked grey. <br>
Dev-Dependency are marked with 🧪. <br>
Build-Dependency are marked with 🛠️. <br>
Workspace-Dependency are marked with 🗃️️.

![dependencySelector](resources/dependencySelector.png)

#### feature selector

All default features are marked Green.

![greenMark](resources/greenMark.png)

When hovering above a feature it shows other features which the selected feature requires.

![featureDependency](resources/featureDependency.png)

Features marked with 📦 mean that they require an optional dependency.

![featurePackageDependency](resources/featurePackageDependency.png)

Features which an active feature requires are marked grey.

![greyFeature](resources/greyFeature.png)

Features marked with 🗃️️ are enabled by the workspace dependency and can only be disabled by the workspace dependency

![workspaceFeatures](resources/workspaceFeatures.png)

#### search mode

At any point you can start typing like normal.
This will start using your input as a search query.

### prune

You can run prune with `cargo features prune`

this will disable all features which are not required to compile.

#### always keep

If your project requires a features to be enabled which does not make the compile fail. you can create a file
called `Features.toml` in there you can define features which will not get disabled.

```toml
clap = ["help"]
```