Cómo imprimir archivos PDF con Python

¿Qué es IronPDF y cómo ayuda con la impresión de PDF?

IronPDF es una biblioteca de Python que permite a los desarrolladores generar, manipular y convertir documentos PDF. El soporte de impresión de la biblioteca cubre dos patrones: salida directa a la impresora predeterminada con una sola llamada de método y acceso a nivel de documento a PrinterSettings para control completo de la impresora.

Con IronPDF, la complejidad subyacente de la comunicación con la impresora es manejada por la biblioteca. Los desarrolladores trabajan con una API de alto nivel en lugar de manejar interacciones del spooler de impresión a nivel del sistema operativo, comandos subprocess, o utilidades de impresión específicas de la plataforma. Esto significa que el mismo código de Python funciona en Windows, Linux y macOS sin modificaciones.

Una capacidad clave es la capacidad de convertir HTML, CSS y JavaScript en PDF antes de imprimir, lo que es útil cuando el material fuente es una plantilla web o un informe dinámico en lugar de un archivo existente. Para más sobre esto, mira el tutorial HTML a PDF. La biblioteca también admite fusión de PDFs antes de imprimir y compresión de PDFs para reducir el tiempo de transferencia de spool para documentos grandes.

¿Cómo instalo IronPDF for Python?

El paquete IronPDF está disponible en PyPI e instala con un solo comando pip.

 pip install ironpdf

Después de la instalación, agrega la declaración de importación en la parte superior de tu script:

from ironpdf import *

from ironpdf import *

IronPDF requiere Python 3.6 o posterior. El paquete descarga automáticamente el motor de renderizado de IronPDF en el primer uso, por lo que la importación inicial puede tardar un momento. Para entornos con acceso saliente restringido, consulta la guía de configuración del motor de IronPDF para opciones de configuración fuera de línea.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

¿Cómo cargo un archivo PDF para imprimir?

Cargando un PDF desde el sistema de archivos en un objeto PdfDocument usando IronPDF for Python.

IronPDF carga archivos PDF desde el sistema de archivos usando PdfDocument.FromFile(). El método acepta una cadena de ruta de archivo y devuelve un objeto PdfDocument listo para imprimir, manipular o inspeccionar.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

El código anterior demuestra tres patrones de carga. FromFile() es el más común para flujos de trabajo de sistema de archivos. FromBytes() es útil cuando el PDF llega como datos binarios de una consulta de base de datos o respuesta de API. El parámetro opcional de contraseña en FromFile() maneja PDFs encriptados sin ningún paso adicional de desencriptado.

Para PDFs originados de una URL o contenido HTML, IronPDF también puede convertir una URL a PDF o renderizar un archivo HTML a PDF antes de imprimir.

¿Cómo imprimo un PDF usando la configuración predeterminada?

A Python script using IronPDF's `Print()` method sends a PDF job to the system default printer.

El método Print() envía el documento a la impresora predeterminada del sistema usando configuraciones de página predeterminadas. No se necesita configuración adicional.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

La configuración predeterminada utiliza la impresora predeterminada configurada en el sistema, imprime todas las páginas, aplica el tamaño de papel y la orientación predeterminados de la impresora, y envía una copia. Esta es la elección correcta para flujos de trabajo simples donde la configuración del usuario ya coincide con los requisitos del documento.

Para código de producción, envuelva la llamada de impresión en un manejo de errores para capturar errores de impresora fuera de línea o de permisos:

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

El mensaje de excepción proporciona detalles a nivel del sistema operativo sobre la falla de impresión, por ejemplo, si la impresora está fuera de línea, el spooler está en pausa, o el documento no se pudo renderizar.

¿Cómo personalizo la configuración de impresión antes de imprimir?

IronPDF's `GetPrintDocument()` method returns a PrintDocument object with full access to PrinterSettings properties.

GetPrintDocument() devuelve un objeto PrintDocument que expone la API completa PrinterSettings. Esto permite seleccionar una impresora por nombre, establecer rangos de páginas, controlar copias y colación, y configurar modo dúplex antes de enviar el trabajo.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

La propiedad PrinterSettings.PrinterName acepta el nombre de pantalla de la impresora tal como aparece en la lista de impresoras del sistema operativo. En Windows, esto coincide con el nombre mostrado en "Dispositivos e impresoras". En Linux, corresponde al nombre de la impresora CUPS. Configurar un nombre de impresora inválido hará que el trabajo de impresión falle en tiempo de ejecución, así que valide el nombre contra la lista de impresoras instaladas al construir diálogos de impresión orientados al usuario.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

¿Cuáles son los próximos pasos para la impresión de PDFs en Python?

Esta guía cubrió los dos patrones de impresión principales en IronPDF for Python: salida a la impresora predeterminada con pdf.Print() y salida con configuraciones personalizadas con pdf.GetPrintDocument(). Ambos enfoques funcionan en Windows, Linux y macOS sin código específico de la plataforma.

Para extender estos patrones en una aplicación de producción, considere:

• Rellenar formularios PDF antes de imprimir para producir documentos completados desde plantillas
• Agregar marcas de agua o firmas digitales antes de enviar a la impresora
• Convertir HTML a PDF para imprimir informes dinámicos desde plantillas web
• Extraer texto de documentos impresos para el registro de auditoría

Start with a free trial license to test printing in your environment. Opciones de licencia comienzan desde $999 para implementación en producción.

Descarga el código fuente completo usado en esta guía.