hwpers (Indosaram)

hwpers는 한글 워드프로세서(HWP) 파일을 파싱하는 Rust 라이브러리입니다. 전체 레이아웃 렌더링을 지원하는 것이 특징으로, 단순히 텍스트만 뽑는 수준을 넘어 문서가 실제로 어떻게 배치되는지까지 다룹니다. 2025년 8월 시작해 2026년 8월 기준 스타 193개·포크 22개이며 최근 푸시가 2026-08-09로 활발합니다.

라이브러리 계층의 가치

뷰어·에디터·변환기 같은 완성품은 눈에 띄지만, 그 밑에는 반드시 포맷을 해석하는 파서가 있어야 합니다. HWP는 문서화가 충분하지 않은 바이너리 포맷이라 파서를 처음부터 만드는 비용이 큽니다. 잘 만들어진 파서 하나가 그 위에 여러 애플리케이션을 가능하게 합니다.

레이아웃 렌더링이 어려운 이유

텍스트 추출만 하면 문단 순서 정도만 맞추면 됩니다. 하지만 표 병합·단 나눔·글상자·이미지 앵커·줄 배치 캐시까지 해석해야 “원본과 같아 보이는” 결과가 나옵니다. HWP는 이 정보를 자체 구조로 저장하기 때문에 하나하나 역공학해야 합니다.

Rust 선택의 의미

• 파싱 성능이 좋고 메모리 안전성이 보장됨
• WebAssembly로 빌드해 브라우저에서도 동작 가능
• C ABI로 다른 언어에서 호출 가능

바이너리 포맷 파서에 Rust를 쓰는 흐름은 최근 몇 년 사이 확실해졌고, 한국 HWP 생태계에서도 rhwp·Docufinder·hwpers가 모두 Rust입니다.

남이 쓸 부품을 만드는 일

완성품이 아니라 기반 계층을 만드는 기여입니다. 사용자 수로는 측정되지 않지만, 이런 라이브러리가 있어야 그 위의 제품들이 빨라집니다. 오픈소스 생태계에서 “남이 쓸 부품을 만드는 일”의 가치를 보여주는 사례입니다.

같은 결의 한국 HWP 라이브러리

• rhwp (Rust·WASM 뷰어·에디터)
• hwplib · hwpxlib (Java 라이브러리)
• pyhwp (Python 파서)
• hwpjs (JavaScript 뷰어)
• kordoc (파싱·변환 CLI·MCP)

그리고 Rust 생태계는 한국 문서 처리 쪽 사용자가 적습니다. 이슈를 올려도 참고할 사례가 파이썬·자바 구현보다 적을 수 있습니다.

이런 분께 맞아요

• HWP를 다루는 애플리케이션을 만들려는 개발자
• Rust로 바이너리 포맷 파서를 배우려는 개발자
• 문서 변환 파이프라인을 구축하는 팀
• 기존 파서의 레이아웃 정확도가 부족해 대안을 찾는 사람