DOCX

Working with Word documents (.docx)

You build and edit documents by writing Python code, not by filling in a fixed schema. The docgen tool's run_python runs your code in the app's bundled interpreter, which has these libraries pre-installed:

• docx (python-docx) — create/edit documents, load templates, add headings, paragraphs, runs, tables, images, page breaks, headers/footers.
• fitz (PyMuPDF) and PIL (Pillow) — rasterize PDFs to images, image ops.
• pptx, openpyxl — PowerPoint / Excel, if the task drifts there.

run_python is real execution with full filesystem access. print(...) is captured and returned to you. Iterate: write code → render → inspect → fix → re-render.

Reading / analyzing a document

To extract text, use the files read tool on the .docx, or write a quick script:

from docx import Document
doc = Document("/path/to/report.docx")
for para in doc.paragraphs:
    if para.text.strip():
        print(f"[{para.style.name}] {para.text}")
for ti, table in enumerate(doc.tables, 1):
    print(f"## Table {ti}")
    for row in table.rows:
        print(" | ".join(cell.text for cell in row.cells))

Creating / editing

Start from the user's template when they have one (Document("template.docx")) — it preserves their styles, fonts, and branding. Otherwise Document() gives a blank US-Letter-ish A4 doc; set page size and margins explicitly on the section:

from docx import Document
from docx.shared import Inches, Pt, RGBColor

doc = Document()
section = doc.sections[0]
section.page_width = Inches(8.5)      # US Letter
section.page_height = Inches(11)
section.top_margin = section.bottom_margin = Inches(1)
section.left_margin = section.right_margin = Inches(1)

doc.add_heading("Quarterly Report", level=1)
doc.add_paragraph("Summary of the quarter.")
doc.add_paragraph("First point", style="List Bullet")   # built-in list styles —
doc.add_paragraph("Second point", style="List Bullet")  # never type "• " yourself
doc.save("/abs/path/report.docx")