PDF 도구

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

PANCO_IT
#파이썬#PDF 합치기#요구사항 정의서#유스케이스

사무실 책상에 쌓인 서류와 파일 폴더

사진: Wesley Tingey / Unsplash

회사에서 일을 하다 보면 PDF를 손볼 일이 은근히 자주 생깁니다.

거래처에서는 견적서와 사업자등록증을 파일 하나로 묶어 보내 달라고 하고, 연말정산 때는 증빙 서류를 PDF 하나로 올리라고 합니다. 복합기로 스캔하면 장마다 '스캔 (1)', '스캔 (2)'처럼 파일이 따로 나오고, 휴대폰으로 찍은 서류는 사진이라 PDF로 다시 바꿔야 합니다. 겨우 하나로 묶어서 올리려고 하면 '10MB 이하만 올릴 수 있습니다'라는 안내가 뜨기도 합니다.

그럴 때마다 무료 PDF 사이트를 찾아 파일을 올리고, 합친 파일을 받아서 용량 줄이는 사이트에 또 올렸습니다. 그런데 사업자등록증이나 등본을 잘 모르는 사이트에 계속 올리는 게 찜찜했습니다. 무료 횟수를 다 써서 중간에 막힌 적도 있었습니다.

그래서 제 노트북에서만 돌아가는 프로그램을 파이썬으로 직접 만들어 쓰기로 했습니다.

처음에는 합치기만 되면 충분하다고 생각했습니다. 그런데 PDF를 쓰던 상황을 하나씩 떠올려 보니 폴더째 합치기, 사진을 PDF로 바꾸기, 용량 줄이기에 창 화면까지 있어야 편하게 쓸 것 같았습니다.

생각나는 대로 짜기 시작하면 기능을 덧붙일 때마다 코드가 엉망이 될 것 같아서, 코드를 짜기 전에 무엇이 필요한지부터 정리했습니다.

1. PDF 쓰면서 불편했던 점

막상 요구사항을 쓰려고 하니 뭐부터 적어야 할지 막막했습니다. 그래서 평소에 PDF 때문에 귀찮았던 일부터 생각나는 대로 적어 봤습니다.

이럴 때번거로운 점필요한 기능
서류 여러 개를 한 파일로 보낼 때사이트에 하나씩 올리고, 순서가 틀리면 다시 해야 함고른 순서대로 합치기
여러 장을 스캔했을 때장마다 파일이 따로 생겨서 하나하나 골라야 함폴더째 넣으면 번호 순서대로 합치기
이름 순서대로 합쳤을 때'스캔 (1)' 다음에 '스캔 (10)'이 붙기도 함숫자는 숫자로 보고 정렬
휴대폰으로 서류를 찍었을 때사진을 PDF로 바꿔 주는 곳을 또 찾아야 함사진 여러 장을 PDF로 묶기
용량 제한이 있을 때사진이 든 PDF는 금방 10MB를 넘음정한 MB 아래로 줄이기
한두 장만 순서를 바꿀 때처음부터 다시 골라야 함목록에서 위아래로 옮기기
합치고 나서원본이 바뀌었을까 봐 불안함결과는 새 파일로 저장
쓸 때마다터미널을 열고 명령어를 쳐야 함창에서 눌러 쓰기
암호 걸린 PDF를 받았을 때오류만 나고 이유를 모름암호 걸린 파일이라고 알려 주기

암호 걸린 PDF는 이번엔 손대지 않기로 했습니다. 암호 입력 칸까지 만들면 일이 커지고, 암호를 푸는 기능은 남의 문서를 여는 데 쓰일 수도 있어서 내키지 않았습니다. 그런 파일은 못 넣는다고 알려 주기만 하겠습니다.

2. 요구사항 정의서

이렇게 적고 나니 만들어야 할 기능이 거의 다 나왔습니다. 그래서 이걸 요구사항 정의서 형식으로 정리했습니다.

합치기, 사진 묶기처럼 프로그램이 해야 하는 일은 기능(FR), '원본은 건드리지 않는다'처럼 꼭 지켜야 하는 조건은 비기능(NFR)으로 나눴습니다.

