yamlfixeryamlfixer automates the fixing of problems reported by yamllint by parsing its output.
Here'a screenshot of yamlfixer launched on yaml-test-suite :
The easiest way to install yamlfixer is from
pypi, as described
below.
python3 -m pip install yamlfixer-opt-nc
python -m pip install yamlfixer-opt-nc
pipx setupFor an optimal experience we recommand using pipx.
To install :
pipx install yamlfixer-opt-nc
pipx list
To upgrade :
pipx upgrade yamlfixer-opt-nc
To uninstall :
pipx uninstall yamlfixer-opt-nc
This software automatically fixes some errors and warnings reported by
yamllint.
usage: yamlfixer [-h] [-v] [-b] [-B BACKUPSUFFIX] [-d] [-D DIFF_FILE] [-e EXTENSIONS] [-f]
[-F] [-l] [-N] [-n] [-r LEVEL] [-j | -p | -s] [-t TABSIZE]
[-c CONFIG_FILE | -C CONFIG_DATA]
[FILE_or_DIR [FILE_or_DIR ...]]
Fix formatting problems in YAML documents. If no file is specified, then reads input from `stdin`.
positional arguments:
FILE_or_DIR the YAML files to fix. Use `-` to read from `stdin`.
optional arguments:
-h, --help show this help message and exit
-v, --version display this program's version number and exit.
-b, --backup make a backup copy of original files.
-B BACKUPSUFFIX, --backupsuffix BACKUPSUFFIX
sets the suffix for backup files, `.orig` is the default.
-d, --debug output debug information to stderr.
-D DIFF_FILE, --diffto DIFF_FILE
name of the file a unified diff will be written to.
Defaults to `/dev/null`.
-e EXTENSIONS, --ext EXTENSIONS
comma separated list of acceptable extensions when searching directories
for YAML files. Defaults to `yaml,yml,yamllint`.
-f, --forcecolors force colorized output even if stream is not a TTY.
-F, --followsymlinks follow symbolic links when recursing directories.
-l, --listfixers output the list of available fixers.
-N, --nosyntax don't try to fix syntax errors.
-n, --nochange don't modify anything.
-r LEVEL, --recurse LEVEL
sets the maximum recursion level for directories. Default is `0` meaning
no recursion, and any negative value means no limit.
-j, --jsonsummary output JSON summary to stderr.
-p, --plainsummary output plain text summary to stderr.
-s, --summary output colorized plain text summary to stderr. If stderr is not a TTY
output is identical to --plainsummary unless --forcecolors is also used.
-t TABSIZE, --tabsize TABSIZE
sets the number of spaces to replace tabs with, default is `2`.
-c CONFIG_FILE, --config-file CONFIG_FILE
path to yamllint's custom configuration file, none by default.
-C CONFIG_DATA, --config-data CONFIG_DATA
custom configuration for yamllint as YAML source, none by default.
yamlfixer launches yamllint on each specified filename, then parses
its output and tries to fix the reported problems. The special
filename - means stdin, and is assumed if there's no other
filename argument.
If input is read from stdin, the corrected output will be sent to
stdout.
Other files will be overwritten if needed. Original files, stdin
excepted, can be preserved as .orig if the --backup command line
option is used. You can specify any other backup filename suffix with
the --backupsuffix command line option.
Both summaries and diagnostic information are sent to stderr.
This command exits with status 2 if there are incompatible command
line options. It exits with -2 if yamllint is not available on your
system. Otherwise it exits with 0 if all input files either are
skipped, entirely fixed, or already successfully passed yamllint
strict mode before, else -1.
For convenience, all or parts of the command line arguments can be
read from a file, one per line, by using the well known @argsfile
syntax. For example you could do something like this :
$ find . -type f -name "*.yml" >list-of-yaml-files
$ yamlfixer --nochange --summary @list-of-yaml-files
Although this could probably be shortened to :
$ yamlfixer --nochange --summary --recurse -1 .
IMPORTANT: Not all problems are fixable by yamlfixer. Due to the
fact that yamllint doesn't currently report all faulty lines,
yamlfixer might even introduce indentation problems under some
circumstances.
⚠️Use at your own risk, you have been warned... ⚠️
You can find dedicated ressources on yamlfixer on :
You can now use this software as a GitHub Action, available from https://github.com/opt-nc/yamlfixer-action . This GitHub Action will automatically create Pull Requests to your repository with the changes made by yamlfixer.
yamlfixer currently (as of 0.9.11) can fix
the following problems as reported by yamllint :
'<document start>', but found '<stream end>' (syntax)<block end>, but found '<block mapping start>'<block end>, but found '<block sequence start>' (syntax)<block end>, but found '?'An always up-to-date list of fixers can be obtained with yamlfixer --listfixers.
☝️ Please read our TODO list to see which problems are still unsupported but which we plan to support some day.
IMPORTANT : fixing syntax errors is done on a best effort basis and
may work only partially or not at all for you. Use the -N|--nosyntax
command line switch do prevent yamlfixer from trying to fix syntax
errors.
Click on the white triangle in the image below to view a short video demonstration:
Find here a set of tips & tricks about how to achieve great things.
Don't find the usecase you're looking for ➡️ 🎫 Fill a dedicated issue so we could share your idea with the comunity
Most of us love short and efficient command lines. Here are some ready to use ones :
json summary through jqyamlfixer --jsonsummary examples/good.yml 2>&1 | jq
So you can get a nicely colorized (and validated json output) :
{
"filestofix": 1,
"passed": 1,
"modified": 0,
"fixed": 0,
"skipped": 0,
"notwritable": 0,
"unknown": 0,
"nochangemode": false,
"details": {
"examples/good.yml": {
"numericstatus": 0,
"status": "PASSED",
"issues": 0,
"handled": 0
}
}
}
yamlfixer could fix a yaml and get the exit codeSee how to produce a patch file without modifying the original one, and get the exit code so you can go further in automation :
$ yamlfixer --nochange --summary --diffto my.patch examples/bad.yml
Files to fix: 1
0 files were already correct before
0 files were modified but problems remain
1 files were entirely fixed
0 files were skipped
0 files were not writable
0 files with unknown status
FIXED examples/bad.yml (handled 4/4)
WARNING: No file was modified per user's request !
$ echo $?
0
$ cat my.patch
diff -u "examples/bad.yml" "examples/bad.yml-after"
--- "examples/bad.yml"
+++ "examples/bad.yml-after"
@@ -1,4 +1,4 @@
-
+---
name: Build HelloYaml
# yamllint disable-line rule:truthy
@@ -17,6 +17,4 @@
cache: 'maven'
- name: Build with Maven
- run: mvn package
-
-
+ run: mvn package
$
You can then manually apply the patch file to modify examples/bad.yml if
that's what you want to do :
$ patch -p0 <my.patch
patching file examples/bad.yml
$
But of course, it would have been simpler to not use the --nochange
command line option in the first place, so that the file would have
been fixed automatically.
ytt : "YAML templating tool that works on YAML structure (instead of text)."jq : "lightweight and flexible command-line JSON processor."vimdiff : "edit two, three or four versions of a file with Vim and show differences"icdiff : "improved colored diff "gomplate : "A flexible commandline tool for template rendering. Supports lots of local and remote datasources."yaml linting and fixingcli to community DEV.to blog post to better understand yamlfixer inception, historyand roadmapCopyright (C) 2021-2022 OPT-NC
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
You can contribute to this project by filing an issue or by sending a pull request
Please read our contributing guidelines before.
To contact the authors of this software, simply fill an issue on this project.
OPT-NC, aka Office des Postes et Télécommunications de Nouvelle-Calédonie, check
OPT-NC Github Organization page for more.
FAQs
automates the fixing of problems reported by yamllint
We found that yamlfixer-opt-nc demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.