Debugging YAML Parse Errors¶
In case something goes wrong and you get errors like this:
ValueError: YAML error found in file config/config.yaml. Line 22,Position 10: mapping values are not allowed here in "config/config.yaml", line 22, column 10
This means that the error might be at line 22, just before it or shortly after it. Sometimes it is tricky to tell whats wrong when one space is off. A good editor might help but it might be still hard to spot the exact point.
Install the extension¶
If you are struggling to find the problem you can reformat your file using
To do that you first need to install the
pip3 install ruamel.yaml.cmd==0.2
Make a backup¶
Before you continue: Make a backup of your machine config. Seriously, do it! Even better, use git and commit right now!
Reformatting YAML files¶
After that you can reformat single files using the
For example if you want to reformat
your_file.yaml first check the changes
it would make:
yaml round-trip your_file.yaml
If that looks alright perform them by adding the
yaml round-trip --save your_file.yaml
This will keep comments but reformat all your indents to two spaces per level. It should be easier now to spot the problem.
Reformat Your Config Using MPF format¶
mpf format on your config.
See Format And Lint Config Files for details.