I would change the proposed usage by the following:

$io->table(['a', 'b', 'c'], [[1, 2, 3], [4, 5, 6]]);

$io->horizontalTable(['a', 'b', 'c'], [[1, 2, 3], [4, 5, 6]]);

$io->horizontalTable(['id', 'title', 'foo'], [[123, 'My title', 'bar']]);

The boolean param of table() is replace by a new method called horizontalTable(). The definitionList() method is replaced by horizontalTable() too because is the same.

What if I have an associative array with the "definition list" information? do this:

$io->horizontalTable(array_keys($foo), [array_values($foo)]);

The definitionList() method is replaced by horizontalTable() too because is the same.

Actually, it's way easier to write:

$io->definitonList(['title' =>  'value', 'title2' => 'value2', /** very long list */]);

than

$io->definitonList(['title', 'title2', /* very long list*/], [[1, 2, , /* very long list*/]]);

because you will be lost at some point. see this command for instance

What if I have an associative array with the "definition list" information? do this:

I did that as the first implementation. But it does not work well. See the test suite to understand what I want to achieve :)

What about

$output->definitionList(
    ['foo' => 'bar'],
    new TableSeparator(),
    'this is a title',
    new TableSeparator(),
    ['foo' => 'bar2']
);

It's already supported and tested. Did I miss something?

Did I miss something?

Yes, the variadic api :)

i see several advantages;

• duplicate key support (i.e. repetitive sections with the same keys)
• the expected argument types are clear, array (list), scalar (title) or TableSeparator. In favor of one magic structure

Oh, indeed I miss-read your example :)
This is a good idea, but it requires extra [``] :/

it's still less than the current no. of brackets used

in general i tend to avoid the mixed array structure. The 3rd advantage actually is it supports numeric/integer keys like any other, so less variance.

@ro0NL Actually, It will be the exact same number of brackets :)
Anyway, I will try to implement your proposal

@ro0NL I finished this PR. I hope you like it :)

Thank you @lyrixx.