AlignTemplatedTestCases

Align templated Test Cases to columns.

For non-templated test cases use AlignTestCasesSection transformer.

Enabling the transformer

AlignTestCases is not included in default transformers, that’s why you need to call it with --transform explicitly:

robotidy --transform AlignTestCases src

Or configure enabled parameter:

robotidy --configure AlignTestCases:enabled=True

Examples:

Before

*** Settings ***
Test Template    Templated Keyword

*** Test Cases ***    baz    qux
# some comment
test1    hi    hello
test2 long test name    asdfasdf    asdsdfgsdfg

After

*** Settings ***
Test Template    Templated Keyword

*** Test Cases ***      baz         qux
# some comment
test1                   hi          hello
test2 long test name    asdfasdf    asdsdfgsdfg
                        bar1        bar2

Before

*** Settings ***
Test Template    Dummy

*** Test Cases ***
Test1    ARG1
    [Tags]    sanity
    [Documentation]  Validate Test1
Test2    ARG2
    [Tags]    smoke
    [Documentation]  Validate Test2

After

*** Settings ***
Test Template    Dummy

*** Test Cases ***
Test1     ARG1
          [Tags]              sanity
          [Documentation]     Validate Test1
Test2     ARG2
          [Tags]              smoke
          [Documentation]     Validate Test2

Align only test case section with named headers

If you don’t want to align test case section that does not contain header names then configure only_with_headers parameter:

robotidy -c AlignTemplatedTestCases:only_with_hedaers=True <src>

Fixed width of column

It’s possible to set fixed minimal width of column. To configure it use min_width parameter:

robotidy --configure AlignTemplatedTestCases:min_width=30 src

This configuration respects up_to_column parameter.

Before

*** Test Cases ***    baz    qux
# some comment
test1    hi    hello
test2 long test name    asdfasdf    asdsdfgsdfg
    bar1  bar2

After

*** Test Cases ***            baz                           qux
# some comment
test1                         hi                            hello
test2 long test name          asdfasdf                      asdsdfgsdfg
                              bar1                          bar2