pycpdf 1.0.4

Extract content and metadata from PDF files efficiently

pycpdf - Extract content and metadata from PDF files efficiently

pycpdf is a Python extension to enable read-only access to the contents of PDF files. It is similar to PyPDF/PyPDF2 except that it is read-only, is much quicker, and has some of the bugs fixed.

Usage

The main class is pycpdf.PDF, which is given the PDF data as a byte-string and, optionally, a decryption password. This object has the following properties:

• pages: a list of Page objects
• version: the PDF file format version as a string (e.g. "1.6")
• info: the Document Information Dictionary, or None
• linearized: the Linearization Parameter Dictionary, or None
• catalog: the Document Catalog dictionary
• trailer: the trailer dictionary

Page objects are similar to dictionaries, but they have the following two extra properties:

• text: the textual contents of the page
• contents: a list of the PDF operators that comprise the page contents

StreamObject objects are also similar to dictionaries, but have the following two extra properties:

• data: the binary data contained within the stream
• contents: the binary data parsed as a list of PDF operators

Unicode string simplification

The module also contains unicode_translations, which is a dictionary suitable for passing to str.translate to simplify Unicode strings somewhat:

• replace various spaces (00A0, 2000-200A, 3000) with an ASCII space
• remove soft hyphens (00AD) and zero width space (200B)
• replace various hyphens (2010-2014, 2212) with an ASCII hyphen
• replace various sexed quotation marks (2018, 2019, 201C, 201D) with the equivalent unsexed ASCII quotation marks
• replace the horizontal ellipsis character (2026) with '...'
• replace various latin ligatures (ae, dz, ff, fi, fl, ffi, ffl, st) with their equivalent ASCII character strings

Example

pdf = pycpdf.PDF(open('file.pdf', 'rb').read())
if pdf.info and pdf.info.get('Title'):
    print('Title:', pdf.info['Title'])
for pageno, page in enumerate(pdf.pages):
    print('Page', pageno + 1)
    print(page.text.translate(pycpdf.unicode_translations))

Notes

All strings are always Unicode. Note that, unlike in PyPDF, name objects do not start with a forward slash / - i.e. you should reference obj['Type'] not obj['/Type']. This is because the PDF Reference unequivocally states that the slash is not part of the name.

The page.text property lists the textual contents of the page in the order that the relevant operators occur. It may sometimes be out of order, and there may be unexpected spacing.

If container objects (arrays and dictionaries) contain indirect objects then these objects will not be extracted from the PDF file until they are referenced for the first time. This is to enable opening large PDF files efficiently. Altering the contents of container objects is not actively prevented but should never be done and will lead to undefined behaviour.

The intention of the extension is to allow fast low-level access to all the internal structures of PDF files. Higher-level interfaces could be added in Python to allow, for example, better text extraction or access to images.

Some encryption and image encoding methods are not currently supported.

History

1.0.4 (2018-04-18)

• Bug fixes to do with in-line images

1.0.3 (2017-11-26)

• Bug-fixed StreamObject.contents
• When decoding text, if ToUnicode fails, fall back to Encoding

1.0.2 (2017-11-26)

• Extended documentation slightly.
• Added Travis auto-deployment to PyPI.
• Added pycpdf.__version__

1.0.1 (2017-11-23)

• Initial release.