Cargo Sort Check

A tool to check that your Cargo.toml dependencies are sorted alphabetically. Project inspired by jpoles1 as a solution to @dtolnay's request for implementation #29. Cross platform implementation, windows compatible. Terminal coloring works on both cmd.exe and powershell. Checks/sorts by key in tables and also nested table headers (does not sort the items in a nested header, sorts the table itself).

Use

There are three modes cargo-sort-ck can be used in: 1. default - no flags set cargo-sort-ck will pass (exit 0) if .toml is sorted or fail if not (exit 1). 2. -p or --print - will print the sorted toml file to stdout. 3. -w or --write - will rewrite the toml file, I would like to eventually add some kind of check like cargo fix to warn if file is uncommitted.

included in sort check is: toml ["dependencies"] ["dev-dependencies"] ["build-dependencies"] ["workspace.members"] ["workspace.exclude"] if you have a header to add open a PR's, they are welcomed.

Install

bash cargo install cargo-sort-ck

Run

Defaults to current dir but any path can be passed in. ```bash cargo-sort-ck Devin R devin.ragotzy@gmail.com Helps ensure Cargo.toml dependency list is sorted.

USAGE: cargo-sort-ck [FLAGS] [CWD]

FLAGS: -h, --help Prints help information -p, --print prints Cargo.toml, lexically sorted, to the screen -V, --version Prints version information -w, --write rewrites Cargo.toml file so it is lexically sorted

ARGS: Sets cwd, must contain Cargo.toml ```

Wildcard expansion is supported so you can do this bash cargo-sort-ck [FLAGS] [path/to/*/Cargo.toml | path/to/*] or any other pattern that is supported by your terminal. This also means multiple paths work. bash cargo-sort-ck [FLAGS] path/to/a path/to/b path/to/c/Cargo.toml These are all valid, file name and extension can be used on some of the paths, if left off the default is still Cargo.toml.

Examples

```toml [dependencies] a="0.1.1"

comments will stay with the item

c="0.1.1"

ILLEGAL no newline in table items

b="0.1.1"

[dependencies.alpha] version="0"

[build-dependencies] foo="0" bar="0"

comments will also stay with header

[dependencies.zed] version="0"

[dependencies.beta] version="0"

[dev-dependencies] bar="0" foo="0"

Will sort to, or fail until organized like sotoml [dependencies] a="0.1.1" b="0.1.1"