Async PDF Generation

from ironpdf import *

# Instantiate Renderer
renderer = ChromePdfRenderer()

# All IronPdf Rendering methods have Async equivalents
task = renderer.RenderHtmlAsPdfAsync("<h1>Html with CSS and Images</h1>")
task.Wait() #wait
pdf = task.Result

# Export to a file or Stream
pdf.SaveAs("async.pdf")

Async PDF Generation

IronPDF for Python provides asynchronous equivalents for all rendering methods, allowing PDF generation to run without blocking the calling thread.

Getting Started

Call the async variant of any render method — for example, RenderHtmlAsPdfAsync — to receive a task object. Call .Wait() on the task to block until rendering is complete, then access the result through the .Result property.

Understanding the Code

RenderHtmlAsPdfAsync(html): Begins rendering the provided HTML string on a background thread and returns a task object immediately.
task.Wait(): Blocks the current thread until the background render task has finished. Use this when you need the result before proceeding.
task.Result: The completed PdfDocument object produced by the async render call.
SaveAs: Saves the resulting PDF to the specified file path.

Async Rendering Methods

All standard IronPDF render methods have async counterparts:

RenderHtmlAsPdfAsync
RenderUrlAsPdfAsync
RenderHtmlFileAsPdfAsync

When to Use Async Rendering

Async rendering is beneficial in web server or GUI application contexts where you want to keep the main thread responsive while a potentially long-running PDF generation task runs in the background.

Learn to generate PDFs with IronPDF for Python!