list-tableΒΆ

see:http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table

These python commands:

1
2
3
4
5
6
7
8
import pyRestTable
t = pyRestTable.Table()
t.labels = ('one', 'two', 'three' )
t.rows.append( ['1,1', '1,2', '1,3',] )
t.rows.append( ['2,1', '2,2', '2,3',] )
t.rows.append( ['3,1', '3,2', '3,3',] )
t.rows.append( ['4,1', '4,2', '4,3',] )
print(t.reST(fmt='list-table'))

build this table source code:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
.. list-table::
  :header-rows: 1
  :widths: 3 3 5

  * - one
    - two
    - three
  * - 1,1
    - 1,2
    - 1,3
  * - 2,1
    - 2,2
    - 2,3
  * - 3,1
    - 3,2
    - 3,3
  * - 4,1
    - 4,2
    - 4,3

which is rendered as:

one two three
1,1 1,2 1,3
2,1 2,2 2,3
3,1 3,2 3,3
4,1 4,2 4,3