PDF 도구

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

PANCO_IT
#파이썬#PDF 합치기#흐름도#화면 설계#테스트 계획

1편에서 무엇을 만들지는 정했습니다. 그런데 막상 코드를 짜려고 하니, 버튼을 눌렀을 때 무엇부터 해야 하는지가 머릿속에서 잘 그려지지 않았습니다.

그래서 코드 대신 흐름도부터 그렸습니다. 그림은 1편과 마찬가지로 draw.io로 그렸습니다.

처리 흐름도

파일을 고르는 데서 시작해 결과 파일이 나올 때까지를 순서도로 그려 보니 이렇게 됐습니다.

draw.io에서 그린 처리 흐름도

그리다 보니 결과를 어디에 저장할지부터 걸렸습니다. 원본 위에 덮어쓰는 건 생각만 해도 불안해서, 결과는 무조건 새 파일로 저장하기로 했습니다.

처음 그린 흐름도에서는 PDF를 합치든 사진을 묶든 저장한 다음에 용량을 확인하게 해 두었습니다. 1편 요구사항을 다시 읽어 보니 용량은 사진을 묶을 때만 줄이기로 정해 놓았는데, 이대로면 PDF를 합칠 때도 용량 제한 칸이 열려 있게 됩니다. 그래서 용량 확인은 사진을 PDF로 바꾼 뒤에만 하고, PDF 합치기는 저장하면 바로 끝나게 고쳤습니다.

용량을 줄이는 방법도 흐름도를 그리면서 정했습니다. 사진을 PDF에 넣을 때는 화질을 0~100 사이 숫자로 정할 수 있어서, 화질부터 낮추는 게 가장 손쉽습니다.

다만 화질만 계속 내리면 서류 사진 속 글자가 뭉개질 것 같았습니다. 그래서 화질은 50 밑으로 내리지 않고, 그래도 정한 용량보다 크면 그때부터 사진 가로세로를 80%씩 줄이기로 했습니다.

화질을 한 번에 10씩 내리는 것과 사진을 80%씩 줄이는 것은 아직 실제 사진으로 재 보지 않고 정한 숫자입니다. 사진을 묶는 코드를 짤 때 직접 돌려 보고 맞는지 다시 보겠습니다.

화면 설계

창 화면도 코드로 바로 짜면 버튼 자리를 몇 번이고 옮기게 될 것 같아서, 먼저 그림으로 그려 봤습니다.

실무에서는 이런 그림을 와이어프레임이라고 합니다. 색이나 글꼴은 신경 쓰지 않고 무엇을 어디에 둘지만 정합니다.

draw.io에서 그린 화면 설계

화면에 있는 것들이 각각 무슨 일을 하는지도 적어 뒀습니다.

번호화면 요소하는 일
1할 일 고르기PDF 합치기와 사진 → PDF 중에서 고름
2파일 목록합쳐질 순서대로 보임
3버튼들파일·폴더 추가, 위로·아래로, 빼기
4용량 제한사진 → PDF일 때만 켜짐. 체크하고 MB 숫자를 넣음
5저장 위치같은 이름 파일이 있으면 물어봄
6만들기목록이 비어 있으면 안 눌림
7상태줄끝나면 쪽수와 용량을 보여 줌

같은 이름 파일이 있으면 물어보게 한 건 화면 설명을 적다가 생각났습니다. 말없이 덮어썼는데 그게 지난번에 만들어 둔 파일이면 되돌릴 방법이 없습니다.

모듈 나누기

화면과 기능을 한 파일에 섞어 두면 버튼 하나 옮기다가 합치기 코드까지 건드리게 될 것 같았습니다.

그래서 파일을 둘로 나눴습니다. 창은 pdf_tool_ui.py, 실제로 PDF를 다루는 함수는 pdf_core.py에 두고, 창 쪽에서는 함수를 부르기만 합니다.

draw.io에서 그린 모듈 구조

번호순은 처음에 pdf_합치기 안에 넣어 둘 생각이었습니다. 그런데 휴대폰 사진도 이름 끝에 번호가 붙어서, 사진을 묶을 때도 같은 순서 문제가 날 수 있었습니다. 그래서 따로 떼어 내 두 함수가 같이 쓰게 했습니다.

함수마다 무엇을 넣으면 무엇이 나오는지, 잘못된 파일이 들어오면 어떻게 할지도 미리 적어 뒀습니다. 이걸 정해 두면 창을 만들 때 기능 코드를 다시 열어 보지 않아도 됩니다.

