---
name: 정부 지원 사업 문서 처리 도구 (조직 보유 자산)
description: 정부 지원 사업계획서(docx·hwp·pdf) 작성·편집·검토 시 활용 가능한 로컬 Python 라이브러리 도구 세트. 조직 보유 자산으로 향후 정부 지원 사업 대응 시 즉시 재활용 가능.
type: reference
---

# 정부 지원 사업 문서 처리 도구 — 조직 보유 자산

> **성격**: 로컬 PC(대표자 작업 환경)에 사전 설치 완료된 Python 라이브러리 세트.  
> **용도**: 정부 지원 사업 관련 문서(사업계획서·평가서·제출 양식 등)의 형식(docx·hwp·pdf) 처리.  
> **활용 시점**: 향후 정부 지원 사업 공고 대응, 평가 피드백 반영, 양식 변환·검증 등이 필요할 때 즉시 호출 가능.

## 보유 라이브러리 목록

| 라이브러리 | 용도 |
|-----------|------|
| `pypdf` | PDF 파일 읽기·페이지 수 확인·텍스트 추출 |
| `pyhwp` (`hwp5txt`·`hwp5html`·`hwp5odt`·`hwp5proc` CLI 포함) | 구형 HWP(OLE2) 파일 텍스트·구조 추출 |
| `olefile` | HWP·MS Office 구버전 OLE2 복합 문서 파싱 |
| `lxml` | docx·hwpx 등 XML 기반 문서 고속 파싱·편집 |
| `six` | pyhwp 의존성(Python 2/3 호환 계층) |
| `pywin32` (`win32com.client`) | Windows COM 자동화 — 한컴오피스(HwpObject) 및 MS Word 자동화로 hwp/docx 직접 편집 가능 |

## 활용 가능 작업 패턴

1. **docx 편집** — zip 해제 후 `word/document.xml` 직접 수정 → 재패킹
2. **hwp 텍스트 추출** — `hwp5txt` CLI로 원문 추출
3. **hwp 자동 편집** — `win32com.client.Dispatch("HWPFrame.HwpObject")`로 한컴오피스 COM 자동화 (텍스트 삽입·Find/Replace·저장). 단 한컴 10(2018) COM API의 `AllReplace` 파라미터 바인딩은 제한적이므로 표 편집·Find/Replace 자동화는 보조적으로 활용하고 복잡 편집은 docx 경유 권장
4. **pdf 검토** — `pypdf`로 페이지 수·텍스트 추출, Claude PDF 읽기로 시각 검증 병행
5. **포맷 변환 경로** — hwp(구형) ↔ docx(한컴오피스 수동 변환) ↔ XML 편집 (한컴 2018 설치 환경 필수)

## 전제 환경

- OS: Windows 10/11
- Python: 3.10 (`C:\Users\PC\AppData\Local\Programs\Python\Python310\`)
- 한컴오피스 2018 (`C:\Program Files (x86)\Hnc\Office 2018\`) — hwp COM 자동화 및 hwp↔docx 수동 변환에 필수
- MS Word (docx 시각 확인용)

## 접근 노하우

- 구형 HWP(OLE2)의 **프로그래밍 직접 편집은 파일 손상 리스크가 높음** — docx로 변환 후 XML 편집이 가장 안전
- docx 편집 시 원본 `<w:tblPr>`·`<w:tblGrid>` 서식을 유지해야 Word 호환성 유지
- 한글 COM Find/Replace는 `s.Direction = 2` (AllDoc) 명시 필요. 파라미터셋 일부 속성(`SeveralLines` 등)은 한컴 10에서 미지원
- `rm` 차단 환경에서는 PowerShell `Remove-Item -LiteralPath ... -Recurse -Force` 사용 (한국어 경로 대응)
