PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 3편 pypdf 설치와 첫 합치기

PANCO_IT
#파이썬#PDF 합치기#pypdf#Pillow#pip

합친파일.pdf를 크롬으로 연 화면

2편까지 요구사항과 설계를 정리했으니 이제 코드를 짭니다. 처음부터 창까지 한꺼번에 만들지 않고, 2편에서 나눈 기능을 하나씩 명령어로 돌려 본 다음 마지막에 창에 붙이기로 했습니다.

첫 순서는 라이브러리 설치와 PDF 두 개 합치기입니다. 라이브러리 두 개 설치하고 파일 두 개 합치는 일인데도 생각보다 손이 많이 갔습니다.

1. 파이썬 버전 확인

설치 전에 파이썬부터 확인했습니다. pip는 파이썬 버전마다 따로 있어서, 다른 버전 쪽에 라이브러리를 깔아 두면 나중에 코드를 돌릴 때 ModuleNotFoundError가 납니다.

python --version을 치니 3.14.9가 나왔고, 혹시 몰라 py -0으로 깔려 있는 파이썬 목록을 봤더니 3.14 말고 3.12도 하나 더 있었습니다. 그냥 python이라고 치면 별표가 붙은 3.14가 실행됩니다.

python --version과 py -0 결과

2. pypdf와 Pillow

파이썬에는 PDF를 다루는 기능이 기본으로 들어 있지 않아서, 라이브러리를 따로 설치해야 합니다. 이번에 쓸 라이브러리는 pypdf와 Pillow 두 개입니다.

pypdf는 PDF 파일을 열어서 쪽을 읽고, 여러 파일의 쪽을 이어 붙이거나 일부만 떼어 내서 새 PDF로 저장하는 라이브러리입니다. PDF 합치기는 이걸로 합니다.

Pillow는 JPG, PNG 같은 사진 파일을 열고, 크기를 줄이거나 화질을 바꿔서 다시 저장하는 라이브러리입니다. 사진을 PDF로 저장하는 기능도 있어서, 휴대폰으로 찍은 서류 사진을 PDF로 묶을 때 씁니다.

라이브러리하는 일이 프로그램에서 쓰는 곳라이선스
pypdfPDF 읽기, 쪽 이어 붙이기, 저장PDF 합치기BSD
Pillow사진 열기, 크기·화질 바꾸기, PDF로 저장사진 묶기, 용량 줄이기MIT-CMU

PDF 라이브러리를 찾아보면 PyMuPDF도 많이 나옵니다. 그런데 라이선스가 AGPL이라 그걸 쓴 코드를 공개할 때 지켜야 할 조건이 까다로워서 쓰지 않았습니다. pypdf는 파이썬으로만 짜여 있어서 다른 프로그램을 따로 깔지 않아도 되는 점도 편했습니다.

사진을 PDF로 묶는 건 5편에서 할 일이지만, Pillow도 이번에 같이 설치해 두었습니다.

설치하기 전에 pip --version으로 이 pip가 어느 버전 파이썬 것인지부터 봤습니다. 줄 끝에 (python 3.14)라고 나와서, 기본으로 실행되는 3.14 쪽에 깔린다는 걸 확인하고 넘어갔습니다. 경로 중간에 나오는 윈도우 계정 폴더 이름은 캡처에서 회색으로 가렸습니다.

3. pip install로 설치

pip install pypdf pillow

엔터를 누르자마자 WARNING: Cache entry deserialization failed, entry ignored라는 노란 줄이 네 줄 올라왔습니다.

설치가 안 된 건가 싶어서 맨 아래 줄부터 봤는데, 거기에는 Successfully installed pillow-13.0.0 pypdf-6.21.4가 찍혀 있었습니다.

pip install 결과. 노란 경고 뒤에 Successfully installed

찾아보니 이 경고는 pip가 예전에 받아 둔 파일(캐시) 가운데 하나를 읽지 못해서 그건 안 쓰고 넘어갔다는 말이었습니다.

화면을 다시 보니 pypdf는 410kB짜리 파일을 새로 내려받았고, Pillow는 캐시에 남아 있던 7.3MB짜리 파일을 그대로 썼습니다. 못 읽은 캐시는 건너뛰고 필요한 건 새로 받아서 설치를 끝낸 거였습니다.

설치됐다는 문장만 믿고 넘어가기는 찜찜해서 두 라이브러리를 실제로 불러와 버전을 찍어 봤습니다.

