EazyReport (Python)

Modern Banded Document & Invoice Reporting Engine for Python.
The modern alternative to HTML-to-PDF & legacy desktop reporting. Generates pixel-perfect printable HTML, vector SVG charts, barcodes/QR codes, and direct vector PDF documents from .rtpl templates.

🌟 Overview

EazyReport is an enterprise-grade document and invoice designer and rendering engine. Instead of fighting with brittle CSS print stylesheets, awkward page breaks, and complex server rendering runtimes, eazyreport provides true millimeter-accurate banded layouts, multi-pass vector pagination, and automated data binding.

Templates designed in the EazyReport Studio are saved as reusable .rtpl files and can be executed at lightning speed inside Python to generate print-ready HTML or vector PDF documents.

💼 Real-World Use Cases

⚙️ How It Works

EazyReport operates as an end-to-end reporting pipeline:

┌────────────────────────┐      ┌────────────────────────┐
│  Visual Design         │      │  Runtime Data          │
│  (eazyreport.in /      │      │  (JSON, Dictionaries,  │
│   .rtpl Template)      │      │   Database Records)    │
└───────────┬────────────┘      └───────────┬────────────┘
            │                               │
            └───────────────┬───────────────┘
                            │
                            ▼
         ┌──────────────────────────────────────┐
         │  Multi-Pass Layout Engine            │
         │  1. Ingests .rtpl bands & elements   │
         │  2. Evaluates Handlebars expressions │
         │  3. Formats currencies, dates, words │
         │  4. Calculates line wrapping/heights │
         │  5. Resolves [TotalPages] & [Page]   │
         │  6. Generates vector charts & codes  │
         │  7. Applies fillUnusedSpace bands    │
         └──────────────────┬───────────────────┘
                            │
              ┌─────────────┴─────────────┐
              ▼                           ▼
  ┌───────────────────────┐   ┌───────────────────────┐
  │ Standalone HTML       │   │ Native Vector PDF     │
  │ (Pixel-perfect Print) │   │ (Binary Byte Stream)  │
  └───────────────────────┘   └───────────────────────┘

1. Design Template: Build your visual layout in the EazyReport Designer and export it as an .rtpl template file.
2. Bind Runtime Data: In your Python application, pass runtime datasets (orders, invoices, customer records, database query results, or JSON payloads).
3. Multi-Pass Pagination:
   • Pass 1: Calculates exact element growth, line wrapping, data band repetitions, and determines the total page budget.
   • Pass 2: Resolves [TotalPages] (Page 1 of 3), evaluates conditional rules, computes group totals, and positions vector charts and barcodes.
4. Export: Get immediate standalone printable HTML or direct binary PDF bytes via ReportLab.

🎨 How .rtpl Files Are Generated

An .rtpl (Report Template) is a human-readable JSON schema defining document dimensions, margins, bands, elements, expressions, and styling.

1. Visual Designer Studio (Recommended)

You can visually create, preview, and edit .rtpl files directly in your browser using the EazyReport Studio:

• Millimeter Banding Canvas: Drag and position ReportTitle, PageHeader, Data, GroupHeader, GroupFooter, Child, PageFooter, and ReportSummary bands.
• Visual Element Palette: Add text boxes, dynamic data fields, vector charts, Code 128 barcodes, QR codes, lines, and shapes.
• Interactive Data Binding: Load sample Excel (.xlsx, .xls), CSV, or JSON datasets with automatic schema inference.
• Export Template: Click Save / Export to download the ready-to-use .rtpl file for your backend.

2. Programmatic Template Generation

You can also construct, inspect, or modify .rtpl templates dynamically in Python using EazyReport's built-in dataclasses:

from eazyreport import LayoutDocument, LayoutPage, Band, DataBand, LayoutElement, TextStyle

doc = LayoutDocument(
    title="Invoice Template",
    pages=[
        LayoutPage(
            size="A4",
            orientation="portrait",
            reportTitle=Band(
                height=25.0,
                elements=[
                    LayoutElement(
                        id="title",
                        type="text",
                        content="Commercial Invoice",
                        style=TextStyle(fontSize=16.0, bold=True),
                        w=100.0,
                        h=10.0,
                    )
                ],
            ),
            data=[
                DataBand(
                    id="items_band",
                    dataPath="items",
                    height=7.0,
                    elements=[
                        LayoutElement(id="sku", type="field", field_name="item.sku", w=30.0, h=6.0),
                        LayoutElement(id="desc", type="field", field_name="item.description", x=32.0, w=80.0, h=6.0),
                        LayoutElement(id="total", type="field", field_name="item.total", x=115.0, w=30.0, h=6.0),
                    ],
                )
            ],
        )
    ],
)

📦 Installation

Install the package via standard pip:

pip install eazyreport

Or using uv / poetry:

uv add eazyreport
# or
poetry add eazyreport

🛠️ Quickstart

Generating HTML and PDF from an .rtpl Template

from eazyreport import ReportBuilder

# Initialize builder with your template and runtime data
builder = (
    ReportBuilder("commercial_invoice.rtpl")
    .data({
        "invoiceNumber": "INV-2026-9901",
        "issueDate": "2026-10-02",
        "customer": {
            "name": "Acme Global Logistics",
            "email": "billing@acme.com",
            "address": {"city": "Zurich", "zip": "8001"},
        },
        "items": [
            {"sku": "SRV-001", "description": "Cloud Infrastructure Consultation", "qty": 10, "unitPrice": 150.00, "total": 1425.00},
            {"sku": "LIC-002", "description": "Enterprise Reporting License", "qty": 2, "unitPrice": 2400.00, "total": 4320.00},
        ],
        "grandTotal": 5745.00,
    })
    .params({"Company": "EazyCorp International"})
)

# 1. Export Standalone Printable HTML (for browser preview or client-side printing)
html_content = builder.to_html()
with open("invoice.html", "w", encoding="utf-8") as f:
    f.write(html_content)

# 2. Export Direct Vector PDF (binary bytes for email attachments or archiving)
pdf_bytes = builder.to_pdf()
with open("invoice.pdf", "wb") as f:
    f.write(pdf_bytes)

# 3. Inspect Exact Page Budget
print(f"Total Pages Generated: {builder.page_count()}")

High-Level Functional API

from eazyreport import get_report_html, get_report_pdf, count_report_pages

# One-liner HTML string
html_doc = get_report_html("invoice.rtpl", data=invoice_data)

# One-liner binary PDF bytes
pdf_data = get_report_pdf("invoice.rtpl", data=invoice_data)

# Count pages without rendering
total_pages = count_report_pages("invoice.rtpl", data=invoice_data)

🧩 Built-in Handlebars & Formatting Helpers

🧪 Testing

Run the test suite verifying expressions, formatting, charts, barcodes, and real .rtpl invoice rendering:

pytest -v tests

👥 Contributors

• Ashiq Kodali (@ashiq-kodali)
• Thameem PK

📄 License

Distributed under the MIT License. See LICENSE for details.