Text Table Library in Java
The Java Text Tables library is the next generation of my original Java Text Table Formatter project.
This new project hopes to offer more extensibility and composability, while still providing the ease-of-use of the original project.
SimpleTable is Optimized for quick table construction without having to know the final table dimensions beforehand. It Allows you to build a table one row/cell at a time.
// NOTE: Apply vertical alignment FIRST !
//
SimpleTable s = SimpleTable.of()
.nextRow()
.nextCell()
.addLine("Left")
.addLine("Top")
.applyToCell(TOP_ALIGN .withHeight(height))
.applyToCell(LEFT_ALIGN.withWidth (width ).withChar('^'))
.nextCell()
.addLine("Center")
.addLine("Top")
.applyToCell(TOP_ALIGN .withHeight(height))
.applyToCell(HORIZONTAL_CENTER.withWidth (width ))
.nextCell()
.addLine("Right")
.addLine("Top")
.applyToCell(TOP_ALIGN .withHeight(height))
.applyToCell(RIGHT_ALIGN.withWidth (width ))
.nextRow()
.nextCell()
.addLine("Left")
.addLine("Center")
.applyToCell(VERTICAL_CENTER.withHeight(height))
.applyToCell(LEFT_ALIGN .withWidth (width ))
.nextCell()
.addLine("Center")
.addLine("Center")
.applyToCell(VERTICAL_CENTER .withHeight(height))
.applyToCell(HORIZONTAL_CENTER.withWidth (width ).withChar('.'))
.nextCell()
.addLine("Right")
.addLine("Center")
.applyToCell(VERTICAL_CENTER.withHeight(height))
.applyToCell(RIGHT_ALIGN .withWidth (width ))
.nextRow()
.nextCell()
.addLine("Left")
.addLine("Bottom")
.applyToCell(BOTTOM_ALIGN.withHeight(height))
.applyToCell(LEFT_ALIGN .withWidth (width ))
.nextCell()
.addLine("Center")
.addLine("Bottom")
.applyToCell(BOTTOM_ALIGN .withHeight(height))
.applyToCell(HORIZONTAL_CENTER.withWidth (width ))
.nextCell()
.addLine("Right")
.addLine("Bottom")
.applyToCell(BOTTOM_ALIGN.withHeight(height))
.applyToCell(RIGHT_ALIGN .withWidth (width ).withChar('_'))
;
//
// NOTE: SimpleTable makes creating the table easy, but you will need to convert it
// into a GridTable in order to perform further operations
// (like adding a border or printing)
//
// Convert to grid
//
GridTable g = s.toGrid();
// Add simple border
//
g = Border.of(Border.Chars.of('+', '-', '|')).apply(g);
// Print the table to System.out
//
Util.print(g);
The above code should result in the following output:
+----------+----------+----------+
|Left^^^^^^| Center | Right|
|Top^^^^^^^| Top | Top|
|^^^^^^^^^^| | |
|^^^^^^^^^^| | |
|^^^^^^^^^^| | |
|^^^^^^^^^^| | |
+----------+----------+----------+
| |..........| |
| |..........| |
|Left |..Center..| Right|
|Center |..Center..| Center|
| |..........| |
| |..........| |
+----------+----------+----------+
| | |__________|
| | |__________|
| | |__________|
| | |__________|
|Left | Center |_____Right|
|Bottom | Bottom |____Bottom|
+----------+----------+----------+
GridTable Offers a more powerful table builder (compared to SimpleTable), but requires knowledge of the final table dimensions at construction, along with specifying coordinates (row, col) when manipulating cells.
GridTable g = GridTable.of(3, 3)
.put(0, 0, Cell.of("Left" , "Top" ))
.put(0, 1, Cell.of("Center", "Top" ))
.put(0, 2, Cell.of("Right" , "Top" ))
.put(1, 0, Cell.of("Left" , "Center"))
.put(1, 1, Cell.of("Center", "Center"))
.put(1, 2, Cell.of("Right" , "Center"))
.put(2, 0, Cell.of("Left" , "Bottom"))
.put(2, 1, Cell.of("Center", "Bottom"))
.put(2, 2, Cell.of("Right" , "Bottom"))
.applyToRow(0, TOP_ALIGN .withHeight(height))
.applyToRow(1, VERTICAL_CENTER.withHeight(height))
.applyToRow(2, BOTTOM_ALIGN .withHeight(height))
.apply(0, 0, LEFT_ALIGN.withWidth(width).withChar('^'))
.apply(1, 0, LEFT_ALIGN)
.apply(2, 0, LEFT_ALIGN)
.apply(0, 1, HORIZONTAL_CENTER.withWidth(width))
.apply(1, 1, HORIZONTAL_CENTER.withChar('.'))
.apply(2, 1, HORIZONTAL_CENTER)
.apply(0, 2, RIGHT_ALIGN.withWidth(width))
.apply(1, 2, RIGHT_ALIGN)
.apply(2, 2, RIGHT_ALIGN.withChar('_'))
;
// Add fancy border
//
g = Border.DOUBLE_LINE.apply(g);
// Print the table to System.out
//
Util.print(g);
The above code should result in the following output:
╔══════════╦══════════╦══════════╗
║Left^^^^^^║ Center ║ Right║
║Top^^^^^^^║ Top ║ Top║
║^^^^^^^^^^║ ║ ║
║^^^^^^^^^^║ ║ ║
║^^^^^^^^^^║ ║ ║
║^^^^^^^^^^║ ║ ║
╠══════════╬══════════╬══════════╣
║ ║..........║ ║
║ ║..........║ ║
║Left ║..Center..║ Right║
║Center ║..Center..║ Center║
║ ║..........║ ║
║ ║..........║ ║
╠══════════╬══════════╬══════════╣
║ ║ ║__________║
║ ║ ║__________║
║ ║ ║__________║
║ ║ ║__________║
║Left ║ Center ║_____Right║
║Bottom ║ Bottom ║____Bottom║
╚══════════╩══════════╩══════════╝
NOTE Spaces between Border Character are due to HTML styling and would not appear in a terminal
<repositories>
<repository>
<id>oss-sonatype</id>
<name>oss-sonatype</name>
<url>https://oss.sonatype.org/content/repositories/snapshots/</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.inamik.text.tables</groupId>
<artifactId>inamik-text-tables</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
- David Farrell ([email protected])
Licensed under The MIT License (MIT), see LICENSE.txt
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent