4.1. Basic usage¶

Basic usage of the pytablewriter is as follows:

Create a writer instance that corresponds to the format you want to write
Assign a value to instance variables (such as table_name/header_list/value_matrix) of the writer
Call the write_table method

Next examples show how to write a table to the standard output/file with reStructuredText format.

4.1.1. Write a table to the standard output (defaults)¶

The standard output is the default output stream of writers (except the ExcelXlsxTableWriter).

Sample Code:

Write a table to stdout¶

import pytablewriter

writer = pytablewriter.RstGridTableWriter()
writer.table_name = "zone"
writer.header_list = ["zone_id", "country_code", "zone_name"]
writer.value_matrix = [
    ["1", "AD", "Europe/Andorra"],
    ["2", "AE", "Asia/Dubai"],
    ["3", "AF", "Asia/Kabul"],
    ["4", "AG", "America/Antigua"],
    ["5", "AI", "America/Anguilla"],
]

writer.write_table()

Output:

.. table:: zone

    +-------+------------+----------------+
    |zone_id|country_code|   zone_name    |
    +=======+============+================+
    |      1|AD          |Europe/Andorra  |
    +-------+------------+----------------+
    |      2|AE          |Asia/Dubai      |
    +-------+------------+----------------+
    |      3|AF          |Asia/Kabul      |
    +-------+------------+----------------+
    |      4|AG          |America/Antigua |
    +-------+------------+----------------+
    |      5|AI          |America/Anguilla|
    +-------+------------+----------------+