ValueError: Pipline step in unexpected format: {'pyspelling.filters.html': None, 'comments': False, 'ignores': ['code', 'pre']} about spellcheck-github-actions

[facelessuser]

@Sid-ah This is really an upstream PySpelling question. I imagine your issue is that you need to indent comments and ignores more.

The short of it is that YAML can be finicky about indentation in these cases. Options keys need to be nested under the filter name key, not at the same level as the filter name. It thinks you have a multi-key dictionary for your HTML filter. Not a dictionary of options nested dictionary under it specifying option names.

This is not what you want:

namekey:
optionkey: bad

This is what you want:

namekey:
  optionkey: good

Users will think they are disabling comments in your example, but they are not actually, so we identify this scenario and throw an error so the user is aware.

Try this which nests the options as a separate dictionary under the filter key.

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

[Sid-ah]

Thank you @facelessuser! Fixing the indentation did the trick for me.

[facelessuser]

No problem, glad I could help 🙂 .

[jonasbn]

Thanks @Sid-ah and @facelessuser

I have updated the documentation describing the remedy to avoid this issue, based on your input to this issue.