ID요구사항우선순위확인 방법
FR-01PDF 여러 개를 고른 순서대로 합친다필수2쪽+1쪽 → 3쪽인지 센다
FR-02폴더를 넣으면 번호 순서대로 합친다필수'스캔 (1)'~'스캔 (11)'이 순서대로인지 본다
FR-03사진 여러 장을 PDF 한 권으로 만든다필수사진 5장 → 5쪽인지 센다
FR-04사진을 묶은 PDF를 정한 용량(MB) 아래로 줄인다필수사진 5장, 1MB로 정하고 결과 크기를 본다
FR-05목록에서 순서를 바꾸고 뺄 수 있다필수순서를 바꾼 뒤 결과 쪽 순서를 본다
FR-06끝나면 쪽수와 용량을 보여 준다선택상태줄 문구를 본다
NFR-01파일을 인터넷으로 보내지 않는다필수와이파이를 끄고 해 본다
NFR-02원본 파일을 바꾸지 않는다필수실행 전후 원본 크기·수정 시각을 비교한다
NFR-03한글 이름 파일·폴더에서도 된다필수한글 이름 폴더에서 돌린다
NFR-04명령어 없이 창에서 쓴다필수더블클릭으로 켜서 끝까지 해 본다
NFR-05코드를 공개할 수 있는 라이브러리만 쓴다필수라이선스를 확인한다

표를 다 쓰고 다시 읽어 보니 FR-04가 애매했습니다. 처음에는 '정한 용량(MB) 아래로 줄인다'라고만 적었는데, 이렇게 두면 무엇을 줄인다는 건지가 분명하지 않습니다. 이미 PDF인 파일을 합친 결과도 줄여야 하는지, 사진을 묶은 PDF만 줄이면 되는지에 따라 만들 기능이 꽤 달라집니다.

평소 상황을 다시 떠올려 보니 용량 제한에 걸린 건 늘 사진이 들어간 PDF였습니다. 스캔한 PDF끼리 합친 파일이 10MB를 넘는 일은 드물었습니다. 그래서 FR-04를 '사진을 묶은 PDF를 정한 용량 아래로 줄인다'로 고치고, PDF끼리 합친 파일의 용량을 줄이는 건 나중으로 미뤘습니다.

3. 유스케이스 다이어그램

표로만 보니 기능끼리 어떻게 이어지는지가 잘 안 보여서 유스케이스 다이어그램도 하나 그렸습니다. 그림은 draw.io로 그렸습니다. 브라우저에서 바로 열리고, 왼쪽 도형 목록에 사람 모양이 있어서 이런 그림을 그리기 편합니다.

draw.io에서 그린 유스케이스 다이어그램

폴더째 합칠 때는 번호 순서 정렬이 항상 따라오니 include로 이었고, 파일 순서 바꾸기는 PDF를 합칠 때나 사진을 묶을 때나 똑같이 쓰니 두 기능에 모두 include로 붙였습니다.

용량 줄이기는 위에서 FR-04를 고친 대로 사진 묶기에만 extend로 붙였습니다. 용량 칸을 채웠을 때만 일어나는 일이라 extend로 이었습니다.

4. 유스케이스 명세

다이어그램은 무엇을 할 수 있는지만 보여 주고, 버튼을 누른 뒤 어떤 순서로 진행되는지나 중간에 문제가 생기면 어떻게 되는지는 보여 주지 않습니다. 그래서 사용자가 직접 시작하는 유스케이스 세 개에 대해 명세를 적었습니다.

흐름은 세 가지로 나눴습니다. 평소대로 진행되는 기본 흐름, 사용자가 다른 길을 고를 때의 대안 흐름, 문제가 생겼을 때의 예외 흐름입니다. 대안·예외 흐름 앞의 번호는 기본 흐름의 몇 번째 단계에서 갈라지는지를 뜻합니다.

UC-01 PDF 여러 개 합치기

항목내용
액터사용자
사전 조건합칠 PDF가 두 개 이상 있다
기본 흐름1. 'PDF 합치기'를 고른다
2. '파일 추가'로 PDF를 고른다
3. 목록에서 순서를 확인하고, 필요하면 위·아래로 옮긴다
4. 저장 위치를 확인하고 '만들기'를 누른다
5. 새 PDF가 저장되고 상태줄에 쪽수와 용량이 나온다
대안 흐름3a. 필요 없는 파일을 목록에서 빼고 진행한다
4a. 같은 이름의 파일이 있으면 덮어쓸지 묻는다. '아니오'를 고르면 저장 위치를 다시 고른다
예외 흐름2a. 암호가 걸린 PDF는 목록에 넣지 않고 "암호가 걸린 파일은 넣을 수 없습니다"를 띄운다
2b. 깨진 PDF는 목록에 넣지 않고 파일 이름을 알려 준다
4b. 저장할 폴더에 쓸 권한이 없으면 다른 위치를 고르라고 알려 준다
사후 조건원본 PDF는 그대로 있고, 합친 PDF 하나가 새로 생긴다

UC-02 폴더 속 PDF 한 번에 합치기

