Skip to main content

Python wrapper for PDFTK

Project description

# pypdftk [![circleci](]( [![travis](](

Python module to drive the awesome [pdftk][0] binary.

Proudly brought to you by the [revolunet][1] team and [awesome contributors](

## Features

### `fill_form`
Fill a PDF with given data and returns the output PDF path
- `pdf_path` : input PDF
- `datas` : dictionnary of fielf names / values
- `out_file` (default=auto) : output PDF path. will use tempfile if not provided
- `flatten` (default=True) : flatten the final PDF

### `concat`
Merge multiple PDFs into one single file and returns the output PDF path
- `files` : list of PDF files to concatenate
- `out_file` (default=auto) : output PDF path. will use tempfile if not provided

### `split`
Split a single PDF in many pages and return a list of pages paths
- `pdf_path` : input PDF
- `out_dir` (default=auto) : output PDFs dir. will use tempfile if not provided

**warning** if you give a out_dir parameter, ensure its empty, or the split function may destroy your files and return incorrect results.

### `gen_xfdf`
Generate a XFDF file suited for filling PDF forms and return the generated XFDF file path
- `datas` : dictionnary of datas

### `get_num_pages`
Return the number of pages for a given PDF
- `pdf_path` : input PDF file

### `replace_page`
Replace a page in a PDF (pdf_path) by the PDF pointed by pdf_to_insert_path.
- `pdf_path` is the PDF that will have its page replaced.
- `page_number` is the number of the page in pdf_path to be replaced. It is 1-based.
- `pdf_to_insert_path` is the PDF that will be inserted at the old page.

### `stamp`
Applies a stamp (from `stamp_pdf_path`) to the PDF file in `pdf_path`. If no `output_pdf_path` is provided, it returns a temporary file with the result PDF.

### `[compress | uncompress]`
These are only useful when you want to edit PDF code in a text
editor like vim or emacs. Remove PDF page stream compression by
applying the uncompress filter. Use the compress filter to
restore compression.
- `pdf_path` : input PDF file
- `out_file` (default=auto) : output PDF path. will use tempfile if not provided
- `flatten` (default=True) : flatten the final PDF

### `dump_data_fields`
Read PDF and output form field statistics.
- `pdf_path` : input PDF file

## Example

Fill a PDF model and add a cover page :


import pypdftk

datas = {
'firstname': 'Julien',
'company': 'revolunet',
'price': 42
generated_pdf = pypdftk.fill_form('/path/to/model.pdf', datas)
out_pdf = pypdftk.concat(['/path/to/cover.pdf', generated_pdf])

## pdftk path

By default, path is `/usr/bin/pdftk`, but you can override it with the `PDFTK_PATH` environment variable

## Licence
This module is released under the permissive [MIT license]( Your contributions are always welcome.


Project details

Download files

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

Files for pypdftk, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size pypdftk-0.4.tar.gz (5.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page