carol-pdf-generator

carol_pdf_generator

carol_pdf_generator is a Python library for creating PDF Files from images (png, jpg) file. Base64 encoded is also supported.

Installation

Use the package manager pip <https://pip.pypa.io/en/stable/>__ to install foobar.

.. code:: bash

pip install carol_pdf_generator

Usage

.. code:: python

from carol_pdf_generator import get_from_file_list, get_from_base64_list
from urllib import request

file_list = [
    'jpgfile.jpg',
    'pngfile.png'
]

base64_images.append(request.urlopen('https://pastebin.com/raw/k3VZeNHW').read().decode('latin1'))
base64_images.append(request.urlopen('https://pastebin.com/raw/CaZJ7n6s').read().decode('latin1'))
base64_images.append(request.urlopen('https://pastebin.com/raw/7Asb2iMJ').read().decode('latin1'))

from_file = get_from_file_list(file_list)

base64 = get_from_base64_list(base64_images, 'test.pdf')  # Returns the PDF base64 encoded data uri and saves the PDF to test.pdf

Document Scan and auto rotation

This library can automatic try to identify paper documents and rotate the image to better fits the PDF Document.

.. code:: python

base64_jpg = str(DataURI.make(
        mimetype='image/jpeg',
        charset='latin1',
        base64=True,
        data=request.urlopen('https://raw.githubusercontent.com/danielgatis/docscan/master/examples/doc-1.jpg').read().decode('latin-1')
    ))

base64_png_2 = str(DataURI.make(
        mimetype='image/png',
        charset='latin1',
        base64=True,
        data=request.urlopen('https://raw.githubusercontent.com/danielgatis/docscan/master/examples/doc-2.png').read().decode('latin-1')
    ))

base64_jpg_3 = str(DataURI.make(
    mimetype='image/jpeg',
    charset='latin1',
    base64=True,
    data=request.urlopen('https://raw.githubusercontent.com/danielgatis/docscan/master/examples/doc-3.jpg').read().decode('latin-1')
))

base64_images = [
    base64_jpg,
    base64_png_2,
    base64_jpg_3
]

# Returns the PDF base64 encoded data uri and saves the PDF to test.pdf, correcting the document geometry and auto rotating the images
pdf = get_from_base64_list(base64_images, auto_rotate=True, scan_docs=True, output_file="test.pdf")

Merging PDF and images

This library you can create a PDF file merging PDF, JPEG and PNG files. Just use merge_pdfs() function using a List() of base64 encoded files as parameter.

.. code:: python

from carol_pdf_generator.carol_pdf_generator import merge_pdfs
files = [
    base64_jpg,
    DataURI.from_file("test.pdf"),
    base64_jpg1,
    DataURI.from_file("test2.pdf"),
    base64_jpg2,
    DataURI.from_file("test3.pdf")
]

data = DataURI(merge_pdfs(files))
b = BytesIO(data.data) ## Some random BytesIO Object
with open("test333.pdf", "wb") as f:
    f.write(b.getbuffer())

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

======= History

0.1.0 (2020-09-15)

• First release on PyPI.