Follow us

on Twitter: @geraldoreports

What is Geraldo Reports?

Geraldo is a reports engine for Python or Django applications. It uses the power of ReportLab to generate reports with page header and footer, child bands, report begin and summary bands, agreggation and graphic elements, etc.

Why should I know it?

Reports are the eyes of business - specially for the chairmans - and the web is the obvious desination for all corporate softwares, like ERPs, CRMs, etc. The cloud is here and there, so, make sense you should know a good reporting engine to make your reports on the web, and on the cloud.

How can I get help?

Join one of our mailing lists or just contact us.

Why "Geraldo"?

By the way, "Geraldo" is the name of some recognized jazz/bossa/whatever musicians, but, sincerely, "Geraldo" has been chosen because "Zambrota" would be weird, you know... so, "Geraldo" is nice.

Getting Started

Hello world

The fastest way to test Geraldo is run this code in your shell/console:

$ python easy_install reportlab geraldo
$ python
>>> from geraldo import Report, DetailBand, ObjectValue
>>> from geraldo.utils import cm
>>> from geraldo.generators import PDFGenerator
>>> names = ['Mychelle', 'Leticia', 'Tarsila', 'Marta', 'Vera', 'Leni']
>>> class MyReport(Report):
...     class band_detail(DetailBand):
...         height=0.7*cm
...         elements=[
...             ObjectValue(attribute_name='capitalize'),
...             ]
>>> report = MyReport(queryset=names)
>>> report.generate_by(PDFGenerator, filename='female-names.pdf')

The output will be this:

Really getting started

To (really) get start to use Geraldo on your Python (or Django project), you can follow the steps below:

  1. Get the Geraldo Reports
  2. Install it
  3. If you are using Django, Follow the first Tutorial. If you are using Web2py, there is a tutorial too.
  4. Not matters if you aren't using one of frameworks above, look at the examples
  5. Get help on the discussion groups
  6. Get enjoy :)