# terminaltables 3.1

Easily draw tables in terminal/console applications from a list of lists of strings. As easy as:

    >>> from terminaltables import AsciiTable
    >>> table_data = [
    ... ['Heading1', 'Heading2'],
    ... ['row1 column1', 'row1 column2'],
    ... ['row2 column1', 'row2 column2'],
    ... ['row3 column1', 'row3 column2'],
    ... ]
    >>> table = AsciiTable(table_data)
    >>> print table.table
    +--------------+--------------+
    | Heading1     | Heading2     |
    +--------------+--------------+
    | row1 column1 | row1 column2 |
    | row2 column1 | row2 column2 |
    | row3 column1 | row3 column2 |
    +--------------+--------------+

Windows 10, Windows XP, and OS X are also supported. View source: :github:`example1.py`, :github:`example2.py`, :github:`example3.py`

## Features

- Multi-line rows: add newlines to table cells and terminatables will handle the rest.

- Table titles: show a title embedded in the top border of the table.

- POSIX: Python 2.6, 2.7, PyPy, PyPy3, 3.3, 3.4, and 3.5 supported on Linux and OS X.

- Windows: Python 2.7, 3.3, 3.4, and 3.5 supported on Windows XP through 10.

- CJK: Wide Chinese/Japanese/Korean characters displayed correctly.

- RTL: Arabic and Hebrew characters aligned correctly.

- Alignment/Justification: Align individual columns left, center, or right.

- Colored text: colorclass, colorama, termcolor, or just plain ANSI escape codes.

## Project Links

- Documentation: https://robpol86.github.io/terminaltables

- Source code: https://github.com/Robpol86/terminaltables

- PyPI homepage: https://pypi.python.org/pypi/terminaltables

General

- Installation
  - Pip Install
  - Latest from GitHub
  - Clone and Install
- Quickstart
  - Table with Default Settings
  - Changing Table Settings
  - Other Table Styles
- Settings
  - `Table.table_data`
  - `Table.title`
  - `Table.inner_column_border`
  - `Table.inner_footing_row_border`
  - `Table.inner_heading_row_border`
  - `Table.inner_row_border`
  - `Table.outer_border`
  - `Table.justify_columns`
  - `Table.padding_left`
  - `Table.padding_right`

Table Styles

- AsciiTable
  - API
- SingleTable
  - Gaps on Windows 10
  - API
- DoubleTable
  - Gaps on Windows 10
  - Gaps on POSIX
  - API
- GithubFlavoredMarkdownTable
  - API