pdf-gen-fallback-501bcc

PDF Generation Fallback Pattern

When to Use

Apply this pattern when execute_code_sandbox returns opaque or unhelpful errors during PDF, DOCX, or other document generation tasks. This fallback uses run_shell with direct python -c execution for more reliable document generation.

Step-by-Step Procedure

1. Detect Sandbox Failure

If execute_code_sandbox fails during document generation with errors like:

• Opaque runtime errors
• Missing library errors that don't resolve with import statements
• Silent failures with no output

Proceed to the fallback approach.

2. Check Library Availability

Before generating documents, verify the required Python libraries are available in the shell environment:

python -c "import reportlab; print('OK')" 2>&1 || echo "reportlab missing"
python -c "import fpdf; print('OK')" 2>&1 || echo "fpdf missing"
python -c "import pypdf; print('OK')" 2>&1 || echo "pypdf missing"
python -c "import docx; print('OK')" 2>&1 || echo "python-docx missing"

3. Install Missing Libraries (If Needed)

If a library is missing, install it via pip:

pip install reportlab fpdf2 pypdf python-docx

4. Execute Document Generation via run_shell

Use run_shell with python -c and multi-line strings for document generation:

python -c "
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas

c = canvas.Canvas('output.pdf', pagesize=letter)
c.drawString(100, 750, 'Document Title')
c.drawString(100, 700, 'Content here')
c.save()
print('SUCCESS: PDF created')
"

For DOCX files:

python -c "
from docx import Document

doc = Document()
doc.add_heading('Document Title', 0)
doc.add_paragraph('Content here')
doc.save('output.docx')
print('SUCCESS: DOCX created')
"

5. Include Explicit Error Handling

Always wrap generation code with try/except for clear error reporting:

python -c "
try:
    from reportlab.lib.pagesizes import letter
    from reportlab.pdfgen import canvas
    
    c = canvas.Canvas('output.pdf', pagesize=letter)
    c.drawString(100, 750, 'Content')
    c.save()
    print('SUCCESS')
except ImportError as e:
    print(f'MISSING_LIBRARY: {e}')
    exit(1)
except Exception as e:
    print(f'GENERATION_ERROR: {e}')
    exit(1)
"