Skip to main content

Bring the power of relatorio to Django

Project description

Levit-report

This library makes it easy to manage and render a set of relatorio-based reports in a Django application

Compatibility Matrix

Levit-report is compatible with the following matrix

Py 3.5 Py 3.6 Py 3.7
Django 2.0 Yes Yes Yes
Django 2.1 Yes Yes Yes
Django 2.2 Yes Yes Yes

Installation

pip install levit-report

Configuration

Add levit_report to your INSTALLED_APPS:

## settings.py

INSTALLED_APPS = (
    ...
    'levit_report',
)

Import the built-in urls into your urls.py

## urls.py

...
from levit_report import urls as report_urls

...
urlpattern = [
    ...
    path('reports/', include(report_urls)),
]

Usage

Before being able to use this package you will first have to create a Relatorio 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 Levit_Report section).

admin screenshot

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
## settings.py

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 http://localhost:8000/reports/<document_slug>/<target_object_id>/

You'll also be able to download a ip containing several rendered reports by pointing your browser at http://localhost:8000/reports/<document_slug>/?ids[]=<target_object_id>&ids[]=<target_object_2_id>...

This project is licensed under the MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for levit-report, version 2.0
Filename, size File type Python version Upload date Hashes
Filename, size levit-report-2.0.tar.gz (6.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page