Generate a presentation in Python

npm init -y
npm install --save-dev @openpresentation/cli@0.31.0 @openpresentation/opf-render@0.31.0 @openpresentation/opf-pptx@0.31.0
npm install --save-dev @expo-google-fonts/roboto@0.4.3 @expo-google-fonts/roboto-mono@0.4.2 @expo-google-fonts/caladea@0.4.2 @expo-google-fonts/arimo@0.4.3 @expo-google-fonts/tinos@0.4.2 @expo-google-fonts/cousine@0.4.3 @expo-google-fonts/gelasio@0.4.1 @expo-google-fonts/noto-sans@0.4.2

"""Validate an OPF deck and export it to PPTX and PDF with the OPF CLI.

Run it in a folder where the OPF CLI and its export packages are installed.
"""
import json
import subprocess
import sys
from pathlib import Path

deck = {
    "$schema": "https://openpresentation.org/schema/opf/v1",
    "name": "Q2 retention update",
    "language": "en-US",
    "slides": [
        {"title": "Q2 retention update", "subtitle": "Board of Directors"},
        {"title": "What changed", "items": ["Renewals rose in the pilot", "Fewer support escalations"]},
        {"title": "Next quarter", "text": "Extend the pilot to two more regions."},
    ],
}


def opf(*args):
    """Run an opf command and return its JSON report. Exit if the command failed."""
    result = subprocess.run(["npx", "opf", *args], capture_output=True, text=True)
    report = json.loads(result.stdout)
    if result.returncode != 0:
        sys.exit(f"opf {args[0]} failed: {report.get('error') or report['findings']}")
    return report


Path("deck.opf.json").write_text(json.dumps(deck, indent=2))

report = opf("validate", "deck.opf.json")
print("valid:", report["valid"], report["counts"])

for target in ("deck.pptx", "deck.pdf"):
    result = opf("convert", "deck.opf.json", target, "--force")
    print("wrote", target, result["outputs"][0]["bytes"], "bytes")

valid: True {'error': 0, 'warning': 0, 'info': 0}
wrote deck.pptx 87338 bytes
wrote deck.pdf 18693 bytes

opf validate failed: [{'ruleId': 'opf/schema', 'severity': 'error', 'category': 'format', 'scope': 'document', 'path': '/x', 'message': 'must NOT have additional properties', ...}]

from typing import List, Optional

from pydantic import BaseModel, Field


class Slide(BaseModel):
    title: str
    subtitle: Optional[str] = None
    text: Optional[str] = None
    items: Optional[List[str]] = None


class Deck(BaseModel):
    schema_: str = Field("https://openpresentation.org/schema/opf/v1", alias="$schema")
    name: str
    language: str = "en-US"
    slides: List[Slide]


# The JSON text your model returned.
llm_output = '{"name": "Q2 retention update", "slides": [{"title": "What changed", "items": ["Renewals rose", "Fewer escalations"], "text": null}]}'

deck = Deck.model_validate_json(llm_output).model_dump(by_alias=True, exclude_none=True)
print(deck)

{'$schema': 'https://openpresentation.org/schema/opf/v1', 'name': 'Q2 retention update', 'language': 'en-US', 'slides': [{'title': 'What changed', 'items': ['Renewals rose', 'Fewer escalations']}]}