%global _empty_manifest_terminate_build 0 Name: python-fpdf2 Version: 2.7.3 Release: 1 Summary: Simple & fast PDF generation for Python License: LGPLv3+ URL: https://pyfpdf.github.io/fpdf2/ Source0: https://mirrors.nju.edu.cn/pypi/web/packages/ef/bb/b21a7e92f2085f3a97d4da194cc18dded2f4b35aafedde8407a8e23b655b/fpdf2-2.7.3.tar.gz BuildArch: noarch Requires: python3-defusedxml Requires: python3-Pillow Requires: python3-fonttools %description [![Pypi latest version](https://img.shields.io/pypi/v/fpdf2.svg)](https://pypi.org/pypi/fpdf2#history) [![Python Support](https://img.shields.io/pypi/pyversions/fpdf2.svg)](https://pypi.org/project/fpdf2/) [![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0) [![build status](https://github.com/PyFPDF/fpdf2/workflows/build/badge.svg)](https://github.com/PyFPDF/fpdf2/actions?query=branch%3Amaster) [![codecov](https://codecov.io/gh/PyFPDF/fpdf2/branch/master/graph/badge.svg)](https://codecov.io/gh/PyFPDF/fpdf2) ![security: bandit, pylint, semgrep](https://img.shields.io/badge/linters-bandit,pylint,semgrep-yellow.svg) [![Dependents](https://img.shields.io/librariesio/dependents/pypi/fpdf2)](https://libraries.io/pypi/fpdf2/dependents) [![Downloads per month](https://pepy.tech/badge/fpdf2/month)](https://pepy.tech/project/fpdf2) [![Contributors](https://img.shields.io/github/contributors/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/graphs/contributors) [![GitHub last commit](https://img.shields.io/github/last-commit/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/commits/master) [![issues closed](https://img.shields.io/github/issues-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/issues) [![PRs closed](https://img.shields.io/github/issues-pr-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/pulls) [![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 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") ``` Go try it **now** online in a Jupyter notebook: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) or [![Open In nbviewer](https://img.shields.io/badge/Open_In-nbviewer-blue?logo=jupyter)](https://nbviewer.org/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) Compared with other PDF libraries, `fpdf2` is **fast, versatile, easy to learn and to extend** ([example](https://github.com/digidigital/Extensions-and-Scripts-for-pyFPDF-fpdf2)). It is also entirely written in Python and has very few dependencies: [Pillow](https://pillow.readthedocs.io/en/stable/), [defusedxml](https://pypi.org/project/defusedxml/), & [fontTools](https://fonttools.readthedocs.io/en/latest/index.html). It is a fork and the successor of `PyFPDF` (_cf._ [history](https://pyfpdf.github.io/fpdf2/Development.html#history)). **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, unreleased, development version straight from the development branch of this repository: ```bash pip install git+https://github.com/PyFPDF/fpdf2.git@master ``` ## Features * Python 3.7+ support * [Unicode](https://pyfpdf.github.io/fpdf2/Unicode.html) (UTF-8) TrueType font subset embedding * Internal / external [links](https://pyfpdf.github.io/fpdf2/Links.html) * Embedding images, including transparency and alpha channel * Arbitrary path drawing and basic [SVG](https://pyfpdf.github.io/fpdf2/SVG.html) import * Embedding [barcodes](https://pyfpdf.github.io/fpdf2/Barcodes.html), [charts & graphs](https://pyfpdf.github.io/fpdf2/Maths.html), [emojis, symbols & dingbats](https://pyfpdf.github.io/fpdf2/EmojisSymbolsDingbats.html) * [Tables](https://pyfpdf.github.io/fpdf2/Tables.html) and also [cell / multi-cell / plaintext writing](https://pyfpdf.github.io/fpdf2/Text.html), with [automatic page breaks](https://pyfpdf.github.io/fpdf2/PageBreaks.html), line break and text justification * Choice of measurement unit, page format & margins. Optional page header and footer * 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, for accessibility * Table of contents & [document outline](https://pyfpdf.github.io/fpdf2/DocumentOutlineAndTableOfContents.html) * [Document encryption](https://pyfpdf.github.io/fpdf2/Encryption.html) & [document signing](https://pyfpdf.github.io/fpdf2/Signing.html) * [Annotations](https://pyfpdf.github.io/fpdf2/Annotations.html), including text highlights, and [file attachments](https://pyfpdf.github.io/fpdf2/FileAttachments.html) * [Presentation mode](https://pyfpdf.github.io/fpdf2/Presentations.html) with control over page display duration & transitions * Optional basic Markdown-like styling: `**bold**, __italics__` * Can render [mathematical equations & charts](https://pyfpdf.github.io/fpdf2/Maths.html) * Usage examples with [Django](https://www.djangoproject.com/), [Flask](https://flask.palletsprojects.com), [streamlit](https://streamlit.io/), AWS lambdas... : [Usage in web APIs](https://pyfpdf.github.io/fpdf2/UsageInWebAPI.html) * 1000+ unit tests running under Linux & Windows, with `qpdf`-based PDF diffing, timing & memory usage checks, and a high code coverage Our 350+ reference PDF test files, generated by `fpdf2`, are validated 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) ## Please show the value Choosing a project dependency can be difficult. We need to ensure stability and maintainability of our projects. Surveys show that GitHub stars count play an important factor when assessing library quality. ⭐ Please give this repository a star. It takes seconds and will help your fellow developers! ⭐ ## Please share with the community This library relies on community interactions. Please consider sharing a post about `fpdf2` and the value it provides 😊 [![GitHub Repo stars](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-hacker%20news-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-twitter-03A9F4?logo=twitter)](https://twitter.com/share?url=https://github.com/PyFPDF/fpdf2&t=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-facebook-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/shareArticle?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) ## 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) - [Ελληνικά](https://pyfpdf.github.io/fpdf2/Tutorial-gr.html) - [עברית](https://pyfpdf.github.io/fpdf2/Tutorial-he.html) - [简体中文](https://pyfpdf.github.io/fpdf2/Tutorial-zh.html) - [বাংলা](https://pyfpdf.github.io/fpdf2/Tutorial-বাংলা.html) - Release notes: [CHANGELOG.md](https://github.com/PyFPDF/fpdf2/blob/master/CHANGELOG.md) - A series of blog posts: [fpdf2 tag @ ludochaordic](https://chezsoi.org/lucas/blog/tag/fpdf2.html) You can also have a look at the `tests/`, they're great usage examples! ## Developement Please check the [dedicated documentation page](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
Mariano Reingart
💻		 David Ankin
David Ankin
🐛 💻 📖 🚧 💬 👀 ⚠️		 Alex Pavlovich
Alex Pavlovich
🐛 💻 📖 💬 👀 ⚠️		 Lucas Cimon
Lucas Cimon
📝 💻 📖 🚇 🚧 💬		 Miroslav Šedivý
Miroslav Šedivý
💻 ⚠️		 Florian Bernhart
Florian Bernhart
💻 ⚠️		 Edwood Ocasio
Edwood Ocasio
💻 ⚠️
Marcelo Duarte
Marcelo Duarte
💻		 Roman Kharin
Roman Kharin
💻 🤔		 Christopher Frost
Christopher Frost
🐛 💻		 Michael Kalbermatten
Michael Kalbermatten
🐛 💻		 Yanone
Yanone
💻		 Leo Zhu
Leo Zhu
💻		 Abishek Goda
Abishek Goda
💻
Arthur Moore
Arthur Moore
💻 ⚠️ 🐛		 Bogdan Cuza
Bogdan Cuza
💻		 Craig Hobbs
Craig Hobbs
💻		 xitrushiy
xitrushiy
🐛 💻		 José L. Redrejo Rodríguez
José L. Redrejo Rodríguez
💻		 Jürgen Gmach
Jürgen Gmach
💻		 Larivact
Larivact
💻
Leonel Câmara
Leonel Câmara
💻		 Mark Steadman
Mark Steadman
🐛 💻		 Sergey
Sergey
💻		 Stan-C421
Stan-C421
💻		 Viraj Shah
Viraj Shah
💻		 cornicis
cornicis
💻		 moe-25
moe-25
💻 👀 🔬 🐛
Simone Bizzotto
Simone Bizzotto
💻		 Boonyawe Sirimaha
Boonyawe Sirimaha
🐛		 T
T
💻 🎨		 AubsUK
AubsUK
💬		 Georg Mischler
Georg Mischler
🐛 💻 🎨 📖 🤔 💬 ⚠️		 ping
ping
🐛		 Portfedh
Portfedh
📖 ✅
Tabarnhack
Tabarnhack
💻		 Mridul Birla
Mridul Birla
🌍		 digidigital
digidigital
🌍		 Xit
Xit
🌍		 Alexander Burchenko
Alexander Burchenko
🌍		 André Assunção
André Assunção
🌍		 Quentin Brault
Quentin Brault
🌍
Paula Campigotto
Paula Campigotto
🐛 💻 👀		 bettman-latin
bettman-latin
💻		 oleksii-shyman
oleksii-shyman
💻 🎨 🤔		 lcomrade
lcomrade
📖 🐛 💻		 pwt
pwt
🐛 💻		 Martin Cerveny
Martin Cerveny
🐛 💻		 Spenhouet
Spenhouet
🐛 👀
mtkumar123
mtkumar123
💻		 Davide Consalvo
Davide Consalvo
💻 💬 🎨		 Bruno Santos
Bruno Santos
🐛		 cgkoutzigiannis
cgkoutzigiannis
⚠️		 I Wayan Kurniawan
I Wayan Kurniawan
📖		 Sven Eliasson
Sven Eliasson
📖		 gonzalobarbaran
gonzalobarbaran
💻
Nuttapat Koonarangsri
Nuttapat Koonarangsri
📖 🐛		 Sokratis Vasiliou
Sokratis Vasiliou
🌍		 semaeostomea
semaeostomea
📖 💻		 Josué Millán Zamora
Josué Millán Zamora
💻		 me-suzy
me-suzy
🐛		 dmail00
dmail00
🐛		 Gerardo Allende
Gerardo Allende
💻
Nicholas Jin
Nicholas Jin
🐛		 Yusuke
Yusuke
💻		 Tillrzhtgrfho
Tillrzhtgrfho
🐛		 Dario Ackermann
Dario Ackermann
🐛		 Tzvi Greenfeld
Tzvi Greenfeld
📖		 devdev29
devdev29
📖		 Johan Bonneau
Johan Bonneau
📖
Jesús Alberto Muñoz Mesa
Jesús Alberto Muñoz Mesa
⚠️ 📖		 Jaydeep Das
Jaydeep Das
💬		 Sean
Sean
💻		 Anderson Herzogenrath da Costa
Anderson Herzogenrath da Costa
💬 💻 🔬 🐛		 Yi Wei Lan
Yi Wei Lan
⚠️		 CpDong
CpDong
💻 🐛 🌍		 CY-Qiu
CY-Qiu
🐛
Markovvn1
Markovvn1
💻		 Elad Rapaport
Elad Rapaport
💻		 SfinxV
SfinxV
🐛		 bramantoleksono
bramantoleksono
🐛		 TheNerdy907
TheNerdy907
🐛		 Elie Roux
Elie Roux
🐛 🤔 💻 💬		 msalem
msalem
📖
Manuel Ruiz
Manuel Ruiz
🐛		 Noel
Noel
🐛		 Avik Sarkar
Avik Sarkar
🌍 📖		 aeris07
aeris07
🐛
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 January 2023, click on the map above to access an up-to-date online version)_ ## Community, related tools, alternative libraries More about those in [the documentation](https://pyfpdf.github.io/fpdf2/#community). %package -n python3-fpdf2 Summary: Simple & fast PDF generation for Python Provides: python-fpdf2 BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-fpdf2 [![Pypi latest version](https://img.shields.io/pypi/v/fpdf2.svg)](https://pypi.org/pypi/fpdf2#history) [![Python Support](https://img.shields.io/pypi/pyversions/fpdf2.svg)](https://pypi.org/project/fpdf2/) [![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0) [![build status](https://github.com/PyFPDF/fpdf2/workflows/build/badge.svg)](https://github.com/PyFPDF/fpdf2/actions?query=branch%3Amaster) [![codecov](https://codecov.io/gh/PyFPDF/fpdf2/branch/master/graph/badge.svg)](https://codecov.io/gh/PyFPDF/fpdf2) ![security: bandit, pylint, semgrep](https://img.shields.io/badge/linters-bandit,pylint,semgrep-yellow.svg) [![Dependents](https://img.shields.io/librariesio/dependents/pypi/fpdf2)](https://libraries.io/pypi/fpdf2/dependents) [![Downloads per month](https://pepy.tech/badge/fpdf2/month)](https://pepy.tech/project/fpdf2) [![Contributors](https://img.shields.io/github/contributors/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/graphs/contributors) [![GitHub last commit](https://img.shields.io/github/last-commit/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/commits/master) [![issues closed](https://img.shields.io/github/issues-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/issues) [![PRs closed](https://img.shields.io/github/issues-pr-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/pulls) [![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 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") ``` Go try it **now** online in a Jupyter notebook: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) or [![Open In nbviewer](https://img.shields.io/badge/Open_In-nbviewer-blue?logo=jupyter)](https://nbviewer.org/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) Compared with other PDF libraries, `fpdf2` is **fast, versatile, easy to learn and to extend** ([example](https://github.com/digidigital/Extensions-and-Scripts-for-pyFPDF-fpdf2)). It is also entirely written in Python and has very few dependencies: [Pillow](https://pillow.readthedocs.io/en/stable/), [defusedxml](https://pypi.org/project/defusedxml/), & [fontTools](https://fonttools.readthedocs.io/en/latest/index.html). It is a fork and the successor of `PyFPDF` (_cf._ [history](https://pyfpdf.github.io/fpdf2/Development.html#history)). **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, unreleased, development version straight from the development branch of this repository: ```bash pip install git+https://github.com/PyFPDF/fpdf2.git@master ``` ## Features * Python 3.7+ support * [Unicode](https://pyfpdf.github.io/fpdf2/Unicode.html) (UTF-8) TrueType font subset embedding * Internal / external [links](https://pyfpdf.github.io/fpdf2/Links.html) * Embedding images, including transparency and alpha channel * Arbitrary path drawing and basic [SVG](https://pyfpdf.github.io/fpdf2/SVG.html) import * Embedding [barcodes](https://pyfpdf.github.io/fpdf2/Barcodes.html), [charts & graphs](https://pyfpdf.github.io/fpdf2/Maths.html), [emojis, symbols & dingbats](https://pyfpdf.github.io/fpdf2/EmojisSymbolsDingbats.html) * [Tables](https://pyfpdf.github.io/fpdf2/Tables.html) and also [cell / multi-cell / plaintext writing](https://pyfpdf.github.io/fpdf2/Text.html), with [automatic page breaks](https://pyfpdf.github.io/fpdf2/PageBreaks.html), line break and text justification * Choice of measurement unit, page format & margins. Optional page header and footer * 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, for accessibility * Table of contents & [document outline](https://pyfpdf.github.io/fpdf2/DocumentOutlineAndTableOfContents.html) * [Document encryption](https://pyfpdf.github.io/fpdf2/Encryption.html) & [document signing](https://pyfpdf.github.io/fpdf2/Signing.html) * [Annotations](https://pyfpdf.github.io/fpdf2/Annotations.html), including text highlights, and [file attachments](https://pyfpdf.github.io/fpdf2/FileAttachments.html) * [Presentation mode](https://pyfpdf.github.io/fpdf2/Presentations.html) with control over page display duration & transitions * Optional basic Markdown-like styling: `**bold**, __italics__` * Can render [mathematical equations & charts](https://pyfpdf.github.io/fpdf2/Maths.html) * Usage examples with [Django](https://www.djangoproject.com/), [Flask](https://flask.palletsprojects.com), [streamlit](https://streamlit.io/), AWS lambdas... : [Usage in web APIs](https://pyfpdf.github.io/fpdf2/UsageInWebAPI.html) * 1000+ unit tests running under Linux & Windows, with `qpdf`-based PDF diffing, timing & memory usage checks, and a high code coverage Our 350+ reference PDF test files, generated by `fpdf2`, are validated 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) ## Please show the value Choosing a project dependency can be difficult. We need to ensure stability and maintainability of our projects. Surveys show that GitHub stars count play an important factor when assessing library quality. ⭐ Please give this repository a star. It takes seconds and will help your fellow developers! ⭐ ## Please share with the community This library relies on community interactions. Please consider sharing a post about `fpdf2` and the value it provides 😊 [![GitHub Repo stars](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-hacker%20news-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-twitter-03A9F4?logo=twitter)](https://twitter.com/share?url=https://github.com/PyFPDF/fpdf2&t=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-facebook-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/shareArticle?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) ## 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) - [Ελληνικά](https://pyfpdf.github.io/fpdf2/Tutorial-gr.html) - [עברית](https://pyfpdf.github.io/fpdf2/Tutorial-he.html) - [简体中文](https://pyfpdf.github.io/fpdf2/Tutorial-zh.html) - [বাংলা](https://pyfpdf.github.io/fpdf2/Tutorial-বাংলা.html) - Release notes: [CHANGELOG.md](https://github.com/PyFPDF/fpdf2/blob/master/CHANGELOG.md) - A series of blog posts: [fpdf2 tag @ ludochaordic](https://chezsoi.org/lucas/blog/tag/fpdf2.html) You can also have a look at the `tests/`, they're great usage examples! ## Developement Please check the [dedicated documentation page](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
Mariano Reingart
💻		 David Ankin
David Ankin
🐛 💻 📖 🚧 💬 👀 ⚠️		 Alex Pavlovich
Alex Pavlovich
🐛 💻 📖 💬 👀 ⚠️		 Lucas Cimon
Lucas Cimon
📝 💻 📖 🚇 🚧 💬		 Miroslav Šedivý
Miroslav Šedivý
💻 ⚠️		 Florian Bernhart
Florian Bernhart
💻 ⚠️		 Edwood Ocasio
Edwood Ocasio
💻 ⚠️
Marcelo Duarte
Marcelo Duarte
💻		 Roman Kharin
Roman Kharin
💻 🤔		 Christopher Frost
Christopher Frost
🐛 💻		 Michael Kalbermatten
Michael Kalbermatten
🐛 💻		 Yanone
Yanone
💻		 Leo Zhu
Leo Zhu
💻		 Abishek Goda
Abishek Goda
💻
Arthur Moore
Arthur Moore
💻 ⚠️ 🐛		 Bogdan Cuza
Bogdan Cuza
💻		 Craig Hobbs
Craig Hobbs
💻		 xitrushiy
xitrushiy
🐛 💻		 José L. Redrejo Rodríguez
José L. Redrejo Rodríguez
💻		 Jürgen Gmach
Jürgen Gmach
💻		 Larivact
Larivact
💻
Leonel Câmara
Leonel Câmara
💻		 Mark Steadman
Mark Steadman
🐛 💻		 Sergey
Sergey
💻		 Stan-C421
Stan-C421
💻		 Viraj Shah
Viraj Shah
💻		 cornicis
cornicis
💻		 moe-25
moe-25
💻 👀 🔬 🐛
Simone Bizzotto
Simone Bizzotto
💻		 Boonyawe Sirimaha
Boonyawe Sirimaha
🐛		 T
T
💻 🎨		 AubsUK
AubsUK
💬		 Georg Mischler
Georg Mischler
🐛 💻 🎨 📖 🤔 💬 ⚠️		 ping
ping
🐛		 Portfedh
Portfedh
📖 ✅
Tabarnhack
Tabarnhack
💻		 Mridul Birla
Mridul Birla
🌍		 digidigital
digidigital
🌍		 Xit
Xit
🌍		 Alexander Burchenko
Alexander Burchenko
🌍		 André Assunção
André Assunção
🌍		 Quentin Brault
Quentin Brault
🌍
Paula Campigotto
Paula Campigotto
🐛 💻 👀		 bettman-latin
bettman-latin
💻		 oleksii-shyman
oleksii-shyman
💻 🎨 🤔		 lcomrade
lcomrade
📖 🐛 💻		 pwt
pwt
🐛 💻		 Martin Cerveny
Martin Cerveny
🐛 💻		 Spenhouet
Spenhouet
🐛 👀
mtkumar123
mtkumar123
💻		 Davide Consalvo
Davide Consalvo
💻 💬 🎨		 Bruno Santos
Bruno Santos
🐛		 cgkoutzigiannis
cgkoutzigiannis
⚠️		 I Wayan Kurniawan
I Wayan Kurniawan
📖		 Sven Eliasson
Sven Eliasson
📖		 gonzalobarbaran
gonzalobarbaran
💻
Nuttapat Koonarangsri
Nuttapat Koonarangsri
📖 🐛		 Sokratis Vasiliou
Sokratis Vasiliou
🌍		 semaeostomea
semaeostomea
📖 💻		 Josué Millán Zamora
Josué Millán Zamora
💻		 me-suzy
me-suzy
🐛		 dmail00
dmail00
🐛		 Gerardo Allende
Gerardo Allende
💻
Nicholas Jin
Nicholas Jin
🐛		 Yusuke
Yusuke
💻		 Tillrzhtgrfho
Tillrzhtgrfho
🐛		 Dario Ackermann
Dario Ackermann
🐛		 Tzvi Greenfeld
Tzvi Greenfeld
📖		 devdev29
devdev29
📖		 Johan Bonneau
Johan Bonneau
📖
Jesús Alberto Muñoz Mesa
Jesús Alberto Muñoz Mesa
⚠️ 📖		 Jaydeep Das
Jaydeep Das
💬		 Sean
Sean
💻		 Anderson Herzogenrath da Costa
Anderson Herzogenrath da Costa
💬 💻 🔬 🐛		 Yi Wei Lan
Yi Wei Lan
⚠️		 CpDong
CpDong
💻 🐛 🌍		 CY-Qiu
CY-Qiu
🐛
Markovvn1
Markovvn1
💻		 Elad Rapaport
Elad Rapaport
💻		 SfinxV
SfinxV
🐛		 bramantoleksono
bramantoleksono
🐛		 TheNerdy907
TheNerdy907
🐛		 Elie Roux
Elie Roux
🐛 🤔 💻 💬		 msalem
msalem
📖
Manuel Ruiz
Manuel Ruiz
🐛		 Noel
Noel
🐛		 Avik Sarkar
Avik Sarkar
🌍 📖		 aeris07
aeris07
🐛
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 January 2023, click on the map above to access an up-to-date online version)_ ## Community, related tools, alternative libraries More about those in [the documentation](https://pyfpdf.github.io/fpdf2/#community). %package help Summary: Development documents and examples for fpdf2 Provides: python3-fpdf2-doc %description help [![Pypi latest version](https://img.shields.io/pypi/v/fpdf2.svg)](https://pypi.org/pypi/fpdf2#history) [![Python Support](https://img.shields.io/pypi/pyversions/fpdf2.svg)](https://pypi.org/project/fpdf2/) [![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0) [![build status](https://github.com/PyFPDF/fpdf2/workflows/build/badge.svg)](https://github.com/PyFPDF/fpdf2/actions?query=branch%3Amaster) [![codecov](https://codecov.io/gh/PyFPDF/fpdf2/branch/master/graph/badge.svg)](https://codecov.io/gh/PyFPDF/fpdf2) ![security: bandit, pylint, semgrep](https://img.shields.io/badge/linters-bandit,pylint,semgrep-yellow.svg) [![Dependents](https://img.shields.io/librariesio/dependents/pypi/fpdf2)](https://libraries.io/pypi/fpdf2/dependents) [![Downloads per month](https://pepy.tech/badge/fpdf2/month)](https://pepy.tech/project/fpdf2) [![Contributors](https://img.shields.io/github/contributors/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/graphs/contributors) [![GitHub last commit](https://img.shields.io/github/last-commit/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/commits/master) [![issues closed](https://img.shields.io/github/issues-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/issues) [![PRs closed](https://img.shields.io/github/issues-pr-closed/PyFPDF/fpdf2)](https://github.com/PyFPDF/fpdf2/pulls) [![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 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") ``` Go try it **now** online in a Jupyter notebook: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) or [![Open In nbviewer](https://img.shields.io/badge/Open_In-nbviewer-blue?logo=jupyter)](https://nbviewer.org/github/PyFPDF/fpdf2/blob/master/tutorial/notebook.ipynb) Compared with other PDF libraries, `fpdf2` is **fast, versatile, easy to learn and to extend** ([example](https://github.com/digidigital/Extensions-and-Scripts-for-pyFPDF-fpdf2)). It is also entirely written in Python and has very few dependencies: [Pillow](https://pillow.readthedocs.io/en/stable/), [defusedxml](https://pypi.org/project/defusedxml/), & [fontTools](https://fonttools.readthedocs.io/en/latest/index.html). It is a fork and the successor of `PyFPDF` (_cf._ [history](https://pyfpdf.github.io/fpdf2/Development.html#history)). **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, unreleased, development version straight from the development branch of this repository: ```bash pip install git+https://github.com/PyFPDF/fpdf2.git@master ``` ## Features * Python 3.7+ support * [Unicode](https://pyfpdf.github.io/fpdf2/Unicode.html) (UTF-8) TrueType font subset embedding * Internal / external [links](https://pyfpdf.github.io/fpdf2/Links.html) * Embedding images, including transparency and alpha channel * Arbitrary path drawing and basic [SVG](https://pyfpdf.github.io/fpdf2/SVG.html) import * Embedding [barcodes](https://pyfpdf.github.io/fpdf2/Barcodes.html), [charts & graphs](https://pyfpdf.github.io/fpdf2/Maths.html), [emojis, symbols & dingbats](https://pyfpdf.github.io/fpdf2/EmojisSymbolsDingbats.html) * [Tables](https://pyfpdf.github.io/fpdf2/Tables.html) and also [cell / multi-cell / plaintext writing](https://pyfpdf.github.io/fpdf2/Text.html), with [automatic page breaks](https://pyfpdf.github.io/fpdf2/PageBreaks.html), line break and text justification * Choice of measurement unit, page format & margins. Optional page header and footer * 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, for accessibility * Table of contents & [document outline](https://pyfpdf.github.io/fpdf2/DocumentOutlineAndTableOfContents.html) * [Document encryption](https://pyfpdf.github.io/fpdf2/Encryption.html) & [document signing](https://pyfpdf.github.io/fpdf2/Signing.html) * [Annotations](https://pyfpdf.github.io/fpdf2/Annotations.html), including text highlights, and [file attachments](https://pyfpdf.github.io/fpdf2/FileAttachments.html) * [Presentation mode](https://pyfpdf.github.io/fpdf2/Presentations.html) with control over page display duration & transitions * Optional basic Markdown-like styling: `**bold**, __italics__` * Can render [mathematical equations & charts](https://pyfpdf.github.io/fpdf2/Maths.html) * Usage examples with [Django](https://www.djangoproject.com/), [Flask](https://flask.palletsprojects.com), [streamlit](https://streamlit.io/), AWS lambdas... : [Usage in web APIs](https://pyfpdf.github.io/fpdf2/UsageInWebAPI.html) * 1000+ unit tests running under Linux & Windows, with `qpdf`-based PDF diffing, timing & memory usage checks, and a high code coverage Our 350+ reference PDF test files, generated by `fpdf2`, are validated 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) ## Please show the value Choosing a project dependency can be difficult. We need to ensure stability and maintainability of our projects. Surveys show that GitHub stars count play an important factor when assessing library quality. ⭐ Please give this repository a star. It takes seconds and will help your fellow developers! ⭐ ## Please share with the community This library relies on community interactions. Please consider sharing a post about `fpdf2` and the value it provides 😊 [![GitHub Repo stars](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-hacker%20news-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-twitter-03A9F4?logo=twitter)](https://twitter.com/share?url=https://github.com/PyFPDF/fpdf2&t=fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-facebook-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/PyFPDF/fpdf2) [![GitHub Repo stars](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/shareArticle?url=https://github.com/PyFPDF/fpdf2&title=fpdf2) ## 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) - [Ελληνικά](https://pyfpdf.github.io/fpdf2/Tutorial-gr.html) - [עברית](https://pyfpdf.github.io/fpdf2/Tutorial-he.html) - [简体中文](https://pyfpdf.github.io/fpdf2/Tutorial-zh.html) - [বাংলা](https://pyfpdf.github.io/fpdf2/Tutorial-বাংলা.html) - Release notes: [CHANGELOG.md](https://github.com/PyFPDF/fpdf2/blob/master/CHANGELOG.md) - A series of blog posts: [fpdf2 tag @ ludochaordic](https://chezsoi.org/lucas/blog/tag/fpdf2.html) You can also have a look at the `tests/`, they're great usage examples! ## Developement Please check the [dedicated documentation page](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
Mariano Reingart
💻		 David Ankin
David Ankin
🐛 💻 📖 🚧 💬 👀 ⚠️		 Alex Pavlovich
Alex Pavlovich
🐛 💻 📖 💬 👀 ⚠️		 Lucas Cimon
Lucas Cimon
📝 💻 📖 🚇 🚧 💬		 Miroslav Šedivý
Miroslav Šedivý
💻 ⚠️		 Florian Bernhart
Florian Bernhart
💻 ⚠️		 Edwood Ocasio
Edwood Ocasio
💻 ⚠️
Marcelo Duarte
Marcelo Duarte
💻		 Roman Kharin
Roman Kharin
💻 🤔		 Christopher Frost
Christopher Frost
🐛 💻		 Michael Kalbermatten
Michael Kalbermatten
🐛 💻		 Yanone
Yanone
💻		 Leo Zhu
Leo Zhu
💻		 Abishek Goda
Abishek Goda
💻
Arthur Moore
Arthur Moore
💻 ⚠️ 🐛		 Bogdan Cuza
Bogdan Cuza
💻		 Craig Hobbs
Craig Hobbs
💻		 xitrushiy
xitrushiy
🐛 💻		 José L. Redrejo Rodríguez
José L. Redrejo Rodríguez
💻		 Jürgen Gmach
Jürgen Gmach
💻		 Larivact
Larivact
💻
Leonel Câmara
Leonel Câmara
💻		 Mark Steadman
Mark Steadman
🐛 💻		 Sergey
Sergey
💻		 Stan-C421
Stan-C421
💻		 Viraj Shah
Viraj Shah
💻		 cornicis
cornicis
💻		 moe-25
moe-25
💻 👀 🔬 🐛
Simone Bizzotto
Simone Bizzotto
💻		 Boonyawe Sirimaha
Boonyawe Sirimaha
🐛		 T
T
💻 🎨		 AubsUK
AubsUK
💬		 Georg Mischler
Georg Mischler
🐛 💻 🎨 📖 🤔 💬 ⚠️		 ping
ping
🐛		 Portfedh
Portfedh
📖 ✅
Tabarnhack
Tabarnhack
💻		 Mridul Birla
Mridul Birla
🌍		 digidigital
digidigital
🌍		 Xit
Xit
🌍		 Alexander Burchenko
Alexander Burchenko
🌍		 André Assunção
André Assunção
🌍		 Quentin Brault
Quentin Brault
🌍
Paula Campigotto
Paula Campigotto
🐛 💻 👀		 bettman-latin
bettman-latin
💻		 oleksii-shyman
oleksii-shyman
💻 🎨 🤔		 lcomrade
lcomrade
📖 🐛 💻		 pwt
pwt
🐛 💻		 Martin Cerveny
Martin Cerveny
🐛 💻		 Spenhouet
Spenhouet
🐛 👀
mtkumar123
mtkumar123
💻		 Davide Consalvo
Davide Consalvo
💻 💬 🎨		 Bruno Santos
Bruno Santos
🐛		 cgkoutzigiannis
cgkoutzigiannis
⚠️		 I Wayan Kurniawan
I Wayan Kurniawan
📖		 Sven Eliasson
Sven Eliasson
📖		 gonzalobarbaran
gonzalobarbaran
💻
Nuttapat Koonarangsri
Nuttapat Koonarangsri
📖 🐛		 Sokratis Vasiliou
Sokratis Vasiliou
🌍		 semaeostomea
semaeostomea
📖 💻		 Josué Millán Zamora
Josué Millán Zamora
💻		 me-suzy
me-suzy
🐛		 dmail00
dmail00
🐛		 Gerardo Allende
Gerardo Allende
💻
Nicholas Jin
Nicholas Jin
🐛		 Yusuke
Yusuke
💻		 Tillrzhtgrfho
Tillrzhtgrfho
🐛		 Dario Ackermann
Dario Ackermann
🐛		 Tzvi Greenfeld
Tzvi Greenfeld
📖		 devdev29
devdev29
📖		 Johan Bonneau
Johan Bonneau
📖
Jesús Alberto Muñoz Mesa
Jesús Alberto Muñoz Mesa
⚠️ 📖		 Jaydeep Das
Jaydeep Das
💬		 Sean
Sean
💻		 Anderson Herzogenrath da Costa
Anderson Herzogenrath da Costa
💬 💻 🔬 🐛		 Yi Wei Lan
Yi Wei Lan
⚠️		 CpDong
CpDong
💻 🐛 🌍		 CY-Qiu
CY-Qiu
🐛
Markovvn1
Markovvn1
💻		 Elad Rapaport
Elad Rapaport
💻		 SfinxV
SfinxV
🐛		 bramantoleksono
bramantoleksono
🐛		 TheNerdy907
TheNerdy907
🐛		 Elie Roux
Elie Roux
🐛 🤔 💻 💬		 msalem
msalem
📖
Manuel Ruiz
Manuel Ruiz
🐛		 Noel
Noel
🐛		 Avik Sarkar
Avik Sarkar
🌍 📖		 aeris07
aeris07
🐛
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 January 2023, click on the map above to access an up-to-date online version)_ ## Community, related tools, alternative libraries More about those in [the documentation](https://pyfpdf.github.io/fpdf2/#community). %prep %autosetup -n fpdf2-2.7.3 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-fpdf2 -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Mon Apr 10 2023 Python_Bot - 2.7.3-1 - Package Spec generated