Tabletip - a tool for creating ascii tables

You will need this if you need to quickly create a table similar to this one:

1#   0   1   2   3   4   5
20 | _ | _ | _ | _ | _ | _ |
31 | _ | _ | _ | _ | _ | _ |
42 | _ | _ | _ | _ | _ | _ |
53 | _ | _ | _ | _ | _ | _ |
64 | _ | _ | _ | _ | _ | _ |
75 | _ | _ | _ | _ | _ | _ |

or this

1|  1 |  2 |  3 |  4 |  5 |  6 |
2|  5 |  6 |  7 |  8 |  9 | 10 |
3|  9 | 10 | 11 | 12 | 13 | 14 |
4| 13 | 14 | 15 | 16 | 17 | 18 |
5| 17 | 18 | 19 | 20 | 21 | 22 |
6| 21 | 22 | 23 | 24 | 25 | 26 |

or this

1#      2      3      4      5      6      7      8      9     10
22 |    4 |    8 |   16 |   32 |   64 |  128 |  256 |  512 | 1024 |

Installation

npm i tabletip

or just run it with

npx tabletip

CLI usage

1Usage: tabletip <rows> <cols> [OPTIONS]...
2
3Arguments:
4  rows                       table height (required)
5  cols                       table width (required)
6
7Options:
8  -v, --version              output the version number
9  -i, --inclideHeaders       include table headers (default: false)
10  -f, --fill <char>          fill with symbol (defalut is "0") (default: "0")
11  -c, --copy                 copy output to clipboard (only MacOS) (default: false)
12  -t, --tabulation           remove tabulation (make ugly) output (default: false)
13  -s, --startFrom <number>   start table rows & cols from (default: 0)
14  --startRows <number>       start table rows from
15  --startCols <number>       start table cols from
16  -e, --expression <string>  use javascript expression to fill a table
17  -d, --delimeter <char>     change delimeter (default: "|")
18  -h, --help                 display help for command

Example:

npx tabletip 2 2

will print

1| 0 | 0 |
2| 0 | 0 |

Options

-c - copy to clipboard

copy output to clipboard (work only on MacOS at the moment)

-i, --inclideHeaders - include table headers

npx tabletip 2 2 -i

1#   0   1
20 | 0 | 0 |
31 | 0 | 0 |

-f, --fill - fill with symbol (defalut is "0")

npx tabletip 3 3 -f "a"

1| a | a | a |
2| a | a | a |
3| a | a | a |

-e - use javascript expression to fill a table

npx tabletip 4 4 -i -e "2*2"

1#   0   1   2   3
20 | 4 | 4 | 4 | 4 |
31 | 4 | 4 | 4 | 4 |
42 | 4 | 4 | 4 | 4 |
53 | 4 | 4 | 4 | 4 |

you can get current rows and column with variables row and col:

npx tabletip 4 4 -i -e "(row+1)*(col+1)"

1#   0   1    2    3
20 | 1 | 2 |  3 |  4 |
31 | 2 | 4 |  6 |  8 |
42 | 3 | 6 |  9 | 12 |
53 | 4 | 8 | 12 | 16 |

-s - start table rows & cols from (default: 0)

npx tabletip 4 4 -e "(row)*(col)" -i -s 1

1#    1    2    3    4
21 |  1 |  2 |  3 |  4 |
32 |  2 |  4 |  6 |  8 |
43 |  3 |  6 |  9 | 12 |
54 |  4 |  8 | 12 | 16 |

without this option you will get zeroes at start

1#   0   1   2   3
20 | 0 | 0 | 0 | 0 |
31 | 0 | 1 | 2 | 3 |
42 | 0 | 2 | 4 | 6 |
53 | 0 | 3 | 6 | 9 |

--startRows - start table rows from

the same as -s, but applies only to rows

--startCols - start table cols from

the same as -s, but applies only to columns

-t - disable tabulation

with
npx tabletip 4 4 -e "(row+1)*(col+1)" -t

you get

1#   0   1   2   3
20 | 1 | 2 | 3 | 4 |
31 | 2 | 4 | 6 | 8 |
42 | 3 | 6 | 9 | 12 |
53 | 4 | 8 | 12 | 16 |

instead of

1#    0    1    2    3
20 |  1 |  2 |  3 |  4 |
31 |  2 |  4 |  6 |  8 |
42 |  3 |  6 |  9 | 12 |
53 |  4 |  8 | 12 | 16 |

Some examples

npx tabletip 7 7 -e "col === row || col + row === 6 ? '*' : ' '"

1| * |   |   |   |   |   | * |
2|   | * |   |   |   | * |   |
3|   |   | * |   | * |   |   |
4|   |   |   | * |   |   |   |
5|   |   | * |   | * |   |   |
6|   | * |   |   |   | * |   |
7| * |   |   |   |   |   | * |

npx tabletip 6 6 -e "(row*4+col+1)"

1|  1 |  2 |  3 |  4 |  5 |  6 |
2|  5 |  6 |  7 |  8 |  9 | 10 |
3|  9 | 10 | 11 | 12 | 13 | 14 |
4| 13 | 14 | 15 | 16 | 17 | 18 |
5| 17 | 18 | 19 | 20 | 21 | 22 |
6| 21 | 22 | 23 | 24 | 25 | 26 |

npx tabletip 6 6 -e "5*5-(row*4+col)+1"

1| 26 | 25 | 24 | 23 | 22 | 21 |
2| 22 | 21 | 20 | 19 | 18 | 17 |
3| 18 | 17 | 16 | 15 | 14 | 13 |
4| 14 | 13 | 12 | 11 | 10 |  9 |
5| 10 |  9 |  8 |  7 |  6 |  5 |
6|  6 |  5 |  4 |  3 |  2 |  1 |

npx tabletip 1 11 -e "Math.pow(row, col)" -i --startRows 2

1#      0      1      2      3      4      5      6      7      8      9     10
22 |    1 |    2 |    4 |    8 |   16 |   32 |   64 |  128 |  256 |  512 | 1024 |

API usage examples

1import tabletip from 'tabletip';
2
3let result
4result = tabletip(2, 2);
5result = tabletip(4, 4, { fillSymbol: '_', includeHeaders: true });
6result = tabletip(4, 4, {
7  includeHeaders: true,
8  startFrom: 1,
9  expression: '(row+1)*(col+1)',
10  removeTabulation: true,
11});