Transformers#
List of transformers
To see list of all transformers currently implemented in robotidy run:
robotidy --list
Transformers are sorted in the order they are run by default. To see description of the transformer run:
robotidy --desc TRANSFORMER_NAME
See Configuring Transformers to learn how transformers can be configured (including disabling and enabling transformers).
Order of transformers
By default all transformers run in the same order. Whether called with:
robotidy src
or:
robotidy --transform ReplaceRunKeywordIf --transform SplitTooLongLine src
or:
robotidy --transform SplitTooLongLine --transform ReplaceRunKeywordIf src
It will transform files according to internal order (in this example ReplaceRunKeywordIf
is before
SplitTooLongLine
). To see order of the transformers run robotidy --list
.
If you want to transform files using different transformer order you need to run transformers separately:
robotidy --transform SplitTooLongLine src
robotidy --transform ReplaceRunKeywordIf src
You can also add --force-order
flag to use order provided in cli:
robotidy --force-order --transform SplitTooLongLine --transform ReplaceRunKeywordIf src
External transformers 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 transformers can handle pipe syntax. If you encounter any issues with pipe separators, run
NormalizeSeparators
transformer to replace pipes with spaces.