This library makes it easy to manage and render a set of relatorio-based reports in a Django application
`pip install levit-report`
Add `levit_report` to your `INSTALLED_APPS`:
INSTALLED_APPS = (
Import the built-in urls into your `urls.py`
from levit_report import urls as report_urls
urlpattern = [
Before being able to use this package you will first have to create a
[Relatorio](http://relatorio.readthedocs.io/en/latest/index.html) template. The "object"
of the report will be available inside the report as `o` (as in object).
Once you have created your templte, go to the admin and add a new `Document` (in the
You'll then be able to upload your relatorio template and associate it with a ContentType.
In order to use the "convert to" feature, you'll need you have LibreOffice headless installed.
:warning: LibreOffice headless fails silently when a regular LibreOffice window is open on
the same machine.
In order to use the "Merge with tos" feature (only available for pdf's), you'll need:
- to have pdfunite installed
- have given the full path to a pdf `TOS_FILE` in your `settings.py` like this
TOS_FILE = os.path.join(BASE_DIR, 'documents', 'tos.pdf')
Once this is done, you'll be able to download a rendered version of your report at
You'll also be able to download a ip containing several rendered reports by pointing
your browser at
This project is licensed under the [MIT License](http://opensource.org/licenses/MIT)
TODO: Brief introduction on what you do with files - including link to relevant help section.