typos/docs/reference.md

# `typos` Reference

## Configuration

### Sources

Configuration is read from the following (in precedence order)

- Command line arguments
- File specified via `--config PATH`
- Search parents of specified file / directory for one of `typos.toml`, `_typos.toml`, or `.typos.toml`

### Config Fields

| Field                  | Argument          | Format | Description |
|------------------------|-------------------|--------|-------------|
| files.ignore-hidden    | --hidden          | bool   | Skip hidden files and directories. |
| files.ignore-files     | --ignore          | bool   | Respect ignore files. |
| files.ignore-dot       | --ignore-dot      | bool   | Respect .ignore files. |
| files.ignore-vcs       | --ignore-vcs      | bool   | Respect ignore files in vcs directories. |
| files.ignore-global    | --ignore-global   | bool   | Respect global ignore files. |
| files.ignore-parent    | --ignore-parent   | bool   | Respect ignore files in parent directories. |
| default.binary         | --binary          | bool   | Check binary files as text |
| default.check-filename | \-                | bool   | Verifying spelling in file names. |
| default.check-file     | \-                | bool   | Verifying spelling in files. |
| default.ignore-hex     | \-                | bool   | Do not check identifiers that appear to be hexadecimal values. |
| default.identifier-leading-digits   | \-   | bool   | Allow identifiers to start with digits, in addition to letters. |
| default.identifier-include-digits   | \-   | bool   | Allow identifiers to include digits, in addition to letters. |
| default.identifier-leading-chars    | \-   | string | Allow identifiers to start with one of these characters. |
| default.identifier-include-chars    | \-   | string | Allow identifiers to include these characters. |
| default.locale         | --locale          | en, en-us, en-gb, en-ca, en-au   | English dialect to correct to. |
| default.extend-identifiers | \-            | table of strings | Corrections for identifiers. When the correction is blank, the word is never valid. When the correction is the key, the word is always valid. |
| default.extend-words       | \-            | table of strings | Corrections for identifiers. When the correction is blank, the word is never valid. When the correction is the key, the word is always valid. |
| type.<name>.<field>        | <varied>      | <varied>   | See `default.` for child keys.  Run with `--type-list` to see available `<name>`s |
| type.<name>.extend_globs   | \-            | list of strings  | File globs for matching `<name>` |
docs: Add reference 2019-10-25 10:17:58 -04:00			# `typos` Reference

			`## Configuration`

			`### Sources`

			`Configuration is read from the following (in precedence order)`

			`- Command line arguments`
docs: Fix source precedence 2019-10-25 11:39:55 -04:00			- File specified via `--config PATH`
feat(config): Allow separating config from source 2020-10-30 09:33:43 -04:00			- Search parents of specified file / directory for one of `typos.toml`, `_typos.toml`, or `.typos.toml`
docs: Add reference 2019-10-25 10:17:58 -04:00
			`### Config Fields`

			`\| Field \| Argument \| Format \| Description \|`
			`\|------------------------\|-------------------\|--------\|-------------\|`
feat: Support english dialects The goal is to be as accepting and unobtrusive to new code bases as possible. To this end, we correct typos into the closest english dialect. If someone wants to opt-in, they can have typos correct to a specific english dialect. Fixes #52 Fixes #22 2020-05-27 21:46:41 -04:00			`\| files.ignore-hidden \| --hidden \| bool \| Skip hidden files and directories. \|`
			`\| files.ignore-files \| --ignore \| bool \| Respect ignore files. \|`
			`\| files.ignore-dot \| --ignore-dot \| bool \| Respect .ignore files. \|`
			`\| files.ignore-vcs \| --ignore-vcs \| bool \| Respect ignore files in vcs directories. \|`
			`\| files.ignore-global \| --ignore-global \| bool \| Respect global ignore files. \|`
			`\| files.ignore-parent \| --ignore-parent \| bool \| Respect ignore files in parent directories. \|`
fix(config)!: Move binary to file Seems like it would make sense to allow varying this by directory (when supporting layering) and by file type. 2021-01-05 11:35:43 -05:00			`\| default.binary \| --binary \| bool \| Check binary files as text \|`
feat: Support english dialects The goal is to be as accepting and unobtrusive to new code bases as possible. To this end, we correct typos into the closest english dialect. If someone wants to opt-in, they can have typos correct to a specific english dialect. Fixes #52 Fixes #22 2020-05-27 21:46:41 -04:00			`\| default.check-filename \| \- \| bool \| Verifying spelling in file names. \|`
			`\| default.check-file \| \- \| bool \| Verifying spelling in files. \|`
			`\| default.ignore-hex \| \- \| bool \| Do not check identifiers that appear to be hexadecimal values. \|`
			`\| default.identifier-leading-digits \| \- \| bool \| Allow identifiers to start with digits, in addition to letters. \|`
			`\| default.identifier-include-digits \| \- \| bool \| Allow identifiers to include digits, in addition to letters. \|`
			`\| default.identifier-leading-chars \| \- \| string \| Allow identifiers to start with one of these characters. \|`
			`\| default.identifier-include-chars \| \- \| string \| Allow identifiers to include these characters. \|`
refactor(config)!: Detect when no dict config In preparing for smarter handling of config, we need to be able to tell what is present and what isn't. BREAKING CHANGE: `--hex` was removed, the value didn't seem high enough. 2021-03-01 21:37:05 -05:00			`\| default.locale \| --locale \| en, en-us, en-gb, en-ca, en-au \| English dialect to correct to. \|`
feat: Custom dictionary support Switching `valid-` to just `` where you map typo to correction, with support for always-valid and never-valid. Fixes #9 2020-10-24 22:17:16 -04:00			`\| default.extend-identifiers \| \- \| table of strings \| Corrections for identifiers. When the correction is blank, the word is never valid. When the correction is the key, the word is always valid. \|`
			`\| default.extend-words \| \- \| table of strings \| Corrections for identifiers. When the correction is blank, the word is never valid. When the correction is the key, the word is always valid. \|`
feat(config): Add new file types Fixes #220 2021-04-06 22:14:35 -04:00			\| type.<name>.<field> \| <varied> \| <varied> \| See `default.` for child keys. Run with `--type-list` to see available `<name>`s \|
			\| type.<name>.extend_globs \| \- \| list of strings \| File globs for matching `<name>` \|