항목내용
액터사용자
사전 조건PDF가 든 폴더가 있다
기본 흐름1. 'PDF 합치기'를 고른다
2. '폴더 추가'로 폴더를 고른다
3. 폴더 안의 PDF가 파일 이름의 번호 순서대로 목록에 들어간다
4. 목록을 확인하고 '만들기'를 누른다
5. 새 PDF가 저장되고 상태줄에 쪽수와 용량이 나온다
대안 흐름3a. 폴더 안에 PDF가 아닌 파일이 있으면 목록에 넣지 않고 넘어간다
3b. '파일 추가'로 다른 PDF를 더 넣을 수 있다
예외 흐름3c. 폴더에 PDF가 하나도 없으면 "이 폴더에는 PDF가 없습니다"를 띄운다
그 밖의 예외는 UC-01과 같다
사후 조건원본 PDF는 그대로 있고, 합친 PDF 하나가 새로 생긴다

UC-03 사진 여러 장을 PDF로 묶기

항목내용
액터사용자
사전 조건JPG나 PNG 사진이 있다
기본 흐름1. '사진 → PDF'를 고른다
2. '파일 추가'나 '폴더 추가'로 사진을 넣는다
3. 목록에서 순서를 확인하고, 필요하면 위·아래로 옮긴다
4. 저장 위치를 확인하고 '만들기'를 누른다
5. 사진 한 장이 한 쪽인 PDF가 저장되고 상태줄에 쪽수와 용량이 나온다
대안 흐름4a. 용량 제한을 체크하고 MB를 넣었으면, 저장한 뒤 용량을 확인한다. 정한 용량을 넘으면 화질을 낮춰 다시 저장하고, 그래도 넘으면 사진 크기를 줄여 다시 저장한다(용량 줄이기)
예외 흐름2a. 사진으로 열리지 않는 파일은 목록에 넣지 않고 파일 이름을 알려 준다
4b. MB 칸에 숫자가 아닌 값이 있으면 '만들기'를 막고 안내한다
4c. 사진 크기를 끝까지 줄여도 정한 용량이 안 되면 "이 용량으로는 만들 수 없습니다"를 띄운다
사후 조건원본 사진은 그대로 있고, PDF 하나가 새로 생긴다

'파일 순서 바꾸기', '번호 순서로 정렬', '용량 줄이기'는 위 흐름 안에 단계로 들어가 있어서 따로 명세를 쓰지 않았습니다.

5. 만들 범위

하고 싶은 걸 다 넣으면 끝이 안 날 것 같아서, 이번에 만들 것과 나중으로 미룰 것을 나눠 적었습니다.

이번에 만들 것나중에
PDF 합치기, 폴더째 합치기, 번호 순서 정렬쪽 나누기, 쪽 돌리기, 쪽 지우기
JPG·PNG 사진을 PDF로 묶기아이폰 사진 형식(HEIC)
사진을 묶은 PDF를 정한 용량 아래로 줄이기PDF끼리 합친 파일 용량 줄이기, 글자 인식(OCR)
창 화면, 더블클릭 실행설치 프로그램(.exe), 맥·리눅스
암호 걸린 PDF는 못 넣는다고 알리기암호 풀기

쪽 나누기나 돌리기도 있으면 좋겠지만, 합치기만큼 자주 쓰지는 않아서 다음으로 미뤘습니다.

6. 일정

작업을 단계별로 나눠서 일정표(WBS)를 만들었습니다. 퇴근하고 짬을 내서 하는 일이라 날짜는 넉넉하게 범위로 잡았습니다.

단계할 일예상 기간
분석불편 사항 정리, 요구사항 정의서, 유스케이스와 명세10월 마지막 주, 저녁 1~2일
설계흐름도, 화면 설계, 코드 나누기, 시험 계획10월 마지막 주, 저녁 1~2일
구현설치와 첫 합치기, 폴더 합치기, 사진 묶기와 용량 맞추기11월 첫째 주, 저녁 2~3일
구현창 화면(tkinter)11월 첫째둘째 주, 저녁 23일
마무리더블클릭 실행, 시험 결과, 사용법11월 둘째 주, 주말 하루

구현은 기능을 하나씩 명령어로 돌려 보며 만들고, 마지막에 창 화면에 붙일 생각입니다.

정의서를 다 쓰고 나서는 처음에 적어 둔 상황들과 하나씩 비교해 보면서 빠진 게 없는지 확인했습니다.

다음 편

다음 편에서는 버튼을 눌렀을 때 프로그램이 어떤 순서로 움직일지 흐름도를 그리고, 창 화면도 미리 그려 보겠습니다.

PANCO_IT

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

관련 글

PDF 도구

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

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

· 파이썬, PDF 합치기, 흐름도
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
PDF 도구

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

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

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

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

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

· 파이썬, tkinter, PDF 합치기