mirror of
https://github.com/crate-ci/typos.git
synced 2024-11-24 18:10:56 -05:00
006204e66a
Trying to avoid accidentally correcting something that looks like a word inside a hex number, like `0xBEAF`. Fixes #19
63 lines
4.1 KiB
Markdown
63 lines
4.1 KiB
Markdown
# About `typos`
|
|
|
|
## Design Requirements
|
|
|
|
Spell checks source code:
|
|
- Requires special word-splitting logic to handle situations like hex (`0xDEADBEEF`), `c\nescapes`, `snake_case`, `CamelCase`, `SCREAMING_CASE`, and maybe `arrow-case`.
|
|
- Each programming language has its own quirks, like abbreviations, lack of word separator (`copysign`), etc
|
|
- Backwards compatibility might require keeping misspelled words.
|
|
- Case for proper nouns is irrelevant.
|
|
|
|
Checking for errors in a CI:
|
|
- No false-positives.
|
|
- On spelling errors, sets the exit code to fail the CI.
|
|
|
|
Quick feedback and resolution for developer:
|
|
- Fix errors for the user.
|
|
- Integration into other programs, like editors:
|
|
- `fork`: easy to call into and provides a stable API, including output format
|
|
- linking: either in the language of choice or bindings can be made to language of choice.
|
|
|
|
## Design Trade Offs
|
|
|
|
### typos uses a blacklist
|
|
|
|
Blacklist: Known typos that map to their corresponding word
|
|
- Ignores unknown typos
|
|
- Ignores typos that follow c-escapes if they aren't handled correctly
|
|
|
|
Whitelist: A confidence rating is given for how close a word is to one in the whitelist
|
|
- Sensitive to false positives due to hex numbers and c-escapes
|
|
- Traditional spell checkers use a whitelist.
|
|
|
|
## Related Spell Checkers
|
|
|
|
| | typos | [bloom42/misspell][misspell-rs] | [client9/misspell][misspell-go] | [codespell] | [scspell3k] |
|
|
|----------------|-----------------------|---------------------------------|---------------------------------|-------------|-------------|
|
|
| "Runtime" | Rust ([#18][def-18]) | Rust | None | Python | Python |
|
|
| Dictionary | Blacklist | Blacklist | Blacklist | Blacklist | Whitelist |
|
|
| Custom Dict | No ([#9][def-9]) | No | ? | Yes | Yes |
|
|
| Per-Lang Dict | No ([#14][def-14]) | No | ? | No | Yes |
|
|
| CamelCase | Yes | No | ? | No | Yes |
|
|
| snake_case | Yes | No | ? | No | Yes |
|
|
| Ignore Hex | Yes | No | ? | No | Yes |
|
|
| C-Escapes | No ([#20][def-3]) | No | ? | No | Yes |
|
|
| Encodings | UTF-8 ([#17][def-17]) | UTF-8 | ? | Auto | Auto |
|
|
| Whole-project | Yes | Yes | Yes | Yes | No |
|
|
| Ignores hidden | Yes | Yes | ? | Yes | No |
|
|
| Respect gitignore | Yes | Yes | ? | No | No |
|
|
| Checks filenames | No ([#24][def-24]) | No | ? | Yes | No |
|
|
| API | Rust / [JSON Lines] | Rust | ? | Python | None |
|
|
| License | MIT or Apache | AGPL | MIT | GPLv2 | GPLv2 |
|
|
|
|
[JSON Lines]: http://jsonlines.org/
|
|
[scspell3k]: https://github.com/myint/scspell
|
|
[misspell-rs]: https://gitlab.com/bloom42/misspell
|
|
[misspell-go]: https://github.com/client9/misspell
|
|
[codespell]: https://github.com/codespell-project/codespell
|
|
[def-9]: https://github.com/epage/typos/issues/9
|
|
[def-14]: https://github.com/epage/typos/issues/14
|
|
[def-17]: https://github.com/epage/typos/issues/17
|
|
[def-18]: https://github.com/epage/typos/issues/18
|
|
[def-24]: https://github.com/epage/typos/issues/24
|
|
[def-3]: https://github.com/epage/typos/issues/3
|