The light Python report builder.

Converts data into formatted text (PDF, XLSX, DOCX, HTML):

data = {'data_source1':[{'col1': 'value row1', ....}, ...],
        'data_source2':[{'col_1': 'valie_row1', ....}, ...],
        }

Available formatting (styling options):

"style": {
        "font-family": "Arial",
        "font-size": "10pt",
        "font-weight": "normal",  # bold
        "text-decoration": "",  # underline
        "font-style": "",  # italic
        "color": "black",  # font color
        "background": "white",  # background color
        "border-color": "black",  # border color
        "border-width": "1 1 1 1",
        "padding": "0.05cm 0.05cm 0.05cm 0.05cm",
        "text-align": "left",
        "vertical-align": "top",
  }

Concept

The report definition consists of sections (Report, Pages, Columns, Rows, Cells).
Each section inherits style from previous and may override some styling options.
*see examples in folder test_data*

Report:      # top-level report object containing the base style
    Pages:   # page size, margins, and page-level styles
        Columns:    # column widths: fixed, %, or auto-width; supports styles
            Rows:   # row heights: auto, fixed, minimum, or maximum; supports styles
                    # rows may be data-bound and can include subsections:
                    # header, footer, group-header, group-footer
                Cells:  # contain plain text and data placeholders — {col1} (f-strings style)
                        # support aggregate functions — {sum:col1}
                        # support basic HTML formatting: <b> <i> <u> <br>
            Rows:
                Cells:  # cells can be merged (span)
            ...
        Columns:
            ...
    Pages:
        ...
    ...```

---

## Main API (`Q2Report`)

### Initialization

```python
from q2report.q2report import Q2Report

report = Q2Report(style={...})

Adding Pages and Columns

report.add_page(page_width=21, page_height=29.7, page_margin_left=2, page_margin_right=1)
report.add_columns(page_index=0, widths=[5, 5, 5], style={...})

Adding Rows and Cells

rows = report.add_rows(page_index=0, columns_index=0, heights=[1, 1, 1], style={...})
rows.set_cell(0, 0, "{col1}", style={"font-weight": "bold"})
rows.set_cell(1, 0, "{sum:col2}", format="F2")

Or directly via report:

report.set_cell(0, 1, "Some value", page_index=0, columns_index=0, rows_index=0)

Data Binding

Use {column_name} in cell data to bind to data source columns.
Use {sum:column_name} for aggregation in table footers or group footers.

Grouping and Aggregation

rows.add_table_group(
    groupby="col1",
    header=Q2Report_rows(...),
    footer=Q2Report_rows(...)
)

Rendering

report.run(output_file="output.pdf", data=data)

Supported output types: "html", "pdf", "xlsx", "docx"

Features

Flexible styling: Inherit and override styles at any level.
Data-driven: Bind data sources to tables, rows, and cells.
Aggregates: Built-in support for {sum:col} and similar formulas.
Grouping: Group rows by one or more columns, with group headers/footers.
Images: Embed images using {q2image(path)} or cell format "I".
Multi-format output: Export to HTML, PDF, XLSX, DOCX.
Custom formulas: Use Python expressions in {...}.

Example

from q2report.q2report import Q2Report

report = Q2Report()
report.add_page()
report.add_columns(widths=[5, 5, 5])
rows = report.add_rows(heights=[1, 1, 1])
rows.set_cell(0, 0, "Header 1", style={"font-weight": "bold"})
rows.set_cell(0, 1, "Header 2", style={"font-weight": "bold"})
rows.set_cell(1, 0, "{col1}")
rows.set_cell(1, 1, "{col2:F2}")
report.run(output_file="report.pdf", data={"data_source": [{"col1": "A", "col2": 123456}]})

Advanced

Custom styles: Use Q2Report.make_style(...) to generate style dicts.
Direct JSON: You can load report definitions from JSON files or strings.
Accessing data: Use report.d.<dataset> for advanced row access in formulas.

Metadata

Release files for q2report 0.1.66

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for q2report 0.1.66
File	Size	Uploaded
q2report-0.1.66.tar.gz	41.1 kB	Jun 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for q2report 0.1.66
File	Interpreter	ABI	Platform	Reset
q2report-0.1.66-py3-none-any.whl 48.9 kB Jun 15, 2026	Python 3	none	any	Details

Total release size: 90.0 kB

Release files / q2report-0.1.66.tar.gz

Download URL	q2report-0.1.66.tar.gz
Size	41.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`5438d96e90864802c7e92450354d8f66f01e9d5771f066cb3f9162fac527f96a`
BLAKE2b-256 checksum How to use checksums	`8bd20e3ea4d4e8ce65b3972e043d95f0717a4d83463a14a0c1c0cec8340a4819`
Upload date	Jun 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.0 CPython/3.11.7 Windows/10`

Release files / q2report-0.1.66-py3-none-any.whl

Download URL	q2report-0.1.66-py3-none-any.whl
Size	48.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8b8904660db759738cf9ff755e8aa6f81f4e236f4eee8ea6f102c5c96669cbfa`
BLAKE2b-256 checksum How to use checksums	`ec0d13c1abbc3198d359ff5c7803892218355d0d8444e5f117f776ce8aeb2db8`
Upload date	Jun 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.0 CPython/3.11.7 Windows/10`