Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Add a grid on top of all pages of a PDF document.

Project Description

Pdfgrid is a Python command-line tool and module for adding a regular grid on top of all pages of an existing PDF document. It will mostly be used for measuring individual parts of PDF pages like graphics or paragraph widths. For the time being, only a rectangular grid with major and minor lines is supported, and their colour and line widths can be set individually.

NOTE: This is an initial release. The API is likely to change and for the time being the grid size is limited to A4, but this will change in future releases.

Pdfgrid depends on two Open Source libraries, namely pyPdf, a package written by Mathieu Fenniak and reportlab by ReportLab, Ltd.

This version fixes an issue with the manual installation.


  • add regular rectangular grid over all pages of a PDF document
  • define grid origin on all PDF pages
  • define grid styles containing grid step, line width and colour
  • use multiple grids at once with different styling
  • install a Python module named
  • install a Python command-line script named pdfgrid
  • provide a Unittest test suite


You can use pdfgrid as a Python module e.g. like in the following interactive Python session:

>>> from reportlab.lib.colors import red
>>> from reportlab.lib.units import cm
>>> from pdfgrid import grid
>>> grid("foo.pdf", origin=(0, 0), styles=[(1*cm, 0.1, red)])
written: foo-grid.pdf

In addition there is a script named pdfscript, which can be used from the system command-line e.g. like this:

$ pdfgrid -h
$ pdfgrid -v
$ pdfgrid --origin "0,0" --styles "1*cm,0.1," foo.pdf
written: foo-grid.pdf
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pdfgrid-0.2.0-py2.5.egg (7.7 kB) Copy SHA256 Checksum SHA256 2.5 Egg Jun 7, 2009
pdfgrid-0.2.0-py2.6.egg (7.7 kB) Copy SHA256 Checksum SHA256 2.6 Egg Jun 7, 2009
pdfgrid-0.2.0.tar.gz (38.9 kB) Copy SHA256 Checksum SHA256 Source Jun 7, 2009

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting