---
name: render_table_page_pdfpages
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "render_table_page_pdfpages(pdf: PdfPages, title: str, rows: list[list[str]], col_labels: list[str], max_rows: int = 28, figsize: tuple[float, float] = (11.69, 8.27), fontsize: int = 8, dpi: int = 300) -> None"
description: "Renderiza filas como páginas de tabla paginadas en un PdfPages abierto. Usa matplotlib.pyplot.table con paginación automática por max_rows. Una página A4 landscape por chunk."
tags: [pdf, matplotlib, table, report, infra, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [matplotlib]
params:
  - name: pdf
    desc: "Objeto PdfPages abierto de matplotlib donde se escriben las páginas."
  - name: title
    desc: "Título mostrado encima de la tabla en cada página."
  - name: rows
    desc: "Lista de filas; cada fila es una lista de strings con los valores de celda."
  - name: col_labels
    desc: "Etiquetas de las columnas (cabecera de tabla)."
  - name: max_rows
    desc: "Número máximo de filas por página antes de crear una nueva (default 28)."
  - name: figsize
    desc: "Tamaño de figura en pulgadas. Default A4 landscape (11.69x8.27)."
  - name: fontsize
    desc: "Tamaño de fuente para las celdas de la tabla."
  - name: dpi
    desc: "Resolución al guardar cada página (default 300)."
output: "None. Escribe páginas directamente en el PdfPages proporcionado."
tested: true
tests:
  - "50 filas con max_rows=28 genera 2 paginas en pdf no vacio"
  - "0 filas genera 1 pagina vacia sin excepcion"
test_file_path: "python/functions/infra/tests/test_render_table_page_pdfpages.py"
file_path: "python/functions/infra/render_table_page_pdfpages.py"
source_repo: "internal:footprint_aurgi"
source_license: "internal-aurgi"
source_file: "ponderacion_isochronas/src/recomendador_centros.py"
---

## Ejemplo

```python
import matplotlib
matplotlib.use("Agg")
from matplotlib.backends.backend_pdf import PdfPages

rows = [[str(i), f"valor_{i}"] for i in range(50)]
with PdfPages("tabla.pdf") as pdf:
    render_table_page_pdfpages(pdf, "Informe de centros", rows, ["ID", "Valor"])
```

## Notas

Requiere `matplotlib`. Backend Agg recomendado en entornos sin pantalla.
Cada chunk de filas genera exactamente una página. Con rows vacío genera una página vacía.