python -c "import pypdf, PIL; print(pypdf.__version__, PIL.__version__)"

설치 확인 결과

6.21.4 13.0.0이 나왔고 오류는 없었습니다. 참고로 Pillow는 설치할 땐 pillow라고 치지만 코드에서는 PIL로 불러옵니다. 옛날 PIL이라는 라이브러리를 이어받은 거라 이름이 그렇게 남았다고 합니다.

4. 경고 원인 확인

설치는 됐지만 경고가 왜 떴는지는 알고 넘어가고 싶었습니다. 앞에서 파이썬이 두 개라는 것을 봤으니 그쪽부터 의심했고, pip가 받아 둔 파일을 모아 두는 폴더와 3.12 쪽 pip의 버전을 확인했습니다.

pip cache dir
py -3.12 -m pip --version

pip cache dir와 3.12 쪽 pip 버전

캐시 폴더는 하나였고, 3.12 쪽 pip는 25.0.1, 기본인 3.14 쪽 pip는 26.2.2였습니다.

두 파이썬이 캐시 폴더 하나를 같이 쓰는데 pip 버전이 서로 다르니, 3.12 쪽 pip가 저장해 둔 파일을 3.14 쪽 pip가 읽지 못해서 버리고 새로 받은 것 같습니다. 그림으로 그려 보면 이런 상황입니다.

파이썬 두 개가 pip 캐시 폴더 하나를 같이 쓰는 구조

불러오기와 버전 확인이 모두 정상이어서 경고는 그대로 두었습니다.

경고 자체를 없애고 싶다면 pip cache purge로 캐시를 비우는 방법이 있는데, 비우면 다음 설치 때 파일을 전부 다시 받아야 해서 저는 비우지 않았습니다.

5. 연습용 PDF 만들기

합칠 PDF가 있어야 시험을 해 볼 수 있는데, 제 서류를 예제로 쓸 수는 없어서 연습용 PDF를 파이썬으로 따로 만들었습니다.

방금 설치한 Pillow로 흰 A4 크기 그림에 글자 한 줄을 쓰고 PDF로 저장하는 방식이라, 두 번째 라이브러리가 제대로 깔렸는지도 같이 보게 됩니다.

from PIL import Image, ImageDraw, ImageFont

font = ImageFont.truetype("malgun.ttf", 60)

def make_page(text):
    page = Image.new("RGB", (1240, 1754), "white")  # A4를 150dpi로
    ImageDraw.Draw(page).text((120, 150), text, font=font, fill="black")
    return page

# 연습1.pdf는 2쪽, 연습2.pdf는 1쪽
pages = [make_page("연습용 문서 1 - 1쪽"), make_page("연습용 문서 1 - 2쪽")]
pages[0].save("연습1.pdf", save_all=True, append_images=pages[1:])
make_page("연습용 문서 2 - 1쪽").save("연습2.pdf")
print("연습1.pdf, 연습2.pdf 만들었음")

글꼴을 먼저 불러 두고, 쪽 한 장을 그리는 함수를 만든 다음, 그 쪽들을 PDF로 저장했습니다.

  • 글꼴 불러오기 (ImageFont.truetype): 윈도우에 들어 있는 맑은 고딕(malgun.ttf)을 60 크기로 불러옵니다. Pillow 기본 글꼴에는 한글이 없어서, 이걸 안 하면 한글이 제대로 안 나옵니다.
  • 쪽 한 장 만들기 (make_page): 가로 1240, 세로 1754픽셀짜리 흰 그림을 만들고 왼쪽 위에 글자를 한 줄 씁니다. 이 크기가 A4 용지를 150dpi로 스캔했을 때와 같습니다.
  • PDF로 저장하기 (save): 쪽이 두 장 이상이면 첫 장을 저장하면서 save_all=True와 append_images로 나머지 장을 같이 넘겨야 한 파일에 여러 쪽이 들어갑니다. 한 장짜리는 그냥 save만 하면 됩니다.

합친 뒤에 쪽수가 맞는지 바로 알 수 있도록 하나는 2쪽, 하나는 1쪽으로 만들었습니다. 실행하자 83,607바이트짜리 연습1.pdf와 42,011바이트짜리 연습2.pdf가 생겼습니다.

연습용 PDF 두 개를 만든 결과

