FPDF Python – Jak tworzyć PDF-y w Pythonie krok po kroku

Tworzenie plików PDF w Pythonie jest prostsze, niż mogłoby się wydawać! Dzięki bibliotece FPDF mamy dostęp do narzędzi, które pozwalają na szybkie i wygodne generowanie dokumentów PDF. W tym artykule pokażemy Ci, jak używać FPDF w Pythonie, a także zaprezentujemy kilka praktycznych przykładów, które pomogą Ci rozpocząć przygodę z tworzeniem dokumentów PDF w tym języku.

Co to jest FPDF?

FPDF to biblioteka do generowania dokumentów PDF, która jest dostępna w Pythonie. Jest to narzędzie, które pozwala na łatwe tworzenie plików PDF bez potrzeby korzystania z dodatkowych aplikacji. Biblioteka FPDF oferuje szeroki wachlarz funkcji, dzięki którym możemy tworzyć dokumenty zawierające tekst, obrazy, tabele, nagłówki, stopki i wiele innych elementów.

Co ważne, FPDF jest niezwykle lekka i szybka, a jej użycie jest bardzo intuicyjne. Dzięki tej bibliotece możesz tworzyć profesjonalne dokumenty, raporty, faktury, broszury, a także generować pliki PDF z dynamicznymi danymi. Można ją zainstalować za pomocą prostego polecenia pip:

pip install fpdf

Po zainstalowaniu biblioteki, będziesz mógł od razu zacząć przygodę z tworzeniem plików PDF w Pythonie!

Dlaczego warto używać FPDF w Pythonie?

FPDF ma kilka cech, które sprawiają, że jest to jedna z najczęściej wybieranych bibliotek do generowania PDF-ów w Pythonie:

• Prostota: FPDF jest prosty w użyciu i nie wymaga żadnych skomplikowanych konfiguracji. Wystarczy kilka linijek kodu, aby utworzyć podstawowy plik PDF.
• Wszechstronność: Biblioteka pozwala na dodawanie tekstów, obrazków, tabel, nagłówków, stopki i wielu innych elementów, co czyni ją idealnym rozwiązaniem do tworzenia dokumentów o różnej złożoności.
• Bezpieczeństwo: Dokumenty generowane za pomocą FPDF są w pełni bezpieczne i mogą być wykorzystywane w wielu profesjonalnych projektach.
• Łatwość integracji: FPDF świetnie integruje się z innymi bibliotekami Pythona, dzięki czemu możemy tworzyć bardziej zaawansowane dokumenty PDF, np. w połączeniu z danymi z baz danych czy formularzami.

Jak zacząć korzystać z FPDF w Pythonie?

Jeśli już zainstalowałeś bibliotekę FPDF, czas na stworzenie pierwszego pliku PDF! Zacznijmy od podstawowego przykładu, który pokaże Ci, jak generować prosty dokument PDF z tekstem.

Przykład 1: Prosty dokument PDF

W tym przykładzie stworzymy plik PDF z jednym prostym akapitem tekstu. Kod wygląda następująco:

from fpdf import FPDF

# Tworzymy obiekt PDF
pdf = FPDF()

# Dodajemy stronę do dokumentu
pdf.add_page()

# Ustawiamy czcionkę
pdf.set_font("Arial", size=12)

# Dodajemy tekst do dokumentu
pdf.cell(200, 10, txt="Witaj w świecie PDF w Pythonie!", ln=True, align="C")

# Zapisujemy dokument na dysku
pdf.output("pierwszy_plik.pdf")

W tym przykładzie:

• Tworzymy obiekt PDF.
• Dodajemy stronę do dokumentu (plik PDF może zawierać wiele stron).
• Ustawiamy czcionkę (tutaj używamy czcionki Arial o rozmiarze 12).
• Dodajemy tekst do dokumentu (funkcja cell pozwala na dodanie prostokąta z tekstem).
• Na końcu zapisujemy dokument jako plik PDF.

Po uruchomieniu tego kodu, w katalogu roboczym pojawi się plik pierwszy_plik.pdf, który zawiera jeden wiersz tekstu.

Przykład 2: Dodawanie tekstu i nagłówków

Teraz stworzymy bardziej rozbudowany dokument, który zawiera nagłówek oraz tekst. Dodatkowo, nauczymy się, jak dostosować rozmiar czcionki i wyrównanie tekstu.

from fpdf import FPDF

