Create PDFs with Pure Python - Perfect For Document Automation

Generating PDFs with Python and ReportLab

Key Concepts:

• ReportLab: A Python package for creating PDF documents programmatically.
• Canvas: The core object in ReportLab used for drawing elements onto a PDF page.
• Platypus: A collection of higher-level objects (Paragraph, Table, Spacer) for easier document layout.
• SimpleDocTemplate: A template class for creating documents with predefined page sizes and styles.
• Stylesheets: Predefined or custom styles for text formatting and layout.
• UV: A Rust-based Python package manager (alternative to pip).
• Virtual Environment: An isolated Python environment for managing dependencies.

1. Introduction & Installation

The video demonstrates how to generate PDF documents using the ReportLab Python package. This is particularly useful for automating tasks like invoice creation and sales report generation. The presenter highlights the demand for PDF automation within companies.

Installation is achieved using uv install reportlab (an alternative to pip install reportlab). The presenter emphasizes the use of a virtual environment to manage project dependencies. VS Code automatically recognizes the virtual environment (3.11 tutorial in this case).

2. "Hello World" Example

The simplest example involves creating a blank PDF with the text "Hello World". This demonstrates the basic workflow:

1. Import canvas: from reportlab.pdfgen import canvas
2. Create a Canvas: c = canvas.Canvas("hello.pdf") – This initializes a canvas object linked to the specified PDF file.
3. Draw a String: c.drawString(100, 100, "Hello World") – This draws the text at the given x and y coordinates (100, 100). The coordinates represent the position relative to the bottom-left corner of the page.
4. Save the Canvas: c.save() – This finalizes the PDF and saves the changes.

The presenter demonstrates how changing the y-coordinate (e.g., to 700) alters the text's vertical position on the page.

3. Advanced Example: Sales Report

This section builds upon the basic example to create a more complex sales report featuring charts and tables.

Imports:

• from reportlab.lib import colors – For styling elements with colors.
• from reportlab.lib.pagesizes import A4 – For defining the page size.
• from reportlab.lib.styles import getSampleStyleSheet – For accessing pre-defined styles.
• from reportlab.platypus import Spacer, Paragraph, Table, SimpleDocTemplate – UI elements for document layout.
• from reportlab.graphics.charts.barcharts import VerticalBarChart – For creating bar charts.
• from reportlab.graphics.shapes import Drawing – For grouping chart elements.

Data:

Sales data for three products (Alpha, Beta, Gamma) across four quarters (Q1, Q2, Q3, Q4) is defined as a dictionary.

Table Creation:

1. Table Data: A list of lists is created, where each inner list represents a row in the table. The first row contains the header ("Product", "Q1", "Q2", "Q3", "Q4"). Subsequent rows contain the product name and corresponding sales figures.
2. Table Styling: A list of tuples is used to define table styles:
   • Grid: A grid is added with 50% opacity and gray color, spanning from the top-left (0, 0) to the bottom-right (-1, -1) cell.
   • Font: The font of the header row (0, 0 to 0, -1) is set to Helvetica-Bold.
3. Table Object: A Table object is created using the styled table data.

Chart Creation:

1. Drawing Object: A Drawing object is created at position (400, 200) to contain the chart.
2. Vertical Bar Chart: A VerticalBarChart object is created and populated with the sales data.
3. Category Axis: The category names (Q1, Q2, Q3, Q4) are assigned to the chart's category axis.
4. Value Axis: The minimum value is set to 0, and the maximum value is calculated as the maximum sales figure plus 10% for visual clarity. The value step is set to 50.

Document Assembly:

1. SimpleDocTemplate: A SimpleDocTemplate is created with the report name ("report.pdf") and page size (A4).
2. Stylesheet: A stylesheet is obtained using getSampleStyleSheet.
3. Elements: The following elements are added to the document:
   • A Paragraph with the title "Sales Report Neural 9 Tutorials 2025" styled as a title.
   • A Spacer for vertical spacing.
   • The Table object.
   • The Drawing object containing the VerticalBarChart.
4. Build: doc.build() – This builds the PDF document with the added elements.

4. Invoice Example (Code Overview)

The presenter demonstrates a more complex invoice example, but doesn't code it from scratch due to time constraints. The code utilizes:

• Images (logo).
• Paragraph for text.
• XPreformatted for pre-formatted text with line breaks.
• Table for structured data (invoice items, calculations).

The presenter directs viewers to their GitHub repository (link in the description) for the complete invoice code.

5. Conclusion

The video successfully demonstrates the capabilities of ReportLab for generating PDFs in Python. The presenter encourages viewers to like the video, subscribe to the channel, and explore their website for tutoring and services. The key takeaway is that ReportLab provides a powerful and flexible solution for automating PDF document creation, enabling tasks like invoice generation and report creation. The presenter emphasizes the availability of the code on GitHub for further exploration.

Notable Quote:

"Many companies want to automate stuff that has to do with the creation of PDFs. They want to create invoices. They want to create sales reports." – Demonstrates the practical application and business need for this skill.