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:

["dependencies"]
["dev-dependencies"]
["build-dependencies"]
["workspace.members"]
["workspace.exclude"]

if you have a header to add open a PR's, they are welcomed.

Install

cargo install cargo-sort-ck

Run

Defaults to current dir but any path can be passed in.

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:
    <CWD>    Sets cwd, must contain Cargo.toml

Wildcard expansion is supported so you can do this

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.

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

[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 so

[dependencies]
a="0.1.1"
b="0.1.1"
# comments will stay with the item
c="0.1.1"

[dependencies.alpha]
version="0"

[dependencies.beta]
version="0"

# comments will also stay with header
[dependencies.zed]
version="0"

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

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