jayvdb / beautifultable

Python Library for printing visually appealing ASCII Tables.

beautifultable

Introduction

This Package provides BeautifulTable class for easily printing tabular data in a visually appealing ASCII format to a terminal.

Features included but not limited to:

• Full customization of the look and feel of the table
• Build the Table as you wish, By adding rows, or by columns or even mixing both these approaches.
• Full support for colors using ANSI sequences or any library of your choice. It just works.
• Plenty of predefined styles for multiple use cases and option to create custom ones.
• Support for Unicode characters.

Links

• Documentation
• Source
• API Reference

Usage

Here is an example of how you can use beautifultable:

>>> from beautifultable import BeautifulTable
>>> table = BeautifulTable()
>>> table.column_headers = ["name", "rank", "gender"]
>>> table.append_row(["Jacob", 1, "boy"])
>>> table.append_row(["Isabella", 1, "girl"])
>>> table.append_row(["Ethan", 2, "boy"])
>>> table.append_row(["Sophia", 2, "girl"])
>>> table.append_row(["Michael", 3, "boy"])
>>> print(table)
+----------+------+--------+
|   name   | rank | gender |
+----------+------+--------+
|  Jacob   |  1   |  boy   |
+----------+------+--------+
| Isabella |  1   |  girl  |
+----------+------+--------+
|  Ethan   |  2   |  boy   |
+----------+------+--------+
|  Sophia  |  2   |  girl  |
+----------+------+--------+
| Michael  |  3   |  boy   |
+----------+------+--------+

You can learn more about beautifultable at this Tutorial

Installation

pip install beautifultable

Changelog

Unreleased

v0.8.0

• Dropped support for Python 3.3
• Added support for streaming tables using a generator for cases where data retrieval is slow
• Alignment, padding, width can now be set for all columns using a simplified syntax like table.column_alignments = beautifultable.ALIGN_LEFT

v0.7.0

• Added 4 new styles, STYLE_BOX, STYLE_BOX_DOUBLED, STYLE_BOX_ROUNDED, STYLE_GRID.
• Renamed STYLE_RESTRUCTURED_TEXT to STYLE_RST
• wcwidth is now an optional dependency
• Updated the algorithm for calculating width of columns(better division of space among columns)
• Added support for Paragraphs(using \n character)
• Added finer control for intersection characters using 12 new attributes intersect_{top|header|row|bottom}_{left|mid|right}
• Added the ability to also accept bytestrings instead of unicode
• Deprecated attribute intersection_char
• Deprecated methods get_top_border(), get_bottom_border(), get_header_separator(), get_row_separator(), auto_calculate_width()
• Fixed an issue with WEP_ELLIPSIS and WEP_STRIP when using multibyte characters
• Fixed an issue where table would not be in proper form if column_width is too low

v0.6.0

• Added support for handling Multi byte strings
• Added support for colored strings using ANSI escape sequences
• Added constraint where all strings must be unicode
• Fixed an issue where sometimes width was calculated as higher than intended

v0.5.3

• Added support for handing color codes using ANSI escape sequences(experimental)
• Fixed collections ABCs deprecation warning

v0.5.2

• Added new style STYLE_NONE
• Fixed issue regarding improper conversion of non-string floats

v0.5.1

• Added detect_numerics boolean for toggling automatic numeric conversion

v0.5.0

• Added new property serialno_header
• Deprecated methods with misspelled "seperator" in their name.
• Fixed an issue where table was corrupted when column_count was too high

v0.4.0

• Added predefined styles for easier customization
• Added reverse argument to sort() method
• Fixed enum34 dependency for python versions prior to 3.4

v0.3.0

• Added property serialno for auto printing serial number
• Fixed an issue with sign_mode related to str conversion
• Fixed bugs related to python version prior to 3.3
• Fixed exception on WEP_ELLIPSIS and token length less than 3
• Fixed printing issues with empty table

v0.2.0

• Added python 2 support

v0.1.3

• Fixed minor issues

v0.1.2

• Added new property default_padding
• Added new method update_row
• Fixed an issue in auto_calculate_width()

v0.1.1

• Initial release on PyPI

Contribute

If you have any suggestions or bug reports, Please create a Issue. Pull Requests are always welcome.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Donation

Love beautifultable? Consider supporting the development :)