PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 12편 웹 화면 만들고 코드 붙이기

PANCO_IT
#PDF 합치기#웹 버전#Pyodide#pdf.js#Web Worker#파이썬

왼쪽은 10편에서 그린 휴대폰 화면 스케치, 오른쪽은 이번에 만든 실제 화면. 파일 다섯 개가 쪽 그림과 함께 목록에 들어가 있고, 다섯 번째 암호 걸린 PDF 줄은 빨갛게 표시되고 빼기 버튼이 있다

10편에서는 화면을 손그림 스케치로만 정했고, 11편에서는 PDF와 사진을 섞어 합치고 전체 용량을 맞추는 함수를 pdf_core.py에 넣었습니다. 이번 편에서는 스케치대로 웹 화면을 실제로 만들고, 그 함수를 붙여 브라우저에서 돌렸습니다.

시험 파일은 11편과 같은 묶음입니다. 글자 PDF 3쪽, 휴대폰 사진 두 장, 옛날 동화책 스캔 20쪽, 그리고 암호 걸린 PDF 하나를 더 넣었습니다.

화면 파일 나누기

8편 시험 페이지는 파일 하나짜리였습니다. 이번에는 화면과 파이썬 쪽을 나눠서 만들었습니다.

파일하는 일
index.html10편 확정안 배치(1 파일 넣기 · 2 순서와 용량 · 3 만들기)와 디자인 기준 색·글꼴
app.js파일 목록, 쪽 그림, 위아래 버튼, 빼기, 결과 표시
worker.js파이썬 준비와 합치기를 화면과 따로 돌리는 곳
runner.py목록 순서대로 pdf_core.py를 부르고 쪽수·용량·목차·링크를 돌려줌
pdf_core.py11편 그대로

pdf_core.py는 11편 그대로 썼습니다. 화면에서 정한 순서와 용량을 받아 11편 함수를 부르는 곳이 runner.py입니다.

파일 넣기와 쪽 그림

10편에서 확정안을 고를 때 걸렸던 부분이 쪽 그림이었습니다. 파일 이름만으로는 사진이 옆으로 누웠는지, 스캔 순서가 맞는지 알 수 없어서 목록 줄마다 첫 쪽 그림을 붙이기로 했는데, pypdf는 PDF를 합치고 나누는 라이브러리라 쪽을 그림으로 그리지는 못합니다.

그래서 pdf.js를 썼습니다. pdf.js는 파이어폭스가 PDF를 보여 줄 때 쓰는 공개 라이브러리로, 웹 페이지 안에서 PDF 쪽을 그림으로 그려 줍니다. 이 도구에서는 목록에 넣은 PDF의 첫 쪽을 작은 그림으로 그리는 데만 씁니다. 라이선스가 Apache-2.0이라 이 도구에 넣어도 지킬 조건이 단순합니다.

const doc = await pdfjs.getDocument({ data: bytes.slice() }).promise;
it.pages = doc.numPages;
const page = await doc.getPage(1);
const vp = page.getViewport({ scale: 1 });
const v2 = page.getViewport({ scale: 120 / Math.max(vp.width, vp.height) });
const c = document.createElement('canvas');
c.width = v2.width; c.height = v2.height;
await page.render({ canvasContext: c.getContext('2d'), viewport: v2 }).promise;
  • 쪽수 알아내기 (numPages): 첫 쪽을 그리려고 PDF를 열면 쪽수도 같이 나와서, 목록에 "PDF · 3쪽"처럼 바로 적습니다.
  • 첫 쪽을 작게 그리기 (getViewport, render): 긴 쪽이 120픽셀이 되도록 줄여서 목록 줄 왼쪽 칸에 그립니다.

사진은 따로 그리지 않고 브라우저가 보여 주는 그대로 넣었습니다. 크롬은 사진 안의 회전 정보대로 세워서 보여 주기 때문에, 5편에서 옆으로 누웠던 휴대폰 사진도 목록에서는 바로 선 모습입니다. PDF로 바꿀 때 세우는 일은 5편 코드가 그대로 합니다.

PC 폭에서 파일 다섯 개를 넣은 화면. 계약서 첫 쪽, 사진 두 장, 동화책 표지가 쪽 그림으로 보이고 사진 줄에는 자동으로 세움 표시, 다섯 번째 암호 PDF 줄은 빨갛게 표시되고 만들기 칸에 나머지 4개는 그대로 합칠 수 있다는 안내

