Formatters list¶
List of formatters
To see list of all formatters currently implemented in robocop format run:
robocop list formatters
Formatters are sorted in the order they are run by default.
To see description of the transformer run:
robocop docs formatter_name
See configuring-formatters to learn how formatters can be configured (including disabling and enabling formatters).
Order of formatters
By default all formatters run in the same order. Whether called with:
robocop format
or:
robocop format --select ReplaceRunKeywordIf --select SplitTooLongLine
or:
robocop format --select SplitTooLongLine --select ReplaceRunKeywordIf
It will format files according to internal order (in this example ReplaceRunKeywordIf
is before
SplitTooLongLine
). To see order of the formatters run robocop list formatters
.
If you want to format files using different formatter order you need to run formatters separately:
robocop format --select SplitTooLongLine
robocop format --select ReplaceRunKeywordIf
You can also add --force-order
flag to use order provided in cli:
robocop format --force-order --select SplitTooLongLine --select ReplaceRunKeywordIf
External formatters are used last. If you want to change this behaviour (for example run your custom transformer
before default ones) you need to use --force-order
flag.
Pipe handling
Not all formatters can handle pipe syntax. If you encounter any issues with pipe separators, run
NormalizeSeparators
transformer to replace pipes with spaces.