pdf = FPDF()

# Dodajemy stronę
pdf.add_page()

# Ustawiamy czcionkę
pdf.set_font("Arial", style="B", size=16)
pdf.cell(200, 10, txt="Nagłówek dokumentu", ln=True, align="C")

# Ustawiamy inną czcionkę dla tekstu
pdf.set_font("Arial", size=12)
pdf.multi_cell(0, 10, txt="To jest dokument PDF stworzony przy użyciu biblioteki FPDF w Pythonie. "
                           "Możemy dodawać tekst, obrazy, tabele i wiele innych elementów do naszego pliku PDF. "
                           "Dzięki prostocie FPDF, możemy łatwo generować profesjonalne dokumenty.")

# Zapisujemy dokument
pdf.output("dokument_z_naglowkiem.pdf")

W tym przykładzie:

• Tworzymy nagłówek, używając większej czcionki i pogrubienia.
• Wstawiamy tekst z użyciem funkcji multi_cell, która pozwala na automatyczne łamanie linii.
• Na końcu zapisujemy plik z nagłówkiem i tekstem.

Po uruchomieniu tego kodu otrzymamy dokument PDF, który zawiera nagłówek i rozbudowany tekst w formie akapitów.

Przykład 3: Dodawanie obrazów do PDF

FPDF pozwala również na dodawanie obrazów do dokumentów PDF. Możemy łatwo dodać zdjęcie lub grafikę do naszego pliku PDF. Oto przykład, jak to zrobić:

from fpdf import FPDF

pdf = FPDF()

# Dodajemy stronę
pdf.add_page()

# Dodajemy obraz
pdf.image("obrazek.jpg", x=10, y=8, w=100)

# Dodajemy tekst
pdf.set_font("Arial", size=12)
pdf.ln(85)  # Robimy odstęp, aby tekst nie nachodził na obrazek
pdf.cell(200, 10, txt="To jest dokument z obrazkiem w PDF!", ln=True)

# Zapisujemy dokument
pdf.output("dokument_z_obrazkiem.pdf")

W tym przykładzie:

• Używamy metody image do dodania obrazka do dokumentu.
• Podajemy współrzędne x i y, aby określić położenie obrazka na stronie, a także jego szerokość w.
• Na końcu dodajemy tekst i zapisujemy dokument.

Po uruchomieniu tego kodu, otrzymamy dokument PDF, który oprócz tekstu, zawiera również obrazek umieszczony w określonym miejscu na stronie.

Przykład 4: Tworzenie tabeli w PDF

FPDF pozwala także na tworzenie tabel w PDF. Poniżej znajduje się przykład, jak stworzyć prostą tabelę z danymi.

from fpdf import FPDF

pdf = FPDF()

# Dodajemy stronę
pdf.add_page()

# Ustawiamy czcionkę
pdf.set_font("Arial", size=12)

# Dodajemy nagłówki tabeli
pdf.cell(40, 10, 'Imię', border=1)
pdf.cell(50, 10, 'Nazwisko', border=1)
pdf.cell(30, 10, 'Wiek', border=1)
pdf.ln()

# Dodajemy dane do tabeli
pdf.cell(40, 10, 'Jan', border=1)
pdf.cell(50, 10, 'Kowalski', border=1)
pdf.cell(30, 10, '25', border=1)
pdf.ln()

pdf.cell(40, 10, 'Anna', border=1)
pdf.cell(50, 10, 'Nowak', border=1)
pdf.cell(30, 10, '30', border=1)

# Zapisujemy dokument
pdf.output("dokument_z_tabela.pdf")

W tym przypadku tworzymy prostą tabelę z trzema kolumnami: Imię, Nazwisko i Wiek. Każda komórka tabeli jest oprawiona w ramkę, a dane są dodawane w odpowiednich komórkach.

Podsumowanie

FPDF to fantastyczna biblioteka, która pozwala na łatwe i szybkie tworzenie plików PDF w Pythonie. Dzięki jej prostocie i wszechstronności, możesz tworzyć dokumenty o różnym stopniu zaawansowania – od prostych raportów po skomplikowane dokumenty z tabelami i obrazkami. W tym artykule przedstawiliśmy kilka podstawowych przykładów, które pomogą Ci rozpocząć przygodę z FPDF i wykorzystać tę bibliotekę do swoich projektów. Teraz czas na Twoje pierwsze pliki PDF w Pythonie!