ascii-art-table

a trivial way to print data to a table in ascii over java (without much configuration possibilities)

trivial case

this ...

AsciiArtTable aat = new AsciiArtTable();
aat.addHeaderCols("some", "foo");
aat.addHeaderCols("bar");
aat.add("bello", "pussy", "hans");
aat.add(1, 2, 3., "a very long thing");
aat.print(System.out);

... will print out that:

╔═══════════════════╤═══════╤══════╗
║              some │   foo │  bar ║
╠═══════════════════╪═══════╪══════╣
║             bello │ pussy │ hans ║
╟───────────────────┼───────┼──────╢
║                 1 │     2 │  3.0 ║
╟───────────────────┼───────┼──────╢
║ a very long thing │       │      ║
╚═══════════════════╧═══════╧══════╝

use of another padding:

AsciiArtTable aat = new AsciiArtTable(5);
[...]

╔═══════════════════════════╤═══════════════╤══════════════╗
║                  some     │       foo     │      bar     ║
╠═══════════════════════════╪═══════════════╪══════════════╣
║                 bello     │     pussy     │     hans     ║
╟───────────────────────────┼───────────────┼──────────────╢
║                     1     │         2     │      3.0     ║
╟───────────────────────────┼───────────────┼──────────────╢
║     a very long thing     │               │              ║
╚═══════════════════════════╧═══════════════╧══════════════╝

add a headline

AsciiArtTable aat = new AsciiArtTable();
aat.addHeadline("Some test headline");
[...]

╔══════════════════════════════════╗
║ Some test headline               ║
╟───────────────────┬───────┬──────╢
║              some │   foo │  bar ║
╠═══════════════════╪═══════╪══════╣
║             bello │ pussy │ hans ║
╟───────────────────┼───────┼──────╢
║                 1 │     2 │  3.0 ║
╟───────────────────┼───────┼──────╢
║ a very long thing │       │      ║
╚═══════════════════╧═══════╧══════╝

add many headlines

AsciiArtTable aat = new AsciiArtTable();
aat.addHeadline("Some test headline");
aat.addHeadline("And a long explaining text, that may stop here");
aat.addHeadline("or it will end up here.");
[...]

╔══════════════════════════════════╗
║ Some test headline               ║
╟──────────────────────────────────╢
║ And a long explaining text, that ║
║ may stop here                    ║
╟──────────────────────────────────╢
║ or it will end up here.          ║
╟───────────────────┬───────┬──────╢
║              some │   foo │  bar ║
╠═══════════════════╪═══════╪══════╣
║             bello │ pussy │ hans ║
╟───────────────────┼───────┼──────╢
║                 1 │     2 │  3.0 ║
╟───────────────────┼───────┼──────╢
║ a very long thing │       │      ║
╚═══════════════════╧═══════╧══════╝

no header columns

AsciiArtTable aat = new AsciiArtTable();
aat.setNoHeaderColumns(3);
[...]

╔═══════════════════╤═══════╤══════╗
║             bello │ pussy │ hans ║
╟───────────────────┼───────┼──────╢
║                 1 │     2 │  3.0 ║
╟───────────────────┼───────┼──────╢
║ a very long thing │       │      ║
╚═══════════════════╧═══════╧══════╝

no header columns but headline with padding

AsciiArtTable aat = new AsciiArtTable(3);
aat.addHeadline("Some test headline");
aat.setNoHeaderColumns(3);
[...]

╔══════════════════════════════════════════════╗
║   Some test headline                         ║
╠═══════════════════════╤═══════════╤══════════╣
║               bello   │   pussy   │   hans   ║
╟───────────────────────┼───────────┼──────────╢
║                   1   │       2   │    3.0   ║
╟───────────────────────┼───────────┼──────────╢
║   a very long thing   │           │          ║
╚═══════════════════════╧═══════════╧══════════╝

other borders?

just configure another hell of string:

AsciiArtTable aat = new AsciiArtTable();
aat.setBorderCharacters("┏━┯┓┃┠─┬┨┿┣┫│┗┷┛┼");
[...]

┏━━━━━━━━━━━━━━━━━━━┯━━━━━━━┯━━━━━━┓
┃              some │   foo │  bar ┃
┣━━━━━━━━━━━━━━━━━━━┿━━━━━━━┿━━━━━━┫
┃             bello │ pussy │ hans ┃
┠───────────────────┼───────┼──────┨
┃                 1 │     2 │  3.0 ┃
┠───────────────────┼───────┼──────┨
┃ a very long thing │       │      ┃
┗━━━━━━━━━━━━━━━━━━━┷━━━━━━━┷━━━━━━┛

... or ...

AsciiArtTable aat = new AsciiArtTable();
aat.setBorderCharacters("╭──╮││ ─││⎬⎨│╰─╯│");
[...]

╭──────────────────────────────────╮
│              some │   foo │  bar │
⎬───────────────────│───────│──────⎨
│             bello │ pussy │ hans │
│                   │       │      │
│                 1 │     2 │  3.0 │
│                   │       │      │
│ a very long thing │       │      │
╰──────────────────────────────────╯

(yes, I had the time of my life)

border helper

if you want to design your own table borders, do not lose track and do something like ...

AsciiArtTable aat = new AsciiArtTable();
aat.addHeadline(" - ");
aat.addHeadline(" - ");
aat.addHeaderCols(" - ", " - ", " - ");
aat.addHeaderCols();
aat.add("   ", "   ", "   ");
aat.add("   ", "   ", "   ");
aat.setBorderCharacters("ABCDEFGHIJKLMNOPQ");
[...]

ABBBBBBBBBBBBBBBBBD
E  -              E
FGGGGGGGGGGGGGGGGGI
E  -              E
FGGGGGGGGGGGGGGGGGI
E  -  M  -  M  -  E
KBBBBBJBBBBBJBBBBBL
E     M     M     E
FGGGGGQGGGGGQGGGGGI
E     M     M     E
NBBBBBOBBBBBOBBBBBP

multi lines in a cell?

by default, the lines are separated after 80 characters (known bug if a single word is larger). you can change this by:

AsciiArtTable aat = new AsciiArtTable();
aat.setMaxColumnWidth(25);
[...]

╔═══════════════════════════╤═══════╤═══════════════════════════╗
║                      some │   foo │                       bar ║
╠═══════════════════════════╪═══════╪═══════════════════════════╣
║                         a │     b │ Lorem ipsum dolor sit     ║
║                           │       │ amet, consetetur          ║
║                           │       │ sadipscing elitr, sed     ║
║                           │       │ diam nonumy eirmod tempor ║
║                           │       │ invidunt ut labore et     ║
║                           │       │ dolore magna aliquyam     ║
║                           │       │ erat, sed diam voluptua.  ║
╟───────────────────────────┼───────┼───────────────────────────╢
║                         1 │ cdefg │                       3.0 ║
╟───────────────────────────┼───────┼───────────────────────────╢
║ Lorem ipsum dolor sit     │       │                           ║
║ amet, consetetur          │       │                           ║
║ sadipscing elitr          │       │                           ║
╚═══════════════════════════╧═══════╧═══════════════════════════╝    

minimize height

AsciiArtTable aat = new AsciiArtTable();
aat.minimiseHeight();
[...]

╔══════════════════════════════════╗
║ Some test headline               ║
╟───────────────────┬───────┬──────╢
║              some │   foo │  bar ║
╠═══════════════════╪═══════╪══════╣
║             bello │ pussy │ hans ║
║                 1 │     2 │  3.0 ║
║ a very long thing │       │      ║
╚═══════════════════╧═══════╧══════╝