The Complete Production SOP: How to Deploy and Run borb Declarative Python PDF Creator in Autonomous AI Agents

---
name: "borb-declarative-pdf-creator"
description: "Create complex PDF documents using pure Python declarative components and layouts."
metadata:
  author: "Joris Schellekens"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "create pdf with borb python"
  - "generate barcode in pdf borb"
  - "use grid layout borb pdf"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# borb Declarative Python PDF Creator SOP
Always structure documents using Document() -> Page() -> PageLayout. Never calculate raw (x,y) coordinates.

import sys
try:
    import borb
    from borb.pdf import Document, Page, SingleColumnLayout, PDF
    print(f"borb {borb.__version__} initialized successfully on Python {sys.version.split()[0]}.")
except ImportError as err:
    sys.stderr.write(f"Missing borb dependency: {err}\n")
    sys.exit(1)

from decimal import Decimal
from pathlib import Path
from borb.pdf import Document, Page, SingleColumnLayout, Paragraph, Barcode, BarcodeType, PDF
from borb.pdf.canvas.color.color import HexColor

def build_invoice(dest_path: Path):
    doc = Document()
    page = Page()
    doc.add_page(page)
    layout = SingleColumnLayout(page)

    layout.add(Paragraph("INVOICE #98214", font_size=Decimal(18), font_color=HexColor("#1a202c")))
    layout.add(Paragraph("Declarative PDF generated via borb-declarative-pdf-creator"))
    layout.add(Barcode(data="https://askills.dev/skills/borb-declarative-pdf-creator", type=BarcodeType.QR, width=Decimal(128), height=Decimal(128)))

    with open(dest_path, "wb") as pdf_out:
        PDF.dumps(pdf_out, doc)

if __name__ == "__main__":
    build_invoice(Path("output_invoice.pdf"))

import pytest
from pathlib import Path
from borb.pdf import PDF

def test_invoice_pdf_integrity(tmp_path):
    from generate_invoice import build_invoice
    target = tmp_path / "test.pdf"
    build_invoice(target)
    assert target.exists()
    assert target.stat().st_size > 0
    with open(target, "rb") as f:
        loaded = PDF.loads(f)
        assert len(loaded.get_pages()) == 1