크롬으로 연 두 파일에는 글자가 제대로 들어가 있었습니다. 연습1.pdf는 왼쪽에 쪽이 2개 보입니다.

연습1.pdf를 크롬으로 연 화면

6. PDF 두 개 합치기

첫 버전은 돌아가는지만 보려고 파일 이름 두 개를 코드 안에 그대로 적었습니다.

from pypdf import PdfWriter

writer = PdfWriter()
writer.append("연습1.pdf")
writer.append("연습2.pdf")
writer.write("합친파일.pdf")
print("합친파일.pdf 저장")
  • 빈 PDF 만들기 (PdfWriter()): 아직 쪽이 하나도 없는 새 PDF를 만듭니다.
  • 쪽 붙이기 (append): 파일 이름을 넣으면 그 파일의 모든 쪽을 뒤에 붙입니다. append를 부른 순서가 그대로 쪽 순서가 됩니다.
  • 저장하기 (write): 지금까지 붙인 쪽을 합친파일.pdf라는 새 파일로 저장합니다. 원래 파일 두 개는 그대로 남습니다.

실행하자 합친파일.pdf 저장이 찍혔고, 합친 파일은 3쪽이었습니다. 2쪽짜리 뒤에 1쪽짜리가 그대로 붙었습니다.

파일 크기는 125,215바이트로, 두 파일 크기를 더한 125,618바이트보다 조금 작았습니다.

합치기 코드 실행 결과

크롬으로 연 합친파일.pdf에는 연습1의 두 쪽 뒤에 연습2가 3쪽으로 붙어 있었습니다.

합친 파일이 몇 쪽인지는 열지 않아도 pypdf의 PdfReader로 알 수 있습니다. 파일을 열어 보는 것보다 빨라서, 앞으로 쪽수 확인은 PdfReader로 하려고 합니다.

python -c "from pypdf import PdfReader; print(len(PdfReader('합친파일.pdf').pages))"

남은 문제

지금 코드는 파일 이름이 코드 안에 적혀 있어서, 다른 PDF를 합치려면 그때마다 코드를 고쳐야 합니다.

4편에서는 폴더 하나를 정해 두고, 그 안의 PDF를 번호 순서대로 찾아 합치게 바꿔 보겠습니다.

제가 쓴 환경은 Windows 11, Python 3.14.9, pip 26.2.2, pypdf 6.21.4, Pillow 13.0.0입니다.

PANCO_IT

필요한 프로그램을 직접 만들고 그 과정을 적습니다

관련 글

PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 11편 사진 섞어 합치기와 용량 맞추기

PDF와 휴대폰 사진을 한 번에 합치고 결과 전체를 20·10·5MB 아래로 맞추는 기능을 pdf_core.py에 넣었습니다. 처음 코드는 10MB에 8분이 넘게 걸려 줄이는 순서를 고쳤고, 1888년 동화책 스캔으로 다시 실행해 결과를 비교했습니다.

· PDF 합치기, PDF 용량 줄이기, pypdf
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 4편 폴더 속 PDF 번호순 합치기

폴더 안 스캔 PDF 11개를 한 번에 합치는 코드를 짜고, 1 다음에 10이 붙던 순서를 숫자 순서로 고쳤습니다.

· 파이썬, PDF 합치기, pypdf
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 5편 사진 묶기와 용량 줄이기

휴대폰 사진 5장을 PDF로 묶어 1MB 아래로 줄이고, 화질 단계 오류와 옆으로 누운 쪽을 고쳤습니다.

· 파이썬, PDF 합치기, Pillow
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 2편 흐름도와 화면 설계

1편 요구사항을 바탕으로 처리 흐름도, 화면 설계, 모듈 나누기, 예외 처리, 테스트 계획을 정리했습니다.

· 파이썬, PDF 합치기, 흐름도
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 1편 요구사항 정리

PDF 합치기 프로그램을 파이썬으로 만들기 전에, 평소 PDF를 다루며 불편했던 점을 바탕으로 요구사항 정의서와 유스케이스 명세, 범위, 일정을 정리했습니다.

· 파이썬, PDF 합치기, 요구사항 정의서
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 6편 tkinter로 창 만들기

명령어로 돌리던 PDF 합치기와 사진 묶기를 tkinter 창 하나로 모으고, 상태줄 문구와 만드는 동안의 표시를 고쳤습니다.

· 파이썬, tkinter, PDF 합치기