esc-pad-table-array

Tiny 1.7K function pads the cells of a 2D array of strings (table) by column, left/right aligned, optionally formatted, optional headings.

Install

npm install esc-pad-table-array

Example import and data

1import padTableA from 'esc-pad-table-array';
2const inputA = [
3  [ '192.168.1.4', 'apple.example.org' ],
4  [ '192.168.1.91', 'fig.example.org', 'fig.otherdomain.co.za' ],
5  [ '192.168.1.123', 'watermelon.example.org', 'watermelon.otherdomain.co.za' ],
6  [ '192.168.1.201', 'plum.example.org', 'plum.otherdomain.co.za' ],
7];

Simplest example

1console.log(padTableA(inputA));

Example with alignment

1console.log(padTableA(inputA, { alignA:[ 'L', 'R' ] }));
2console.log(padTableA(inputA, { align:'LR' }));          // terse alternative syntax

Example with alignment and formatting

npm install esc-colors

1import colors from 'esc-colors';

1console.log(padTableA(inputA, { align:'LR', fmtA:[ colors.magenta, colors.blue ] }));

Example with heading, alignment and formatting

1console.log(padTableA(inputA, { headingA:['LAN IP', 'HOSTNAME'], align:'LR', fmtA:[ colors.magenta, colors.blue ] }));

Example with heading (no underline), alignment and formatting

1console.log(padTableA(inputA, {
2  headingA: ['LAN IP', 'HOSTNAME'],
3  headingChar: null,
4  align: 'LR',
5  fmtA: [ colors.magenta, colors.blue ],
6}));

Example getting 2D array

You can get a 1D or 2D array and do whatever you want with it, trivially.

1const tableAA = padTableA(inputA, { align:'LR', colDelim:null, rowDelim:null, paddingChar:'.' });
2
3console.log('tableAA', tableAA);

1const rowsA = tableAA.map( colsA => '|..' + colsA.join('...') + '..|' );
2
3const width = rowsA[0].length;
4
5console.log('='.repeat(width));
6
7rowsA.forEach( rowS => console.log(rowS) );
8
9console.log('='.repeat(width));

Get the table data and you can flip it any style.

Example subheadings in your table

Rows with a single column are treated as subheadings, so they 'merge' the adjacent 'cells' and don't affect your other column widths.

If you have a row with a single data column and want it treated as a data row simply add another empty column next to it like [ 'MYDATA', '' ]

1const inputA = [
2  [ '# these are my fruity computers, make a nice smoothie' ],
3  [ '192.168.1.4', 'papaya.example.org' ],
4  [ '192.168.1.91', 'fig.example.org', 'fig.otherdomain.co.za' ],
5  [ '192.168.1.123', 'watermelon.example.org', 'watermelon.otherdomain.co.za' ],
6  [ '# cooked computers, serve hot' ],
7  [ '192.168.1.201', 'pizza.example.org', 'pizza.otherdomain.co.za' ],
8  [ '192.168.1.211', 'lasagna.example.org', 'lasagna.otherdomain.co.za' ],
9  [ '# drinks' ],
10  [ '192.168.1.214', 'mate.example.org', 'mate.otherdomain.co.za' ],
11];
12
13console.log(padTableA(inputA, {
14  headingA: ['LAN IP', 'HOSTNAME'],
15  align: 'LR',
16  indent: 2,
17  fmtA: [ colors.magenta, colors.blue ],
18  fmtSubF: colors.yellow,
19}));

1const whateverCharYouLike = '.';`
2// `paddingChar:whateverCharYouLike, trim:false` also works with subheadings:

Project goals

• No dependencies
• No nonsense
• Reliable, no radical changes will ever happen.
• Small, simple, easy to audit, yourself

If I have ideas for something different, I'll make a new package rather than make breaking changes.

Inspired by

I looked what else was available and it was massively bloated and over-complicated.

Notes

Have fun!

Say thanks

Star the repo https://github.com/softwarecreations/esc-pad-table-array

PR's or issues

Welcome

License

MIT