The project hosting has moved to https://orus.io/florent.aide/py3o.template
py3o is an elegant and scalable solution to design reports using LibreOffice or OpenOffice. py3o.template is the templating component that takes care of merging your data sets with a corresponding templated OpenOffice document.
It is plateform independent and does not require LibreOffice/OpenOffice itself to generate an ODF file.
If you want to generate a PDF or any other supported output format you will then need to have a server with either LibreOffice or OpenOffice and to install the py3o.renderserver on it. We also provide a docker image on the docker hub
If you want to have templating fusion & document conversion in one single web service usable from any language with just HTTP/POST you can install py3o.fusion server. Which also exists as a docker image
- py3o.fusion is python3 ready. But, yes there is a but... alas!, you'll need
to install a trunk version of Genshi:
$ # activate your python env... $ svn checkout http:https://svn.edgewall.org/repos/genshi/trunk genshi_trunk $ cd genshi_trunk $ python setup.py build $ python setup.py install
We tested this with revision 1271. When genshi 0.8 is released we can officially say we support Python3 out of the box.
We provide a documentation for this package. If anything is not correctly explained, please! create a ticket in our ticketing system
Below is an example that you can find in the source code inside the examples directory.
from py3o.template import Template
t = Template("py3o_example_template.odt", "py3o_example_output.odt")
t.set_image_path('logo', 'images/new_logo.png')
class Item(object):
pass
items = list()
item1 = Item()
item1.val1 = 'Item1 Value1'
item1.val2 = 'Item1 Value2'
item1.val3 = 'Item1 Value3'
item1.Currency = 'EUR'
item1.Amount = '12345.35'
item1.InvoiceRef = '#1234'
items.append(item1)
for i in xrange(1000):
item = Item()
item.val1 = 'Item%s Value1' % i
item.val2 = 'Item%s Value2' % i
item.val3 = 'Item%s Value3' % i
item.Currency = 'EUR'
item.Amount = '6666.77'
item.InvoiceRef = 'Reference #%04d' % i
items.append(item)
document = Item()
document.total = '9999999999999.999'
data = dict(items=items, document=document)
t.render(data)
- Added support for soft page breaks
- Added better unit tests
- Fixed corner cases in the variable introspection mechanism
- Better handling of "ignore_undefined" that now also allows undefined images
- Added Python3 support
- Fixed a problem with validity of output in case the template contains a text:list inside a for loop
- Added new public methods to help report servers introspect the template data dictionary
- Added real unit tests (96% coverage ATM, way to go test team!)
By order of contribution date: