bundle.latex¶

LaTeX document generation module. Provides building blocks to compose and compile PDF documents from Python.

Public API¶

Class / Function	Module	Description
`Document`	`document.py`	Full document builder (preamble, packages, theme, sections). Compiles to PDF via `pdflatex`.
`Section`	`elements.py`	Section/subsection container. Supports text, figures, and tables as child blocks.
`Table`	`elements.py`	`longtable`-based table with column definitions, alternating row colors, and multi-page support.
`Column`	`elements.py`	Column definition (header, alignment, optional fixed width).
`Figure`	`elements.py`	`\includegraphics` wrapper with optional caption.
`escape()`	`elements.py`	Escape special LaTeX characters (`_`, `#`, `%`, `&`, `$`, `{`, `}`) and Unicode symbols.

Usage¶

from bundle.latex import Document, Section, Table, Figure, escape
from bundle.latex.elements import Column

doc = Document(title="My Report", landscape=True)

section = Section("Results")
section.add_text("Some description here.")
section.add_figure(Figure("/tmp/plot.png"))

table = Table(
    columns=[
        Column("Name", width="4cm", align="l"),
        Column("Value", align="r"),
    ],
    row_color_alt="rowalt",
)
table.add_row([escape("my_var"), "42"])
section.add_table(table)

doc.add_section(section)
doc.save_pdf("output.pdf")

Theme¶

Document uses DARK_THEME by default (dark background, light text). Pass a custom Theme instance to override colors.

Dependencies¶

latex (Python package wrapping pdflatex)
TeX Live (texlive-latex-base, texlive-latex-extra, texlive-fonts-recommended)