Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
code

GitHub Action

Codespell with annotations

v1.0

Codespell with annotations

code

Codespell with annotations

Codespell with annotations for Pull Request

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Codespell with annotations

uses: codespell-project/[email protected]

Learn more about this action in codespell-project/actions-codespell

Choose a version

Codespell with GitHub Actions -- including annotations for Pull Requests

This GitHub Actions runs codespell over your code. Any warnings or errors will be annotated in the Pull Request.

Usage

uses: codespell-project/actions-codespell@master

Parameter: check_filenames

If set, check file names for spelling mistakes as well.

This parameter is optional; by default codespell will only check the file contents.

uses: codespell-project/actions-codespell@master
with:
  check_filenames: true

Parameter: check_hidden

If set, check hidden files (those starting with ".") for spelling mistakes as well.

This parameter is optional; by default codespell will not check hidden files.

uses: codespell-project/actions-codespell@master
with:
  check_hidden: true

Parameter: exclude_file

File with lines that should not be checked for spelling mistakes.

This parameter is optional; by default codespell will check all lines.

uses: codespell-project/actions-codespell@master
with:
  exclude_file: src/foo

Parameter: skip

Comma-separated list of files to skip (it accepts globs as well).

This parameter is optional; by default codespell won't skip any files.

uses: codespell-project/actions-codespell@master
with:
  skip: foo,bar

Parameter: builtin

Comma-separated list of builtin dictionaries to use.

This parameter is optional; by default codespell will use its default selection of built in dictionaries.

uses: codespell-project/actions-codespell@master
with:
  builtin: clear,rare

Parameter: ignore_words_file

File that contains words which will be ignored by codespell. File must contain one word per line. Words are case sensitive based on how they are written in the dictionary file.

This parameter is optional; by default codespell will check all words for typos.

uses: codespell-project/actions-codespell@master
with:
  ignore_words_file: .codespellignore

Parameter: ignore_words_list

Comma-separated list of words which will be ignored by codespell. Words are case sensitive based on how they are written in the dictionary file.

This parameter is optional; by default codespell will check all words for typos.

uses: codespell-project/actions-codespell@master
with:
  ignore_words_list: abandonned,ackward

Parameter: uri_ignore_words_list

Comma-separated list of words which will be ignored by codespell in URIs and emails only. Words are case sensitive based on how they are written in the dictionary file. If set to "*", all misspelling in URIs and emails will be ignored.

This parameter is optional; by default codespell will check all URIs and emails for typos.

uses: codespell-project/actions-codespell@master
with:
  uri_ignore_words_list: abandonned

Parameter: path

Indicates the path to run codespell in. This can be useful if your project has code you don't want to spell check for some reason.

This parameter is optional; by default codespell will run on your whole repository.

uses: codespell-project/actions-codespell@master
with:
  path: src

Parameter: only_warn

Only warn about problems. All errors and warnings are annotated in Pull Requests, but it will act like everything was fine anyway. (In other words, the exit code is always 0.)

This parameter is optional; setting this to any value will enable it.

uses: codespell-project/actions-codespell@master
with:
  only_warn: 1