rustdoc-prettier

Format //! and /// comments with prettier

Installation

cargo install rustdoc-prettier

rustdoc-prettier requires prettier to be installed independently, e.g.:

npm install -g prettier

Usage

rustdoc-prettier [ARGS]

Arguments ending with .rs are considered source files and are formatted. All other arguments are forwarded to prettier, with one exception. An option of the form:

    ---max-width <N>

is converted to options of the form:

    --prose-wrap always --print-width <M>

where M is N minus the width of the indentation, of the //! or /// syntax, and of the space that might follow that syntax. If the current directory contains a rustfmt.toml file with a max_width key, the --max-width option will be applied automatically. See: https://prettier.io/docs/en/options.html

Notes

rustdoc-prettier parses source code manually. It does not use rustdoc-json. There are two reasons for this:

1. rustdoc-json provides the span of the commented code, but not of the comment itself. To the best of my knowledge, there is no easy way to extract rustdoc comments using rustdoc-json's output.
2. rustdoc-json does not output spans for items that come from macro expansions or inline assembly. However, there are legitimate reasons to want to format such comments.