rojopolis/spellcheck-github-actions

rojopolis profile

Latest recorded source activity: June 14, 2026 at 08:05

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 2

GitHub stars: 151
GitHub forks: 38

Repository README

Repository README source: README.md

Read the source README

Expand full README

# spellcheck-github-actions  ![Markdownlint Action][GHAMKDBADGE] ![Spellcheck Action][GHASPLLBADGE] [![Docker Pulls](https://img.shields.io/docker/pulls/jonasbn/github-action-spellcheck.svg?style=flat)](https://hub.docker.com/r/jonasbn/github-action-spellcheck/) A GitHub Action that spell checks Python, Markdown, and Text files. This action uses [PySpelling][pyspelling] to check spelling in source files in the designated repository. ## Table of Contents - [Features](#features) - [Configuration](#configuration) - [Using a Canonical Version](#using-a-canonical-version) - [Specifying Sources Files To Check](#specifying-sources-files-to-check) - [Examples](#examples) - [No spaces, quotes not required](#no-spaces-quotes-not-required) - [No spaces, quotes not required, double quotes used for complete parameter](#no-spaces-quotes-not-required-double-quotes-used-for-complete-parameter) - [No spaces, quotes not required, double quotes used for single parameters](#no-spaces-quotes-not-required-double-quotes-used-for-single-parameters) - [Spaces, quotes required, single quotes used](#spaces-quotes-required-single-quotes-used) - [Spaces, quotes required, double quotes used](#spaces-quotes-required-double-quotes-used) - [Spaces, quotes required, intermixed quotes, will not work](#spaces-quotes-required-intermixed-quotes-will-not-work) - [Specify a Specific Task To Run](#specify-a-specific-task-to-run) - [Specify a PySpelling Output Artifact](#specify-a-pyspelling-output-artifact) - [Extra Configuration](#extra-configuration) - [Extra Configuration for PySpelling](#extra-configuration-for-pyspelling) - [Extra Configuration for Markdown](#extra-configuration-for-markdown) - [Extra Configuration for Superfences](#extra-configuration-for-superfences) - [Spellcheck Configuration File](#spellcheck-configuration-file) - [Predefined Name](#predefined-name) - [Specifying Number of Jobs for Parallel Processing](#specifying-number-of-jobs-for-parallel-processing) - [Specifying Language and spellchecker](#specifying-language-and-spellchecker) - [Checking For Bad Spelling](#checking-for-bad-spelling) - [Language Support](#language-support) - [Configuring Action to Skip Custom Dictionary Compilation if Not Needed](#configuring-action-to-skip-custom-dictionary-compilation-if-not-needed) - [Tips](#tips) - [How to declutter your root directory from Spellcheck configuration files](#how-to-declutter-your-root-directory-from-spellcheck-configuration-files) - [Specify Code Not To Have Spelling Checked](#specify-code-not-to-have-spelling-checked) - [Getting Your Action Updated Automatically](#getting-your-action-updated-automatically) - [Slimming Your Wordlist By Ignoring Case](#slimming-your-wordlist-by-ignoring-case) - [Check only the changed files](#check-only-the-changed-files) - [Diagnostics](#diagnostics) - [Diagnostic text: `!!!Spelling check failed!!!`](#diagnostic-text-spelling-check-failed) - [Diagnostic text: `RuntimeError: None of the source targets from the configuration match any files:`](#diagnostic-text-runtimeerror-none-of-the-source-targets-from-the-configuration-match-any-files) - [Diagnostic text: `FileNotFoundError: [Errno 2] No such file or directory: '.wordlist.txt'`](#diagnostic-text-filenotfounderror-errno-2-no-such-file-or-directory-wordlisttxt) - [Diagnostic text: `ValueError: Unable to find or load pyspelling configuration from`](#diagnostic-text-valueerror-unable-to-find-or-load-pyspelling-configuration-from) - [Diagnostic text: `ERROR: *.md -- 'NoneType' object has no attribute 'end'`](#diagnostic-text-error-md----nonetype-object-has-no-attribute-end) - [Diagnostic text: `ValueError: Pipline step in unexpected format:`](#diagnostic-text-valueerror-pipline-step-in-unexpected-format) - [Diagnostic text: `re.error: global flags not at the start of the expression at position 1`](#diagnostic-text-reerror-global-flags-not-at-the-start-of-the-expression-at-position-1) - [DockerHub](#dockerhub) - [A note on DockerHub](#a-note-on-dockerhub) - [Development](#development) - [Resources and References](#resources-and-references) - [Author](#author) - [Acknowledgements](#acknowledgements) - [Copyright and License](#copyright-and-license) ## Features - Customizable configuration and spell checking using [PySpelling][pyspelling] - Support for the following formats (via [PySpelling](https://facelessuser.github.io/pyspelling/pipeline/)): - Markdown - Python - C++ - HTML - JavaScript - ODF - OOXML - CSS - XML - Plain text - Support for `aspell` and `hunspell`, Do see the section on Language Support for details - Support for the following languages: - English - French - German - Italian - Spanish - Russian - Ukrainian - Portuguese - Do see the section on Language Support for details - Per repository and format custom word list to avoid errors based on words not known to default dictionary, see: [PySpelling](https://facelessuser.github.io/pyspelling/configuration/) for more options - Flexible repository layout integration via file name matching using [Wildcard Match][wcmatch] - Support for Python's Markdown extensions, namely the [pymdown-extensions] via [PySpelling][pyspelling] ## Configuration 1. First you have to add a configuration for the spelling checker 1. Create a file named: `.spellcheck.yml` or `.spellcheck.yaml`, do note if both files exist the prior will have precedence. Do note the recommendation is _hidden_ files since these configuration files are not first rate citizens of your repository. You can also provide your own configuration file. Check out spellcheck configuration section down below. 1. Paste the contents of the outlined example, which is a configuration for Markdown, useful for your README file Do note that this action requires the contents of the repository, so it is recommended used with [the Checkout action][actioncheckout]. You have to define this part in your workflow, since it not a part of the action itself. Example: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 ``` This configuration file must be created in a the `.github/workflows/` directory. For example, it could be named `.github/workflows/spelling_action.yml` for easy identification, if other actions are present. ### Using a Canonical Version In the above example, the configuration is pointing to the exact version of `0.51.0`, this repository also offers the canonical version `v0`, so there is less hassle keeping the action up to date. ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@v0 ``` ## Specifying Sources Files To Check By default, this action will use the `sources:` list under each task in your config file to identify which files to scan. You can override this behaviour by setting `source_files` to the list of files or file patterns you want scanning. When this option is used, you must also specify the `task_name` to override the `sources:` list for. Do note that file paths containing spaces need to be quoted using either `'` (single quotes) or `"` (double quotes). The quoting has to be uniform and the two quoting styles can not be intermixed. ### Examples Parts are lifted from issue [#84](https://github.com/rojopolis/spellcheck-github-actions/issues/84) #### No spaces, quotes not required ```yaml source_files: README.md CHANGELOG.md notes/Notes.md ``` #### No spaces, quotes not required, double quotes used for complete parameter ```yaml source_files: "README.md CHANGELOG.md notes/Notes.md" ``` This might actually work, but it is not recommended and might it might break, instead using proper quoting. #### No spaces, quotes not required, double quotes used for single parameters ```yaml source_files: "README.md" "CHANGELOG.md" "notes/Notes.md" ``` This would also work using single quotes #### Spaces, quotes required, single quotes used ```yaml source_files: 'Managed Services/Security Monitor/README.md' 'Terraform/Development Guide/README.md' ``` #### Spaces, quotes required, double quotes used ```yaml source_files: "Managed Services/Security Monitor/README.md" "Terraform/Development Guide/README.md" ``` #### Spaces, quotes required, intermixed quotes, will not work ```yaml source_files: README.md CHANGELOG.md notes/Notes.md ``` ## Specify a Specific Task To Run By default, all tasks in your config file will be run. By setting `task_name` you can override this and run only the task you require. A configuration for designated source files could look as follows. Example: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: source_files: README.md CHANGELOG.md notes/Notes.md task_name: Markdown ``` ## Specify a PySpelling Output Artifact In order to make it easier to process larger amount of output. The action allows for the user to enable the generation of an artifact. The optional `output_file` input parameter, if specified, defines the name of the generated file containing the spellcheck output. Such file can then be stored as workflow artifact using the `actions/upload-artifact` step. A configuration for emitting an output artifact could look as follows. Example: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: source_files: README.md CHANGELOG.md notes/Notes.md task_name: Markdown output_file: spellcheck-output.txt - name: Archive spellcheck output uses: actions/upload-artifact@v3 if: '!cancelled()' # Do not upload artifact if job was cancelled with: name: Spellcheck Output path: spellcheck-output.txt ``` The artifact can be downloaded via the GitHub UI or via the GitHub API. The artifact is named: `Spellcheck Outout`, based on the name specified in the above example and the file is named: `spellcheck-output.txt`, based on the name specified in the above example, it comes zipped. Do see the [official documentation](https://docs.github.com/en/rest/actions/artifacts#about-the-artifacts-api) for handling artifacts via the API. The reason why `if: '!cancelled()'` is that the default behavior of GitHub Actions is to fail and stop processing. That would mean the proper state is displayed, but the artefact with the output is not available, this sort of beats the purpose. Artifacts are by default available for 3 months. ### Extra Configuration #### Extra Configuration for PySpelling Do check the [PySpelling documentation][pyspelling] for elaborate details on configuration of [PySpelling][pyspelling]. #### Extra Configuration for Markdown [PySpelling][pyspelling] uses the [Python Markdown][markdown] project. [PySpelling][pyspelling] allows for configuration of the Markdown handling using the [pymdown-extensions] authored by the author of [PySpelling][pyspelling]. If for example wanted to use the `superfences` extension, you could configure it as follows: ```yaml - pyspelling.filters.markdown: markdown_extensions: - pymdownx.superfences: ``` Current Spellcheck Action support the following extensions (_in alphabetical order_): - Arithmatex - B64 - BetterEm - Caret - Critic - Details - Emoji - EscapeAll - Extra - Highlight - InlineHilite - Keys - MagicLink - Mark - PathConverter - ProgressBar - SaneHeaders - SmartSymbols - Snippets - StripHTML - SuperFences - Tabbed - Tasklist - Tilde Please consult [the documentation][pymdown-extensions] for the extensions for more details. Currently only the case of use of `superfences` has been requested as outlined in the above example. Do also see the Diagnostics sections below, demonstrating diagnostics emitted from [Python Markdown][markdown], which might require the use of an extension. ##### Extra Configuration for Superfences Some static site generators like Vitepress or Docusaurus use the code fence line for extra information, for example line highlighting or code block headlines. Superfencing would break here and spelling would be checked in the specific code section. To avoid this you can set the `relaxed_headers` option to `true`. ```yaml - pyspelling.filters.markdown: markdown_extensions: - pymdownx.superfences: relaxed_headers: true ``` ## Spellcheck Configuration File You can either provide a path to the configuration file or save a file in the root of your repository with a predefined name (list below). If `config_path` is provided then it will be used and the other configuration options will be ignored. If `config_path` is not provided then the repository is searched after a first match Example: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: config_path: config/.spellcheck.yml # put path to configuration file here source_files: source/scanning.md source/triggers.md task_name: Markdown ``` ### Predefined Name 1. `.spellcheck.yml` 1. `.spellcheck.yaml` 1. `spellcheck.yml` 1. `spellcheck.yaml` (the old default) 1. `.pyspelling.yaml` (PySpelling default) 1. `.pyspelling.yml` (PySpelling default) And is attempted read in that order, meaning first match is used, This means that you can use files prefixed with the `.` to have a less intrusive Spellcheck configuration in your repository. ```yaml matrix: - name: Markdown aspell: lang: en dictionary: encoding: utf-8 pipeline: - pyspelling.filters.markdown: - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` The above configuration will check the spelling of your repository's `README.md` and other Markdown files against an English dictionary. If your Markdown is named differently, correct or add additional patterns under `sources`, Markdown is sometimes named `.mkdn`. When and if the run locates spelling errors, you have two options: 1. Correct the spelling errors in the relevant files 2. Add the relevant words to a custom word list, to be ignored If you do the latter, you have to add the following to the Spellcheck configuration, under `dictionary`: ```yaml wordlists: - .wordlist.txt ``` This supplies a custom list of words to supply the default dictionary for the specified language, in this case set to English `en` under `aspell`. The complete configuration should resemble this: ```yaml matrix: - name: Markdown aspell: lang: en dictionary: wordlists: - .wordlist.txt encoding: utf-8 pipeline: - pyspelling.filters.markdown: - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` Change the configuration to suit your repository and needs, please see the `examples/` directory for more example configurations. ## Specifying Number of Jobs for Parallel Processing This action supports parallel processing of the configured tasks, this is done using the `jobs` parameter. Introduced in version 4.10 of **PySpelling**. The default value is `1`, which means that the action will run in a single job. ```yaml jobs: 4 ``` Full example: ```yaml jobs: 4 matrix: - name: Markdown aspell: lang: en dictionary: wordlists: - .wordlist.txt encoding: utf-8 pipeline: - pyspelling.filters.markdown: - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` ## Specifying Language and spellchecker This action supports: - `aspell` - `hunspell` Please see the section on Language Support below for more details. In the section for `aspell` you can specify the main language, for example `en`, via the `lang` parameter. You can further specify dialect, using the `d` parameter. See the documentation for [PySpelling](https://facelessuser.github.io/pyspelling/configuration/#spell-checker-options) for more details. The action can be specified to use `hunspell` instead of `aspell` by setting the `spellchecker` parameter to `hunspell`. ```yaml - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: task_name: Markdown spell_checker: hunspell ``` Do remember to configure `hunspell` in the PySpelling configuration file as well as Hunspell has no default language, so you have to specify the language. ```yaml hunspell: d: en_US ``` ## Checking For Bad Spelling The GitHub Action helps you make sure _most_ spelling errors do not make it into your repository. You can however check your spelling prior to committing and pushing to your repository. This simply uses the contents of our spelling toolchain: ```bash $ pyspelling -c .spellcheck.yml Misspelled words: ... !!!Spelling check failed!!! ``` We can correct the error(s) pointed out by [PySpelling][pyspelling] as we go by adding _new_ words to our local file: `.wordlist.txt` And at some point we get: ```bash $ pyspelling -c .spellcheck.yml Spelling check passed :) ``` Now we should be good to go. Do note you could also use the `entrypoint.sh`, which is the script used in the Docker image. ```bash ± sh entrypoint.sh Using pyspelling on repository files outlined in .spellcheck.yml ---------------------------------------------------------------- Spelling check passed :) ``` ## Language Support Currently only the following languages are supported via [GNU Aspell][aspell]: - English via the [`aspell-en` Debian package][aspell-en], supporting: - American (`en_US`), - British (`en_GB`), - Australian (`en_AU`) - and Canadian (`en_CA`) - German via the [`aspell-de` Debian package][aspell-de], supporting: - Austrian (`de_AT`) - German (`de_DE`), - Swiss (`de_CH`) - Italian (`it_IT`), via the [`aspell-it` Debian package][aspell-it] - Russian via the [`aspell-ru` Debian package][aspell-ru] - Spanish via the [`aspell-es` Debian package][aspell-es] - Ukrainian via the [`aspell-uk` Debian package][aspell-uk] - Portuguese supporting: - Portugal (`pt_PT`, via [`aspell-pt` Debian package][aspell-pt-pt]) - Brazilian Portuguese (`pt_BR`, via [`aspell-pt-br` Debian package][aspell-pt-br]) Currently only the following languages are supported via [Hunspell][hunspell]: - English, supporting: - American (`en_US`, via [`hunspell-en-us` Debian package][hunspell-en-us]), - Australian (`en_AU`, via [`hunspell-en-au` Debian package][hunspell-en-au]) - British (`en_GB`, via [`hunspell-en-gb` Debian package][hunspell-en-gb]), - and Canadian (`en_CA`, via [`hunspell-en-ca` Debian package][hunspell-en-ca]) - French via the [`hunspell-fr` Debian package][hunspell-fr] - German, supporting: - Austrian (`de_AT`, via [`hunspell-de-at` Debian package][hunspell-de-at]) - German (`de_DE`, via [`hunspell-de-de` Debian package][hunspell-de-de]), - Swiss (`de_CH`, via [`hunspell-de-ch` Debian package][hunspell-de-ch]) - Italian via the [`hunspell-it` Debian package][hunspell-it] - Russian via the [`hunspell-ru` Debian package][hunspell-ru] - Spanish via the [`hunspell-es` Debian package][hunspell-es] - Ukrainian via the [`hunspell-uk` Debian package][hunspell-uk] - Portuguese supporting: - Portuguese (`pt_PT`, via [`hunspell-pt-pt` Debian package][hunspell-pt-pt]) - Brazilian Portuguese (`pt_BR`, via [`hunspell-pt-br` Debian package][hunspell-pt-br]) Additional languages can be added by request, please open an issue. ## Configuring Action to Skip Custom Dictionary Compilation if Not Needed If you want to skip the compilation of the custom dictionary, you can set the `skip_dict_compile` input to `true` in your action configuration: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: config_path: .github/spellcheck.yml skip_dict_compile: true # <--- set to true to skip custom dictionary compilation ``` This can be useful if you have a large custom dictionary that does not change often, as it can save time during the action run. The feature was added in version `0.54.0` of the action and it can be disabled by setting the input to `false` or omitting it altogether. The default value is `false`. ## Tips ### How to declutter your root directory from Spellcheck configuration files If you think that the GitHub Spellcheck Action is cluttering the root directory of you project, you can move the configuration files to a subdirectory. 1. In the action configuration (`.github/workflows/<your action configuration of the spellcheck action>`) you add the `config_path` parameter and specify where you want you have put you spellcheck configuration file 2. In the spellcheck configuration file (mentioned above), you can specify the `wordlist` parameter to point to a designated path Moving both files to `.github` could look at follows: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 with: config_path: .github/spellcheck.yml # <--- put path to configuration file here ``` ```yaml matrix: - name: Markdown aspell: lang: en dictionary: wordlists: - .github/wordlist.txt # <-- put path to custom dictionary file here encoding: utf-8 pipeline: - pyspelling.filters.markdown: - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` ### Specify Code Not To Have Spelling Checked Since this action checks all available text, you might run into problems with section of code examples etc. This can be circumvented by the following configuration: ```yaml ignores: - code - pre ``` This works on the intermediate HTML form of the data. A complete configuration could look as follows: ```yaml matrix: - name: Markdown aspell: lang: en dictionary: wordlists: - .wordlist.txt encoding: utf-8 pipeline: - pyspelling.filters.markdown: - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` And `code` and `pre` sections are ignored by the spelling check. Code fences in Markdown require additional configuration using the Markdown extension: `pymdownx.superfences`: ```yaml - pyspelling.filters.markdown: markdown_extensions: - pymdownx.superfences: ``` A complete example could look as follows: ```yaml matrix: - name: Markdown aspell: lang: en dictionary: wordlists: - .wordlist.txt encoding: utf-8 pipeline: - pyspelling.filters.markdown: markdown_extensions: - pymdownx.superfences - pyspelling.filters.html: comments: false ignores: - code - pre sources: - '**/*.md' default_encoding: utf-8 ``` ### Getting Your Action Updated Automatically The _awesome_ tool dependabot lets you scan your used GitHub Marketplace Actions and lets you know if they are in need of an update. The update is proposed via a pull request, which can be accepted or declined, it will itself take care of deleting pull requests if these become irrelevant. You specify the configuration in the file: `.github/dependabot.yml` in your repository using this action - actually it scans all your actions. ```yaml # Basic dependabot.yml file # REF: https://docs.github.com/en/code-security/supply-chain-security/keeping-your-actions-up-to-date-with-dependabot version: 2 updates: # Enable version updates for Actions - package-ecosystem: "github-actions" # Look for `.github/workflows` in the `root` directory directory: "/" # Check for updates once a week schedule: interval: "weekly" ``` ### Slimming Your Wordlist By Ignoring Case This tip works for `aspell`. You can slim down your `.wordlist.txt` file if you have case variations of entries of words. ```yaml aspell: ignore-case: true ``` To convert you existing `.wordlist.txt` you could do something along the lines of this using Bash version 4. ```bash $ tr '[:upper:]' '[:lower:]' < .wordlist.txt > temp-wordlist.txt $ cat temp-wordlist.txt | sort -u > .wordlist.txt $ rm temp-wordlist.txt ``` And you should be good to go. ### Check only the changed files The marvellous GitHub Action: [tj-actions/changed-files](https://github.com/tj-actions/changed-files) can be used to check only the files changed in a pull request. Your workflow could look something like this: ```yaml - name: Get all changed markdown files uses: tj-actions/changed-files@v45 id: changed_files with: files: | **.md - name: Run Spellcheck id: spellcheck uses: rojopolis/spellcheck-github-actions@v0 with: task_name: Markdown source_files: ${{ steps.changed_files.outputs.all_changed_files }} ``` Lifted from: [jonasbn/TIL](https://github.com/jonasbn/til/blob/master/.github/workflows/spellcheck.yml). This can be very use for very large repositories, where you only want to check the files changed in a pull request, so you can focus on the changes and do not have to wait so long for the action to complete. ## Diagnostics This is a list of common diagnostics, which can be emitted by the action and it's tools. ### Diagnostic text: `!!!Spelling check failed!!!` This indicates that a spelling check has been completed, but spelling errors were located and should be corrected. 1. Either correct pinpointed spelling errors 1. Or add pinpointed words to custom dictionary Please see the section: "Checking For Bad Spelling" above. ### Diagnostic text: `RuntimeError: None of the source targets from the configuration match any files:` This diagnostic indicates that files outlines by the `source` wildcard pattern match did not match any files. 1. Either adjust the pattern 1. Or remove the configuration part since it does not match the repository contents 1. Or set `expect_match` to `false` ```yaml matrix: - name: markdown pipeline: - pyspelling.filters.text sources: - '**/*.md' expect_match: false default_encoding: utf-8 ``` Please see the documentation for [Wildcard Match][wcmatch] (1 and 2) or [Expect Match][expectmatch]. ### Diagnostic text: `FileNotFoundError: [Errno 2] No such file or directory: '.wordlist.txt'` This diagnostic indicates that a custom word list has been specified in the used configuration, `.spellcheck.yml`, but the file does not exist. 1. Create the empty file ```bash $ touch .wordlist.txt ``` Please see the section: "Configuration" above. ### Diagnostic text: `ValueError: Unable to find or load pyspelling configuration from` This diagnostic indicates that the configuration file pointed to with the `--config` (`-c`) parameter cannot be located. 1. Check that a file with the indicated name exists. `ValueError: Unable to find or load pyspelling configuration from spellcheck.yaml` Indicates: `spellcheck.yaml` so this file should exist in the repository. If the file is available in the repository, please check that your workflow is configured correctly, with the following line, which enables [the action: checkout][actioncheckout]. `uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3` In full context: ```yaml name: Spellcheck Action on: push permissions: contents: read jobs: build: name: Spellcheck runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: persist-credentials: false - name: Spellcheck uses: rojopolis/spellcheck-github-actions@0.68.0 ``` This step adds an action, which checkout out the repository for inspection by linters and other actions like this one. ### Diagnostic text: `ERROR: *.md -- 'NoneType' object has no attribute 'end'` This indicates issues with the Markdown and is reported by `Markdown` (See: [PyPi site](https://pypi.org/project/Markdown/)). [PySpelling][pyspelling] does however support extension of the standard Markdown parser and you can specify the use of extensions of these are support. This action support the extensions included in: `pymdown-extensions` (See: [PyPi site][pymdown-extensions]) And you can then put these to use in your configuration. The example below outlines the `superfences` extension. ```yaml - pyspelling.filters.markdown: markdown_extensions: - pymdownx.superfences: ``` Please see the repository's `requirements.txt` for a list of all included Python modules and their exact versions. ### Diagnostic text: `ValueError: Pipline step in unexpected format:` This error emitted from [PySpelling][pyspelling] indicates issues with the configuration file. Please see the section: "Configuration" above. With the update of [PySpelling](https://pypi.org/project/pyspelling/) from 2.6.1 to 2.7.3 with release 0.16.0 (0.15.0, do see the change log). This error would be emitted from the GitHub Action, if the configuration was not properly formatted. The Markdown example's earlier revisions in this repository would demonstrate the error. To address the error, the options below the filter should be properly indented. ```yaml - pyspelling.filters.html: comments: false ignores: - code - pre ``` Should be indented to: ```yaml - pyspelling.filters.html: comments: false ignores: - code - pre ``` The complete error emitted could would look something along the lines of: ```text Traceback (most recent call last): File "/usr/local/bin/pyspelling", line 8, in <module> sys.exit(main()) File "/usr/local/lib/python3.9/site-packages/pyspelling/__main__.py", line 30, in main return run( File "/usr/local/lib/python3.9/site-packages/pyspelling/__main__.py", line 55, in run for results in spellcheck( File "/usr/local/lib/python3.9/site-packages/pyspelling/__init__.py", line 673, in spellcheck for result in spellchecker.run_task(task, source_patterns=sources): File "/usr/local/lib/python3.9/site-packages/pyspelling/__init__.py", line 311, in run_task self._build_pipeline(task) File "/usr/local/lib/python3.9/site-packages/pyspelling/__init__.py", line 255, in _build_pipeline raise ValueError(STEP_ERROR.format(str(step))) ValueError: Pipline step in unexpected format: {'pyspelling.filters.html': None, 'comments': False, 'ignores': ['code', 'pre']} ``` Example lifted from issue [#60](https://github.com/rojopolis/spellcheck-github-actions/issues/60) ### Diagnostic text: `re.error: global flags not at the start of the expression at position 1` This error is emitted from [PySpelling][pyspelling] and indicate an issue with interpreting the configuration file. From version [0.29.0](https://github.com/rojopolis/spellcheck-github-actions/releases/tag/0.29.0) the action is using Python 3.11 and since [Python 3.11](https://docs.python.org/3/whatsnew/3.11.html#porting-to-python-3-11) the regular expression engine `(?i)` can now only be used at the start of regular expression not elsewhere. If you specify `delimiters` in the configuration file and use the `(?i)` flag, you will get this error, if used in the deprecated manner. Thanks to @lasic for reporting and resolving the issue [#189](https://github.com/rojopolis/spellcheck-github-actions/issues/189). ## DockerHub This action is based on a Docker image available on DockerHub. This mean that if you developing your own spell checking action you can use this image. Alternatively you can build your own Docker image based on the `Dockerfile` in this repository. - [DockerHub: jonasbn/github-action-spellcheck](https://hub.docker.com/r/jonasbn/github-action-spellcheck) ### A note on DockerHub The images are build from the GitHub repository master branch. The recommended use is to use the latest release with a version tag. See [the release history](https://github.com/rojopolis/spellcheck-github-actions/releases) for details. Whereas the tag `latest` just reflect the latest build based on the master branch. The master branch might contain changes not tagged as released yet and can be regarded as _unstable_ or _experimental_. Changes such as corrections to documentation etc. will not be tagged until separately as a general rule, unless the changes are significant, but the aim is to keep the documentation relevant and up to date. ## Development The GitHub Action is based on a Docker implementation. The `Dockerfile` contains the image building and the `entrypoint.sh`, which acts as `ENTRYPOINT` for the Docker image describes the execution part. You can test the action locally by building the Docker image and running it against your project/repository. First you have to build it. Download or fork [the spellcheck action repository](https://github.com/rojopolis/spellcheck-github-actions). Unpack or clone the source code and build the Docker image. ```bash $ docker build -t github-action-spellcheck . ``` Run the newly build Docker image. Do note the project/repository has to contain a configuration, please see the section on configuration above: ```bash $ cd <your project/repository directory> $ docker run -it -v $PWD:/tmp github-action-spellcheck ``` ## Resources and References - [GNU Aspell][aspell] - [Hunspell][hunspell] - [PySpelling][pyspelling] ## Author The original author of this GitHub Action is Robert Jordan (@rojopolis) ## Acknowledgements Here follows a list of contributors in alphabetical order: - @aSemy - Albert Volkman, @albertvolkman - Andreas Kohout, @akohout-hai - Byron Miller, @supernovae - Isaac Muse, @facelessuser - Jonas Brømsø, @jonasbn - José Eduardo Montenegro Cavalcanti de Oliveira, @edumco - @Lasica - Matt Calvert, @miff2000 - Matthew Macdonald-Wallace, @proffalken - Michael Flaxman, @mflaxman - Micha Hobert, @Isengo1989 - Mike Starov, @xsaero00 - Nicolas Lhomme, @nlhomme - Pavel Skipenes, @pavelskipenes - Peter Petrik, @PeterPetrik - Riccardo Porreca, @riccardoporreca - Stefan Oderbolz @metaodi - Stephen Bates, @sbates130272 Do you want to be left out, or feel left out of this list or have a different representation of your name, please submit a pull request or raise an issue ## Copyright and License This repository is licensed under the MIT license. [pyspelling]: https://facelessuser.github.io/pyspelling/ [wcmatch]: https://facelessuser.github.io/wcmatch/glob/ [actioncheckout]: https://github.com/marketplace/actions/checkout [markdown]: https://pypi.org/project/Markdown/ [pymdown-extensions]: https://pypi.org/project/pymdown-extensions/ [hunspell]: http://hunspell.github.io/ [aspell]: http://aspell.net/ [aspell-de]: https://packages.debian.org/trixie/aspell-de [aspell-en]: https://packages.debian.org/trixie/aspell-en [aspell-es]: https://packages.debian.org/trixie/aspell-es [aspell-ru]: https://packages.debian.org/trixie/aspell-ru [aspell-uk]: https://packages.debian.org/trixie/aspell-uk [aspell-it]: https://packages.debian.org/trixie/aspell-it [aspell-pt-pt]: https://packages.debian.org/trixie/aspell-pt-pt [aspell-pt-br]: https://packages.debian.org/trixie/aspell-pt-br [GHAMKDBADGE]: https://github.com/rojopolis/spellcheck-github-actions/workflows/Markdownlint%20Action/badge.svg [GHASPLLBADGE]: https://github.com/rojopolis/spellcheck-github-actions/workflows/Spellcheck%20Action/badge.svg [expectmatch]: https://facelessuser.github.io/pyspelling/configuration/#expect-match [hunspell-en-au]: https://packages.debian.org/trixie/hunspell-en-au [hunspell-en-ca]: https://packages.debian.org/trixie/hunspell-en-ca [hunspell-en-gb]: https://packages.debian.org/trixie/hunspell-en-gb [hunspell-en-us]: https://packages.debian.org/trixie/hunspell-en-us [hunspell-de-at]: https://packages.debian.org/trixie/hunspell-de-at [hunspell-de-ch]: https://packages.debian.org/trixie/hunspell-de-ch [hunspell-de-de]: https://packages.debian.org/trixie/hunspell-de-de [hunspell-es]: https://packages.debian.org/trixie/hunspell-es [hunspell-fr]: https://packages.debian.org/trixie/hunspell-fr [hunspell-ru]: https://packages.debian.org/trixie/hunspell-ru [hunspell-uk]: https://packages.debian.org/trixie/hunspell-uk [hunspell-it]: https://packages.debian.org/trixie/hunspell-it [hunspell-pt-pt]: https://packages.debian.org/trixie/hunspell-pt-pt [hunspell-pt-br]: https://packages.debian.org/trixie/hunspell-pt-br

Loading the repository README…

Skills in this repository

Software Developers

1 occupation categories · 100% classified

skill

occupation

description

updated

release-prep

Software Developers

Prepare a new release - bump action.yml image version, verify CHANGELOG entry and stage changes

2026-06-14

docker-test

Software Developers

Build the Docker image as :local and run the full Bats test suite

2026-05-21

Showing 2 of 2 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/rojopolis/spellcheck-github-actions.