Creare RST in Python

reStructuredText (RST, ReST, o reST) è un formato usato principalmente in Python per la documentazione tecnica.

Potete leggere su Wikipedia un pò di info utili.

In questo articolo vediamo come creare il formato RST in Python.

Prima di tutto installiamo la libreria con pip:

pip install rst

Qui sotto un esempio di codice:

from rst import rst

doc = rst.Document('Titolo')

par = rst.Paragraph('Paragrafo')
doc.add_child(par)

sec = rst.Section('Sezione', 2)
doc.add_child(sec)

par2 = rst.Paragraph('Un altro paragrafo')
doc.add_child(par2)

blt = rst.Orderedlist()
blt.add_item('uno')
blt.add_item('due')
blt.add_item('tre')
doc.add_child(blt)

sec2 = rst.Section('Sezione 2', 3)
doc.add_child(sec2)

tbl = rst.Table('Libri', ['Titolo', 'Autore'])
tbl.add_item(('IT', 'Stephen King'))
tbl.add_item(('Sahara', 'Clive Cussler'))
tbl.add_item(('Fairy Tale', 'Stephen King'))
doc.add_child(tbl)

print(doc.get_rst())

Enjoy!