Metadata-Version: 2.1 Name: fpdf2 Version: 2.4.6 Summary: Simple PDF generation for Python Home-page: https://pyfpdf.github.io/fpdf2/ Author: Olivier PLATHEY ported by Max Author-email: maxpat78@yahoo.it Maintainer: David Ankin Maintainer-email: daveankin@gmail.com License: LGPLv3+ Download-URL: https://github.com/PyFPDF/fpdf2/tarball/2.4.6 Project-URL: Documentation, https://pyfpdf.github.io/fpdf2/ Project-URL: Code, https://github.com/PyFPDF/fpdf2 Project-URL: Issue tracker, https://github.com/PyFPDF/fpdf2/issues Keywords: pdf,unicode,png,jpg,ttf,barcode Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3) Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Operating System :: OS Independent Classifier: Topic :: Printing Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: Text Processing :: Markup Classifier: Topic :: Multimedia :: Graphics Classifier: Topic :: Multimedia :: Graphics :: Presentation Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: Pillow [![build status](https://github.com/PyFPDF/fpdf2/workflows/build/badge.svg)](https://github.com/PyFPDF/fpdf2/actions?query=branch%3Amaster) [![Pypi latest version](https://img.shields.io/pypi/v/fpdf2.svg)](https://pypi.python.org/pypi/fpdf2) [![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0) [![codecov](https://codecov.io/gh/PyFPDF/fpdf2/branch/master/graph/badge.svg)](https://codecov.io/gh/PyFPDF/fpdf2) [![Downloads per month](https://pepy.tech/badge/fpdf2/month)](https://pepy.tech/project/fpdf2) [![Discussions](https://img.shields.io/github/discussions/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/discussions) [![Pull Requests Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](http://makeapullrequest.com) [![first-timers-only Friendly](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](http://www.firsttimersonly.com/) -> come look at our [good first issues](https://github.com/PyFPDF/fpdf2/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) fpdf2 ===== ![fpdf2 logo](https://pyfpdf.github.io/fpdf2/fpdf2-logo.png) `fpdf2` is a minimalist PDF creation library for Python: ```python from fpdf import FPDF pdf = FPDF() pdf.add_page() pdf.set_font('helvetica', size=12) pdf.cell(txt="hello world") pdf.output("hello_world.pdf") ``` It is a fork and the successor of `PyFPDF`. Compared with other PDF libraries, `fpdf2` is simple, small and versatile, with advanced capabilities, and is easy to learn and extend. It is also entirely writen in Python (no C is involved), and has only **one** dependency so far, to handle images: [Pillow](https://pillow.readthedocs.io/en/stable/). **Development status**: this project is **mature** and **actively maintained**. We are looking for contributing developers: if you want to get involved but don't know how, or would like to volunteer helping maintain this lib, [open a discussion](https://github.com/PyFPDF/fpdf2/discussions)! Installation Instructions: -------------------------- ```bash pip install fpdf2 ``` To get the latest development version: ```bash # Linux only: sudo apt-get install libjpeg-dev libpython-dev zlib1g-dev # Linux and Windows: git clone https://github.com/PyFPDF/fpdf2.git cd fpdf2 python setup.py install ``` Features: --------- * Python 3.6+ support * Unicode (UTF-8) TrueType font subset embedding * Internal/External Links * PNG, GIF and JPG support (including transparency and alpha channel) * Shape, Line Drawing * Generate [Code 39](https://fr.wikipedia.org/wiki/Code_39) & [Interleaved 2 of 5](https://en.wikipedia.org/wiki/Interleaved_2_of_5) barcodes * Cell / multi-cell / plaintext writing, automatic page breaks * Basic [conversion from HTML to PDF](https://pyfpdf.github.io/fpdf2/HTML.html) * A [templating system](https://pyfpdf.github.io/fpdf2/Templates.html) to render PDFs in batchs * Images & links alternative descriptions * Table of contents & [document outline](https://pyfpdf.github.io/fpdf2/DocumentOutlineAndTableOfContents.html) * Optional basic Markdown-like styling: `**bold**, __italics__, --underlined--` * Clean error handling through exceptions * Unit tests with `qpdf`-based PDF diffing and a high code coverage We validate all our PDF samples using 3 different checkers: [![QPDF logo](https://pyfpdf.github.io/fpdf2/qpdf-logo.svg)](https://github.com/qpdf/qpdf) [![PDF Checker logo](https://pyfpdf.github.io/fpdf2/pdfchecker-logo.png)](https://www.datalogics.com/products/pdf-tools/pdf-checker/) [![VeraPDF logo](https://pyfpdf.github.io/fpdf2/vera-logo.jpg)](https://verapdf.org) Documentation: -------------- - [Documentation Home](https://pyfpdf.github.io/fpdf2/) - Tutorial in several languages: [English](https://pyfpdf.github.io/fpdf2/Tutorial.html) - [Deutsch](https://pyfpdf.github.io/fpdf2/Tutorial-de.html) - [español](https://pyfpdf.github.io/fpdf2/Tutorial-es.html) - [हिंदी](https://pyfpdf.github.io/fpdf2/Tutorial-हिंदी.html) [português](https://pyfpdf.github.io/fpdf2/Tutorial-pt.html) - [Русский](https://pyfpdf.github.io/fpdf2/Tutorial-ru.html) - [Italian](https://pyfpdf.github.io/fpdf2/Tutorial-it.html) - [français](https://pyfpdf.github.io/fpdf2/Tutorial-fr.html) - Release notes: [CHANGELOG.md](https://github.com/PyFPDF/fpdf2/blob/master/CHANGELOG.md) You can also have a look at the `tests/`, they're great usage examples! Developers: ----------- Please check [the documentation page dedicated to development](https://pyfpdf.github.io/fpdf2/Development.html). ## Contributors ✨ This library could only exist thanks to the dedication of many volunteers around the world:

Mariano Reingart
💻
David Ankin
🐛 💻 📖 🚧 💬 👀 ⚠️
Alex Pavlovich
🐛 💻 📖 💬 👀 ⚠️
Lucas Cimon
📝 💻 📖 🚇 🚧 💬
Miroslav Šedivý
💻 ⚠️
Florian Bernhart
💻 ⚠️
Edwood Ocasio
💻 ⚠️

Marcelo Duarte
💻
Roman Kharin
💻 🤔
Christopher Frost
🐛 💻
Michael Kalbermatten
🐛 💻
Yanone
💻
Leo Zhu
💻
Abishek Goda
💻

Arthur Moore
💻 ⚠️ 🐛
Bogdan Cuza
💻
Craig Hobbs
💻
xitrushiy
🐛 💻
José L. Redrejo Rodríguez
💻
Jürgen Gmach
💻
Larivact
💻

Leonel Câmara
💻
Mark Steadman
🐛 💻
Sergey
💻
Stan-C421
💻
Viraj Shah
💻
cornicis
💻
moe-25
💻 👀 🔬 🐛

Simone Bizzotto
💻
Boonyawe Sirimaha
🐛
T
💻 🎨
AubsUK
💬
Georg Mischler
💻 🐛 📖 🤔 💬
ping
🐛
Portfedh
📖 ✅

Tabarnhack
💻
Mridul Birla
🌍
digidigital
🌍
Xit
🌍
Alexander Burchenko
🌍
André Assunção
🌍
Quentin Brault
🌍

Paula Campigotto
🐛 💻 👀
bettman-latin
💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification ([emoji key](https://allcontributors.org/docs/en/emoji-key)). Contributions of any kind welcome! [![Contributors map](https://pyfpdf.github.io/fpdf2/contributors-map-small.png)](https://pyfpdf.github.io/fpdf2/contributors.html) _(screenshot from June 2021, click on the map above to access an up-to-date online version)_ Other libraries --------------- For alternatives, check out [this detailed list of PDF-related Python libs by Patrick Maupin](https://github.com/pmaupin/pdfrw#other-libraries). There is also `pikepdf`, `PyFPDF2` & `WeasyPrint`. Related ------- * [Create PDFs with Python](https://www.youtube.com/playlist?list=PLjNQtX45f0dR9K2sMJ5ad9wVjqslNBIC0) : a series of tutorial videos by bvalgard * [digidigital/Extensions-and-Scripts-for-pyFPDF-fpdf2](https://github.com/digidigital/Extensions-and-Scripts-for-pyFPDF-fpdf2) : scripts ported from PHP to add transpareny to elements of the page or part of an image, allow to write circular text, draw pie charts and bar diagrams, embed JavaScript, draw rectangles with rounded corners, draw a star shape, restrict the rendering of some elements to screen or printout, paint linear / radial / multi-color gradients gradients, add stamps & watermarks, write sheared text...