==============
terminaltables
Easily draw tables in terminal/console applications from a list of lists of strings. Supports multi-line rows.
- Python 2.6, 2.7, PyPy, PyPy3, 3.3, 3.4, and 3.5 supported on Linux and OS X.
- Python 2.7, 3.3, 3.4, and 3.5 supported on Windows (both 32 and 64 bit versions of Python).
? Full documentation: https://robpol86.github.io/terminaltables
.. image:: https://img.shields.io/appveyor/ci/Robpol86/terminaltables/master.svg?style=flat-square&label=AppVeyor%20CI
:target: https://ci.appveyor.com/project/Robpol86/terminaltables
:alt: Build Status Windows
.. image:: https://img.shields.io/travis/Robpol86/terminaltables/master.svg?style=flat-square&label=Travis%20CI
:target: https://travis-ci.org/Robpol86/terminaltables
:alt: Build Status
.. image:: https://img.shields.io/codecov/c/github/Robpol86/terminaltables/master.svg?style=flat-square&label=Codecov
:target: https://codecov.io/gh/Robpol86/terminaltables
:alt: Coverage Status
.. image:: https://img.shields.io/pypi/v/terminaltables.svg?style=flat-square&label=Latest
:target: https://pypi.python.org/pypi/terminaltables
:alt: Latest Version
Quickstart
Install:
.. code:: bash
pip install terminaltables
Usage:
.. code::
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, +--------------+--------------+
Example Implementations
.. image:: docs/examples.png?raw=true
:alt: Example Scripts Screenshot
Source code for examples: example1.py <https://github.com/Robpol86/terminaltables/blob/master/example1.py>,
example2.py <https://github.com/Robpol86/terminaltables/blob/master/example2.py>, and
example3.py <https://github.com/Robpol86/terminaltables/blob/master/example3.py>_
.. changelog-section-start
Changelog
This project adheres to Semantic Versioning <http://semver.org/>_.
3.1.0 - 2016-10-16
Added
* git --porcelain-like table by liiight: https://github.com/Robpol86/terminaltables/pull/31
3.0.0 - 2016-05-30
Added
* Support for https://pypi.python.org/pypi/colorama
* Support for https://pypi.python.org/pypi/termcolor
* Support for RTL characters (Arabic and Hebrew).
* Support for non-string items in table_data like integers.
Changed
* Refactored again, but this time entire project including tests.
Removed
* padded_table_data property and join_row(). Moving away from repeated string joining/splitting.
Fixed
* set_terminal_title() Unicode handling on Windows.
* https://github.com/Robpol86/terminaltables/issues/18
* https://github.com/Robpol86/terminaltables/issues/20
* https://github.com/Robpol86/terminaltables/issues/23
* https://github.com/Robpol86/terminaltables/issues/26
2.1.0 - 2015-11-02
Added
* GitHub Flavored Markdown table by bcho: https://github.com/Robpol86/terminaltables/pull/12
* Python 3.5 support (Linux/OS X and Windows).
2.0.0 - 2015-10-11
Changed
* Refactored code. No new features.
* Breaking changes: UnixTable/WindowsTable/WindowsTableDouble moved. Use SingleTable/DoubleTable
instead.
1.2.1 - 2015-09-03
Fixed
* CJK character width fixed by zqqf16 and bcho: https://github.com/Robpol86/terminaltables/pull/9
1.2.0 - 2015-05-31
Added
* Bottom row separator.
1.1.1 - 2014-11-03
Fixed
* Python 2.7 64-bit terminal width bug on Windows.
1.1.0 - 2014-11-02
Added
* Windows support.
* Double-lined table.
1.0.2 - 2014-09-18
Added
* table_width and ok properties.
1.0.1 - 2014-09-12
Added
* Terminal width/height defaults for testing.
* terminaltables.DEFAULT_TERMINAL_WIDTH
* terminaltables.DEFAULT_TERMINAL_HEIGHT
1.0.0 - 2014-09-11
- Initial release.
.. changelog-section-end