Enable tables to carry a title

[yoshuawuyts]

A detailed description of the feature you would like to see added.

I was looking to implement bytecodealliance/wasm-tools#1923 using comfy-table to get a duf-like output, but it doesn't seem comfy-table is able to set titles. It would be neat if it could though.

Explain your usecase of the requested feature

When printing many tables in a row, being able to render a title adds some visual rhythm, making it easier to scan for the section you're looking for.

Alternatives

No response

Additional context

This is the output I'm trying to create:

┌──────────────────────────────────────┐                                            
│ component sample-wasi-http-rust      │                                            
├──────────┬────────────────┬──────────┤                                            
│ KIND     │ PRODUCER       │ VERSION  │                                            
├──────────┼────────────────┼──────────┤                                            
│ tool     │ wit-component  │ 0.216.0  │                                            
└──────────┴────────────────┴──────────┘                                            
┌──────────────────────────────────────────────────────────────────────────────────┐
│ module sample_wasi_http_rust.wasm                                                │
├──────────┬──────────────────┬────────────────────────────────────────────────────┤
│ KIND     │ PRODUCER         │ VERSION                                            │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ language │ Rust             │ -                                                  │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ language │ C11              │ -                                                  │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ tool     │ rustc            │ 1.82.0 (f6e511eec 2024-10-15)                      │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ tool     │ clang            │ 18.1.2-wasi-sdk                                    │
│          │                  │ (https://github.com/llvm/llvm-project              │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ tool     │ wit-component    │ 0.20.1                                             │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ tool     │ wit-bindgen-rust │ 0.20.1                                             │
├──────────┼──────────────────┼────────────────────────────────────────────────────┤
│ tool     │ wit-bindgen-c    │ 0.20.1                                             │
└──────────┴──────────────────┴────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────┐                            
│ module wit-component:adapter:wasi_snapshot_preview1: │                            
├──────────┬──────────┬────────────────────────────────┤                            
│ KIND     │ PRODUCER │ VERSION                        │                            
├──────────┼──────────┼────────────────────────────────┤                            
│ language │ Rust     │ -                              │                            
├──────────┼──────────┼────────────────────────────────┤                            
│ tool     │ rustc    │ 1.82.0 (f6e511eec 2024-10-15)  │                            
└──────────┴──────────┴────────────────────────────────┘                            
┌────────────────────────────────────┐                                              
│ module wit-component-shim          │                                              
├──────────┬───────────────┬─────────┤                                              
│ KIND     │ PRODUCER      │ VERSION │                                              
├──────────┼───────────────┼─────────┤                                              
│ language │ Rust          │ -       │                                              
├──────────┼───────────────┼─────────┤                                              
│ tool     │ wit-component │ 0.216.0 │                                              
└──────────┴───────────────┴─────────┘                                              
┌────────────────────────────────────┐                                              
│ module wit-component:fixups        │                                              
├──────────┬───────────────┬─────────┤                                              
│ KIND     │ PRODUCER      │ VERSION │                                              
├──────────┼───────────────┼─────────┤                                              
│ language │ Rust          │ -       │                                              
├──────────┼───────────────┼─────────┤                                              
│ tool     │ wit-component │ 0.216.0 │                                              
└──────────┴───────────────┴─────────┘                                              

[Nukesor]

I like that!

Should also be fairly easy to implement as the last step before the rendered table is returned :)

[Nukesor]

A few things must be done for this to be implemented properly:

• It must support alignment
• Padding?
• Same border display logic as the rest of the table
• Styling?

Most of this logic can probably be re-used from the formatting module, the current code will need a bit of refactoring though. It's very much entangled with ColumnDisplayInfo and Cell.

Should we re-use the Cell for this and let table.set_title(title: Cell) accept a cell?

[yoshuawuyts]

Yay, I'm glad you like it!

Should we re-use the Cell for this and let table.set_title(title: Cell) accept a cell?

That seems reasonable to me. It essentially is one big cell, so that doesn't seem like a bad starting point.

Padding?

This would be nice to have, yes. At least for my use case I don't think we will immediately need it, but I could see us using this.

[Nukesor]

If you got some spare time, feel free to start tackling this one :)

Otherwise I might get to it eventually (I hope :D), should be a fun task.

[yoshuawuyts]

I probably won't get around to taking a stab at this myself for a while, so please don't let me hold you back from implementing something fun ^^