A tool for checking GitHub repositories for spelling errors and submitting PRs to fix them.
When I'm looking through the documentation of an open-source software project, I sometimes notice a typo. When I do, I usually create a pull request to fix it. I wanted to streamline this process.
You need to have Git, Node.js, and NPM installed.
$ npm install --global github-spellcheck-cli
The command is github-spellcheck. It takes the following options:
-h, --help Print this usage guide.
-t, --token <token> GitHub personal access token. You only need to provide the token when you
start using github-spellcheck, and again if you have a new token.
-r, --repository <username/repository or URL> The repository to spellcheck.
--branch <branch name> The name of the branch to commit corrections to.
--base <branch name> The name of the branch to create the pull request against.
-e, --extensions <extension> [<extension>] ... Only spellcheck files with these extensions for spelling mistakes.
--include <glob> ... Only spellcheck files that match at least one of these globs.
--exclude <glob> ... Do not spellcheck files that match one of these globs.
The tool will search for potential spelling mistakes in the specified GitHub repository, then ask you what you want to do with each mistake. Here are the commands that the tool accepts:
Command Meaning Description
y yes Include this correction in the pull request.
n no Do not include this correction in the pull request.
d delete repeated Delete the word to be corrected and the space in front of it. For example, "the the" will become "the".
w whitelist Permanently whitelist the word to be corrected.
e edit Replace the word to be corrected with a specified word.
s skip file Do not include this correction on any other corrections in this file.
h help Print this usage guide.
The whitelist is stored at ~/.github-spellcheck/whitelist.txt.
Instructions for generating a personal access token are here. The token should have the repo and delete_repo scopes.
After generating a personal access token, invoke the tool as follows:
$ github-spellcheck --token <token> --repository ...
It's only necessary to pass --token <token> to the tool once, or if you want to update the token. GitHub Spellcheck will store the token in a file and subsequent invocations will read the token from there.
Fork this repository, clone your fork, then run npm install.
You can run node index.js to start the CLI or npm test to run the tests.
Run npm run lint to run ESLint or npm run lint-fix to automatically fix problems.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent