AsciiTable

AsciiTable is the simplest table. It uses +, |, and - characters to build the borders.

API

class terminaltables.AsciiTable(table_data, title=None)

Draw a table using regular ASCII characters, such as +, |, and -.

Variables:

• table_data (iter) – List (empty or list of lists of strings) representing the table.
• title (str) – Optional title to show within the top border of the table.
• inner_column_border (bool) – Separates columns.
• inner_footing_row_border (bool) – Show a border before the last row.
• inner_heading_row_border (bool) – Show a border after the first row.
• inner_row_border (bool) – Show a border in between every row.
• outer_border (bool) – Show the top, left, right, and bottom border.
• justify_columns (dict) – Horizontal justification. Keys are column indexes (int). Values are right/left/center.
• padding_left (int) – Number of spaces to pad on the left side of every cell.
• padding_right (int) – Number of spaces to pad on the right side of every cell.

column_max_width(column_number)

Return the maximum width of a column based on the current terminal width.

Parameters:column_number (int) – The column number to query. Returns:The max width of the column. Return type:int

column_widths

Return a list of integers representing the widths of each table column without padding.

ok

Return True if the table fits within the terminal width, False if the table breaks.

table

Return a large string of the entire table ready to be printed to the terminal.

table_width

Return the width of the table including padding and borders.