함수넣는 것나오는 것잘못됐을 때
번호순파일 경로번호 순서로 정렬할 기준-
pdf_합치기PDF 목록, 저장 경로쪽수암호·깨진 파일 이름을 알려 줌
사진_pdf사진 목록, 저장 경로, 화질, 크기쪽수안 열리는 사진 이름을 알려 줌
용량_맞추기사진 목록, 저장 경로, 제한 MB최종 용량끝까지 줄여도 안 되면 알려 줌

창은 tkinter로 만들 생각입니다. 파이썬을 깔면 같이 들어와서 따로 설치할 게 없습니다. 이미 pypdf와 Pillow를 깔아야 하는데, 화면 때문에 하나 더 늘리고 싶지는 않았습니다.

예외 처리

흐름도는 잘 될 때만 그린 거라, 이상한 파일이 들어오면 어떻게 할지도 따로 적었습니다. 아무 처리도 안 하면 프로그램이 오류를 내고 꺼져 버리고, 쓰는 사람은 왜 안 되는지 모릅니다.

이럴 때이렇게
암호 걸린 PDF"암호가 걸린 파일은 넣을 수 없습니다" 안내
깨진 PDF어느 파일인지 이름을 보여 줌
목록이 비어 있음만들기 버튼이 안 눌림
용량 칸에 숫자가 아닌 값만들기를 막고 안내
같은 이름 파일이 있음덮어쓸지 물어봄
저장할 권한이 없는 폴더다른 위치를 고르라고 안내

테스트 계획

1편에서 요구사항마다 적어 둔 확인 방법을 시험 항목으로 바꿨습니다.

항목마다 어떤 요구사항을 확인하는지 붙여 두면, 나중에 빠뜨린 요구사항이 없는지 한 번에 볼 수 있습니다. 실무에서는 이걸 요구사항 추적표라고 부릅니다.

TC요구사항해 볼 것이렇게 나와야 함
TC-01FR-012쪽 PDF + 1쪽 PDF3쪽 파일
TC-02FR-02'스캔 (1)'~'스캔 (11)' 폴더1~11 순서대로
TC-03FR-03사진 5장5쪽 파일
TC-04FR-04사진 5장, 제한 1MB결과 1MB 이하
TC-05FR-053번째 파일을 맨 위로첫 쪽이 그 파일
TC-06FR-06TC-01 실행상태줄에 쪽수와 용량
TC-07NFR-01와이파이를 끄고 TC-01똑같이 됨
TC-08NFR-02TC-01 전후 원본 비교원본 그대로
TC-09NFR-03한글 이름 폴더에서 TC-02똑같이 됨
TC-10NFR-04더블클릭으로 TC-01끝까지 됨
TC-11예외암호 걸린 PDF를 섞어서 TC-01안내가 뜨고 꺼지지 않음

시험은 기능을 다 만들고 창까지 붙인 뒤에 이 표 순서대로 처음부터 돌려 보겠습니다.

다음 편부터는 코드를 짜 보겠습니다. pypdf와 Pillow를 설치하고, PDF 두 개를 합치는 것부터 해 보겠습니다.

PANCO_IT

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

관련 글

PDF 도구

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

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

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

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

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

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

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

10편 스케치대로 웹 화면을 만들고 11편 pdf_core.py를 붙여 브라우저에서 돌렸습니다. pdf.js로 쪽 그림을 그리고, 만드는 동안 화면이 멈추던 문제를 작업 스레드로 옮겨 고친 뒤 걸린 시간과 결과 파일을 확인했습니다.

· PDF 합치기, 웹 버전, Pyodide
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 9편 무료 PDF 합치기 사이트 다섯 곳 써 보기

회사 동료들과 쓸 사내 시제품을 만들기 전에 무료 PDF 합치기 사이트 다섯 곳에 같은 파일을 넣어 써 보고, 목차가 사라지거나 사진이 눕는 등 불편했던 점과 시제품 요구사항을 정리했습니다.

· PDF 합치기, PDF 합치기 사이트, 무료 PDF 합치기
PDF 도구

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

pypdf와 Pillow를 설치하다 나온 pip 캐시 경고의 원인을 확인하고, 연습용 PDF 두 개를 만들어 처음으로 합쳐 봤습니다.

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

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

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

· 파이썬, PDF 합치기, pypdf