✓ Uses Rust 2018 edition
|0.1.2||Jun 8, 2019|
|0.1.1||Jun 7, 2019|
|0.1.0||Jun 7, 2019|
#67 in Cargo plugins
The command is still at alpha stage. Do not expect too much.
Improve the quality of your documentation. Use correct English words and grammar, let literally anyone understand your documentation, allow anyone to use your code, reduce the amount of time people need to spent to understand how the crate works and what it does. Good examples are necessary but correct spelling and understandable explanation worths not less.
To check your code for grammar and spelling mistakes, the
grammarly crate is used.
The utility simply grabs all the doc comments (
#![doc = "text"] and
#[doc = "text"]) from your crate's source code and sends it to the grammarly grammar
checking bot using the
grammarly crate. If there are any mistakes in your texts, they
are printed using the way the
rustc compiler prints its warning and errors.
The doc comments are parsed using the
proc_macro2 crates. These are used
specifically to know where in the code these comments are. Doing it with regular
expressions would waste a lot of time.
The grammarly service has its rate limits, and on
06/06/19 these are:
Grammar Bot offers the most generous free limits on grammar and spelling check, but it's not unlimited. With an API key, you can receive 250 requests/day (~7500/mo) at no cost. Without an API key, requests are limited to 100 per day per IP address (~3000/mo). Contact us for paid options if you need higher volumes.
The crate tries hard to minimize the times it sends the requests to the grammarly service, but make sure you understand the rate limits and that the utility sometimes may not give you any hints.
- Always put the dot at the end of a sentence.
- If you are registered on the service, it is better to use your account in the service instead, because it does not have any rate limits.
- Don't use the `` markdown symbols very often, because the grammarly does not handle them correctly.
The utility works out of the box, however, if you want to use your own API key,
you may want to put it in the
.env file or as an environment variable as:
Compile the code as shown in the previous section, then put the
cargo-grammarly executable in your PATH.
My favorite way of doing this is I have a pre-existing directory in
~/bin that contains little scripts of mine, that dir is added to my PATH in my
.bashrc so that it's always available, and then I symlink the release version from where it exists to that directory:
ln -s [starting directory]/cargo-grammarly/target/release/cargo-grammarly ~/bin/
Once you've done that, because of the way cargo is set up to use third party extensions, in any other Rust project of yours, you should be able to run:
and all the documentation and comments of this crate will be checked for grammar.