암호 걸린 PDF는 쪽 그림을 그리는 순간 걸러집니다. pdf.js가 암호 때문에 파일을 열지 못하면 그 줄을 빨갛게 바꾸고 빼기 버튼과 안내를 띄웠습니다. 11편까지는 만들기 버튼을 눌러야 암호 파일을 알 수 있었는데, 이제는 넣자마자 보입니다.

순서와 용량

순서는 "파일 이름 숫자순"이 기본입니다. 4편에서 만든 번호순과 같은 순서가 나오도록 브라우저 쪽에서도 숫자를 숫자로 비교해 목록을 바로 정렬했습니다. 위아래 버튼으로 줄을 옮기면 순서가 "넣은 순서"로 바뀌고, 그 목록 순서 그대로 파이썬에 넘깁니다. 화면에 보이는 순서와 결과 PDF의 순서가 다를 일이 없게 하려고, 파이썬 쪽에서는 다시 정렬하지 않습니다.

페이지 안에서 바로 실행

처음에는 8편 시험 페이지처럼 화면과 같은 곳에서 파이썬을 돌렸습니다. 10MB 이하로 만들기를 누르면 결과는 맞게 나왔습니다. 25쪽, 9.2MB였고 계약서의 목차 3개와 링크 1개도 남았습니다.

문제는 만드는 동안입니다. 만들기 칸에는 "만드는 중 · 0초"가 뜬 뒤 숫자가 움직이지 않았습니다. 11편에서 넣은 진행 단계도 끝날 때까지 한 줄도 나오지 않았고, 다 끝난 뒤에 한꺼번에 결과로 바뀌었습니다.

회만드는 데 걸린 시간화면이 멈춰 있던 시간
177.5초77.6초
246.0초46.0초

브라우저는 한 페이지의 화면 그리기와 스크립트 실행을 같은 줄에서 차례로 처리합니다. 파이썬이 그림을 줄이는 동안에는 그 줄이 비지 않아서 초 표시도, 진행 단계도 그려지지 않았습니다. 10편에서 "만드는 중"에 단계와 지금 크기를 보여 주기로 한 화면이 이대로는 소용없는 셈입니다.

작업 스레드로 옮기기

브라우저에는 화면과 따로 스크립트를 돌리는 작업 스레드(Web Worker)가 있습니다. 파이썬 준비와 합치기를 모두 그쪽으로 옮기고, 화면 쪽은 파일 목록을 넘기고 결과만 받게 했습니다. 11편 함수가 단계마다 부르는 알림에는 화면으로 메시지를 보내는 함수를 넘겼습니다.

importScripts('https://cdn.jsdelivr.net/pyodide/v0.26.4/full/pyodide.js');

onmessage = async (e) => {
  await ready;
  const { files, limitMb } = e.data;
  for (const f of files) py.FS.writeFile('/in/' + f.name, f.bytes);
  py.globals.set('알림_js', (text) => postMessage({ type: 'step', text }));
  py.globals.set('names_js', py.toPy(files.map((f) => f.name)));
  py.globals.set('limit_js', limitMb || 0);
  const result = JSON.parse(py.runPython('runner.실행(list(names_js), limit_js, 알림_js)'));
  const bytes = result.ok ? py.FS.readFile('/out.pdf') : null;
  postMessage({ type: 'done', result, bytes }, bytes ? [bytes.buffer] : []);
};
  • 파일을 파이썬 쪽 폴더에 넣기 (py.FS.writeFile): 브라우저 안 파이썬은 자기만의 가상 폴더를 씁니다. 화면에서 받은 파일을 /in 폴더에 그대로 써 넣습니다.
  • 단계마다 화면에 알리기 (알림_js, postMessage): 11편 전체_용량_맞추기가 "화질 75, 크기 69%: 10.3MB"처럼 단계를 알릴 때마다 그 문장이 화면으로 건너갑니다.
  • 결과 넘기기 (postMessage의 두 번째 값): 만든 PDF는 복사하지 않고 화면 쪽으로 통째로 넘겨, 9MB짜리를 한 번 더 메모리에 만들지 않게 했습니다.

같은 파일로 다시 실행했습니다.

작업 스레드로 옮긴 뒤 만드는 중 화면. 만드는 중 38초, 목표 10MB 이하, 1 그대로 합침 31.2MB, 2 화질 75 크기 100% 18.8MB가 차례로 보이고 만들기 버튼은 회색

