Skip to content

Latest commit

 

History

History
59 lines (47 loc) · 1.85 KB

github-action.md

File metadata and controls

59 lines (47 loc) · 1.85 KB

GitHub Action

If you want an easy way to test your repository spelling (or a subset of files) you can use the Typos Action! It is served from this repository, and can easily be used as follows:

name: Test GitHub Action
on: [pull_request]

jobs:
  run:
    name: Spell Check with Typos
    runs-on: ubuntu-latest
    steps:
    - name: Checkout Actions Repository
      uses: actions/checkout@v4

    - name: Check spelling of file.txt
      uses: crate-ci/typos@master
      with:
        files: ./file.txt

    - name: Use custom config file
      uses: crate-ci/typos@master
      with:
        files: ./file.txt
        config: ./myconfig.toml

    - name: Ignore implicit configuration file
      uses: crate-ci/typos@master
      with:
        files: ./file.txt
        isolated: true

    - name: Writes changes in the local checkout
      uses: crate-ci/typos@master
      with:
        write_changes: true

Important for any of the examples above, make sure that you choose a release or commit as a version, and not a branch (which is a moving target).

Also make sure when referencing relative file paths to use ./ (e.g., ./file.txt instead of file.txt.

write_changes doesn't commit or push anything to the branch. It only writes the changes locally to disk, and this can be combined with other actions, for instance that will submit code suggestions based on that local diff.

Variables

Name Description Required Default
files Files or patterns to check false If not defined, the default set of files are checked
isolated Ignore implicit configuration files false false
config Use a custom config file (must exist) false not set
write_changes Writes changes on the Action's local checkout false false