#cargo-docs #links #mentioned #doctor #healthy #link #remote

app cargo-doctor

Checks if all links mentioned in cargo docs of a crate are healthy

3 releases

Uses old Rust 2015

0.1.2 Sep 27, 2018
0.1.1 Sep 27, 2018
0.1.0 Sep 27, 2018

#542 in Cargo plugins

Apache-2.0 OR MIT

16KB
375 lines

Doctor

Checks if all links mentioned in cargo docs of a crate are active

Build Status Latest Version

Installation

$ cargo install cargo-doctor

(Please check cargo's documentation to learn how cargo install works and how to set up your system so it finds binaries installed by cargo.)

Usage:

Doctor scans the docs and checks if every link mentioned is live or broken. It can work with both docs generated locally using cargo doc and those uploaded on docs.rs.

###Local Docs: To run doctor on the local docs use the -l flag:

cargo doctor -l
# or
cargo doctor --local

This will output either a success message or the list of links that are not found/active.

Ensure you have run cargo doc before running doctor.

Remote Docs:

To run doctor on docs.rs links of your crate, run:

cargo doctor -r 
# or
cargo doctor --remote

It will generate the link from the crate name and version provided in Cargo.toml of your crate.

You can also use --path or -p to specify a different path along with -r or -l

cargo doctor -r --path="https://docs.rs/cargo_doctor/0.1.0/cargo_doctor/"

(Note: the path should end with /)

Contribution:

If you want to suggest any new feature or report a bug, you can open an issue here or drop in a pull request directly.

Right now, I still need to tests for most of the functions, so you can test it locally by running:

cargo run -- -r

This package is written using Rust 1.29.1.

When submitting a Pull request, run cargo fmt on the latest nightly before committing.

License

Licensed under either of

at your option.

Dependencies

~22MB
~472K SLoC