cell span (colspan, table title) support

[ORESoftware]

Just looking for this simple feature in gajus/table

Looking for somewhere in this library's output to put "Suman Test Results"

Does this lib support a table title?

[gajus]

No, there is no way no way make a certain cell span multiple columns. As far as I remember, this feature is not implemented on purpose: It would add a considerable complexity to otherwise simple codebase.

[gajus]

There is nothing that would stop you from using the low-level API (see ./tests) to achieve the same result. Regardless, I would discourage such use as an unnecessary.

[gajus]

You can write a PR. I will consider to merge it. If the added complexity is within reason, I will merge it. Otherwise, I can support maintenance of a branch/ separate module that relies on the codebase or table and supports column spanning.

[ORESoftware]

Alrighty let me think about it!

[thom4parisot]

I guess it would have to imply some sampling if no column width defaults are provided.

table([
  ["Test Results"],
  ["Metric", "Value", "Notes"],
  ["Suite name", "@Test1", ""],
  // ...
]);

The main difficulty is to understand which columns are merged into which ones. Without hint provided by the user it is difficult to know :-(

Unless by providing symbols?

table([
  ["Test Results", ...table.merge.right(2)],
  ["Metric", "Value", "Notes"],
  ["Suite name", "@Test1", ""],
  // ...
]);

// -->

table([
  ["Test Results", @@TableMergeRight, @@TableMergeRight],
  ["Metric", "Value", "Notes"],
  ["Suite name", "@Test1", ""],
  // ...
]);

[nam-hle]

The feature has been included in v6.8.0