이번에는 초 표시가 1초마다 올라가고, 진행 단계가 하나씩 늘어났습니다. 화면이 가장 길게 멈춘 시간은 회마다 0.02~0.08초입니다.

준비와 만들기에 걸린 시간

같은 노트북, 같은 파일 다섯 개, 10MB 이하로 여러 번 실행했습니다. 휴대폰 폭은 크롬 창을 390픽셀로 좁혀서 본 것이고, 실제 휴대폰에서 해 본 것은 아닙니다.

방식화면 폭파이썬 준비10MB로 만들기
페이지 안에서 실행PC5.4~6.3초46~78초(그동안 화면 멈춤)
작업 스레드PC5.5~14.8초63~102초
작업 스레드휴대폰 폭4.2~10.3초51~90초
11편 데스크톱 명령어 창--46.9초

같은 방식인데도 회마다 차이가 컸고, 가장 빠를 때는 데스크톱과 비슷했습니다. 진행 단계는 모든 회에서 같았습니다. 다만 크기를 69%로 줄인 단계가 데스크톱에서는 10.2MB, 브라우저에서는 10.3MB였습니다. 브라우저 안 파이썬에 들어 있는 Pillow는 10.2.0이고 데스크톱은 13.0.0으로 버전이 다릅니다. 마지막 결과는 둘 다 9.2MB였습니다.

파이썬 준비 중 화면. 파이썬 준비 중 2초, 그동안 파일은 넣어 둘 수 있다는 노란 안내, 아래 단계 1 2 3과 회색 만들기 버튼

준비가 끝나기 전에는 노란 안내에 경과 초를 띄우고, 파일은 미리 넣을 수 있게 했습니다. 만들기 버튼만 준비가 끝난 뒤에 눌립니다.

결과 파일 확인

휴대폰 폭에서 다 만든 화면. 쪽수 25쪽, 용량 9.2MB 목표 10MB 이하, 목차 3개 링크 1개 남음, 걸린 시간 90.0초, 만든 곳 이 기기 안 서버로 보내지 않음, 내려받기 버튼

다 만들면 쪽수, 용량, 목차·링크가 남았는지, 걸린 시간, 만든 곳을 표로 보여 주고 아래에 내려받기 버튼을 둡니다. 9편에서 다른 사이트를 쓸 때 합친 파일에 목차가 남았는지 열어 봐야 알았던 부분을 여기서 바로 확인하게 했습니다.

내려받은 합친 파일을 크롬에서 연 화면. 4 / 25쪽, 1~3쪽 계약서 다음 4쪽에 휴대폰 사진이 바로 선 채로 들어가 있다

내려받은 파일은 25쪽입니다. 계약서 3쪽 다음에 사진이 바로 선 채로 4쪽에 들어갔고, 동화책 스캔 20쪽과 마지막 사진이 이어졌습니다. 암호 파일은 빠진 채로 합쳐졌습니다.

다음 편에서는 7편에서 돌린 시험표에 웹 시험을 더해 PC와 휴대폰에서 차례로 해 보겠습니다.

제가 쓴 환경은 Windows 11 노트북, 크롬, Pyodide 0.26.4(Pillow 10.2.0), pypdf 6.21.4, pdf.js 4.4.168입니다.

PANCO_IT

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

관련 글

PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 8편 브라우저에서 같은 코드 돌려 보기

PDF 도구를 회사 동료들과 써 볼 사내 시제품으로 웹에 옮기려고 세 방법을 비교하고, Pyodide로 7편 코드를 브라우저에서 그대로 실행해 데스크톱과 같은 결과(16쪽 중 16쪽 일치)를 얻었습니다.

· 파이썬, Pyodide, 웹어셈블리
PDF 도구

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

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

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

파이썬으로 PDF 합치기 프로그램 만들기 10편 화면 흐름과 디자인 시안

사내 시제품 웹 버전을 만들기 전에 화면 상태 여섯 개를 나누고, 스케치로 그린 시안 세 가지를 같은 조건으로 비교해 단계형에 쪽 그림을 붙인 안으로 정하고 디자인 기준을 정리했습니다.

· PDF 합치기, 화면 설계, UI 시안
PDF 도구

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

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

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

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

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

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

파이썬으로 PDF 합치기 프로그램 만들기 7편 더블클릭 실행과 시험

bat 파일로 PDF 도구를 더블클릭해 켜고, 2편에서 만든 시험 11가지와 덮어쓰기 확인을 처음부터 돌려 12개 모두 통과했습니다.

· 파이썬, bat 파일, 배치 파일