PDF 문서 자동 생성을 위한 Python fpdf 라이브러리 활용법

카테고리 없음

by jbmu6 2025. 3. 19. 15:50

Python fpdf 라이브러리로 PDF 문서 자동 생성하기

파이썬은 그 유연성 덕분에 다양한 작업을 수행할 수 있는 프로그래밍 언어입니다. 그 중에서도 PDF 문서를 생성하는 작업은 많은 사용자들에 의해 요구되고 있습니다. fpdf 라이브러리는 파이썬에서 PDF를 쉽게 생성할 수 있도록 도와주는 강력한 도구입니다. 이 글에서는 초보자도 이해할 수 있도록 fpdf 라이브러리를 활용하여 PDF 문서를 자동으로 생성하는 방법에 대해 자세히 설명하겠습니다.

fpdf 라이브러리 소개

fpdf는 Free PDF의 약자로, 파이썬에서 PDF 문서를 쉽게 생성할 수 있도록 도와주는 라이브러리입니다. fpdf의 장점은 다음과 같습니다:

간편한 사용법
가벼운 라이브러리
많은 기능 제공
다양한 포맷의 텍스트 및 이미지 삽입 지원

fpdf 설치하기

먼저 fpdf 라이브러리를 설치해야 합니다. 파이썬 패키지 관리자 pip를 사용하여 쉽게 설치할 수 있습니다. 아래의 명령어를 터미널에 입력하여 설치합니다.

pip install fpdf

PDF 문서 생성하기

이제 fpdf를 설치했으므로, 기본적인 PDF 문서를 생성하는 방법에 대해 설명하겠습니다.

기본 코드 구조

아래는 fpdf를 이용하여 기본적인 PDF 문서를 생성하는 코드입니다.


from fpdf import FPDF

PDF 클래스 생성


pdf = FPDF()

페이지 추가


pdf.add_page()

폰트 설정


pdf.set_font("Arial", size=12)

텍스트 추가


pdf.cell(200, 10, txt="Hello World", ln=True, align='C')

PDF 저장


pdf.output("sample.pdf")

상세 설명

from fpdf import FPDF: FPDF 클래스를 불러옵니다.
pdf = FPDF(): PDF 클래스의 인스턴스를 생성합니다.
pdf.add_page(): 새로운 페이지를 추가합니다.
pdf.set_font("Arial", size=12): 사용할 폰트를 설정합니다.
pdf.cell(200, 10, txt="Hello World", ln=True, align='C'): 텍스트를 추가합니다.
pdf.output("sample.pdf"): PDF 파일을 저장합니다.

폰트 설정하기

PDF 문서에서 폰트는 매우 중요한 요소입니다. fpdf 라이브러리는 기본적으로 몇 가지 폰트를 지원합니다. 기본적으로 제공되는 폰트는 다음과 같습니다:

Arial
Courier
Helvetica
Times

다음은 여러 다른 폰트를 설정하는 방법에 대한 예시입니다.


pdf.set_font("Times", "B", 16)

Bold체로 16px 폰트


pdf.set_font("Arial", "I", 14)

이탤릭체로 14px 폰트

페이지 설정하기

PDF 문서의 페이지 설정 또한 중요합니다. 페이지 orientation, 사이즈, 마진 등을 조정할 수 있습니다. 예를 들어:


pdf = FPDF(orientation='L', unit='mm', format='A4')

가로 방향, mm 단위, A4 형식


pdf.set_margins(10, 10, 10)

좌, 위, 우 마진 설정

텍스트 및 이미지 추가하기

텍스트 추가하기

텍스트를 추가할 때에는 cell 메서드를 사용하여 텍스트의 위치와 크기를 설정할 수 있습니다. 텍스트 정렬도 가능하며, 여러 줄의 텍스트 사용 시 multi_cell 메서드를 사용할 수 있습니다.


pdf.multi_cell(0, 10, 'This is a long text that spans multiple lines. You can easily create multi-line text blocks.')

이미지 추가하기

이미지 추가는 image 메서드를 통해 가능합니다. 다음은 이미지 추가하는 예시입니다.


pdf.image("image.jpg", x=10, y=10, w=100, h=100)

여기서 x, y는 이미지의 좌표, w는 너비, h는 높이를 의미합니다.

테이블 생성하기

PDF 문서에 데이터를 정렬하여 보여주고 싶을 때 테이블을 생성할 수 있습니다. 다음은 테이블을 생성하는 예시입니다.


def create_table(data):
    for row in data:
        for item in row:
            pdf.cell(40, 10, item, border=1)
        pdf.ln()

이 함수는 2차원 리스트 형식의 데이터를 받아 테이블 형태로 PDF에 추가합니다.

PDF 문서에 스타일 추가하기

PDF 문서에 스타일을 추가하여 문서의 가독성을 높일 수 있습니다. 예를 들어, 배경색, 테두리 색상 등을 설정할 수 있습니다. 직관적인 방법으로는 각 페이지의 부분에 스타일을 적용하는 것입니다.


pdf.setfillcolor(255, 0, 0)

빨간색 배경


pdf.cell(200, 10, 'Red Background', 0, 1, 'C', 1)

PDF 문서 저장 및 배포하기

PDF 문서 작업이 완료되면, 문서를 저장하여 다른 사람들과 공유할 수 있습니다. pdf.output 메서드를 사용하여 저장하며, 파일 형식은 .pdf로 지정해야 합니다.


pdf.output("final_document.pdf")

실용적인 예제

아래의 예시는 위에서 설명한 기능들을 통합하여 간단한 PDF 문서를 생성하는 전체 코드를 보여줍니다.


from fpdf import FPDF

pdf = FPDF()
pdf.add_page()
pdf.set_font("Arial", size=12)
pdf.cell(200, 10, txt="Python PDF Generation with fpdf", ln=True, align='C')

data = [
    ['이름', '나이', '직업'],
    ['김철수', '25', '개발자'],
    ['이영희', '30', '디자이너']
]

pdf.cell(40, 10, '이름', 1)
pdf.cell(40, 10, '나이', 1)
pdf.cell(40, 10, '직업', 1)
pdf.ln()

for row in data:
    for item in row:
        pdf.cell(40, 10, item, 1)
    pdf.ln()

pdf.output("user_data.pdf")