Skip to main content

PDF generation in python using wkhtmltopdf suitable for heroku

Project description

codecov.io Build Status PyPI

PDF generation in python using wkhtmltopdf.

Wkhtmltopdf binaries are precompiled and included in the package making pydf easier to use, in particular this means pydf works on heroku.

Based on pywkher but significantly extended.

Currently using wkhtmltopdf v. 0.12.2 (beta).

Install

pip install python-pdf

(pydf was taken, but I guess python-pdf is a clearer name anyway.)

Basic Usage

import pydf
pdf = pydf.generate_pdf('<h1>this is html</h1>')
open('test_doc.pdf', 'w').write(pdf)

pdf = pydf.generate_pdf('www.google.com')
open('google.pdf', 'w').write(pdf)

API

generate_pdf(source, [**kwrags])

Generate a pdf from either a url or a html string.

After the html and url arguments all other arguments are passed straight to wkhtmltopdf

For details on extra arguments see the output of get_help() and get_extended_help()

All arguments whether specified or caught with extra_kwargs are converted to command line args with '--' + original_name.replace('_', '-').

Arguments which are True are passed with no value eg. just –quiet, False and None arguments are missed, everything else is passed with str(value).

Arguments:

  • source: html string to generate pdf from or url to get

  • quiet: bool

  • grayscale: bool

  • lowquality: bool

  • margin_bottom: string eg. 10mm

  • margin_left: string eg. 10mm

  • margin_right: string eg. 10mm

  • margin_top: string eg. 10mm

  • orientation: Portrait or Landscape

  • page_height: string eg. 10mm

  • page_width: string eg. 10mm

  • page_size: string: A4, Letter, etc.

  • image_dpi: int default 600

  • image_quality: int default 94

  • extra_kwargs: any exotic extra options for wkhtmltopdf

Returns string representing pdf

get_version()

Get version of pydf and wkhtmltopdf binary

get_help()

get help string from wkhtmltopdf binary uses -h command line option

get_extended_help()

get extended help string from wkhtmltopdf binary uses -H command line option

execute_wk(*args)

Low level function to call wkhtmltopdf, arguments are added to wkhtmltopdf binary and passed to subprocess with not processing.

Project details


Download files

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

Source Distribution

python-pdf-0.23.tar.gz (14.6 MB view details)

Uploaded Source

Built Distribution

python_pdf-0.23-py2.py3-none-any.whl (14.7 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file python-pdf-0.23.tar.gz.

File metadata

  • Download URL: python-pdf-0.23.tar.gz
  • Upload date:
  • Size: 14.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for python-pdf-0.23.tar.gz
Algorithm Hash digest
SHA256 aa5ea2ecc6aa3991ed9ecafe4f79791919c7d8e82d24c67a8c3b8eb399c705ac
MD5 94620bb34fbeb326f30fa623650d574a
BLAKE2b-256 a1e1c2be90da8fd8dca9639030fe824cb6219749a4108c4e0620b07c06ed2d79

See more details on using hashes here.

Provenance

File details

Details for the file python_pdf-0.23-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_pdf-0.23-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a9ba7275f086ac27674d8022f224fa9cd9880bca19927f8d772c7e125dcd7683
MD5 9f82ad12068e14e5feb9049a35a93acc
BLAKE2b-256 53a8a746e70ad0b508353a534c1dec08846ed3c8a4c2067c68f268b96e0b6c88

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page