hwplib · hwpxlib (neolord0)

hwplib은 Java용 HWP 라이브러리이고, 같은 메이커가 만든 hwpxlib은 HWPX용입니다. hwplib은 2016년 12월 시작해 2026년 8월 기준 스타 586개·포크 189개, hwpxlib은 2023년 2월 시작해 스타 181개·포크 49개를 기록 중입니다. 두 저장소 모두 2026년 7~8월에 푸시가 있어 지금도 유지되고 있습니다.

10년 유지가 갖는 의미:
오픈소스에서 가장 어려운 건 시작이 아니라 지속입니다. hwplib은 2016년부터 약 10년째 유지되고 있고, 포크 189개는 실제로 프로덕션에서 쓰이고 있다는 신호입니다. 한국 기업 시스템은 Java·Spring 기반이 압도적으로 많은데, 그 환경에서 HWP를 다뤄야 할 때 사실상 표준 선택지 역할을 해왔습니다.

hwplib(HWP) vs hwpxlib(HWPX)

• HWP: 한컴의 전통 바이너리 포맷. 문서화가 부족해 역공학 비중이 큼
• HWPX: OWPML 기반 XML 포맷. 구조가 열려 있어 상대적으로 다루기 쉬움

한컴이 HWPX를 밀면서 신규 문서는 HWPX가 늘고 있지만, 기존 문서는 여전히 HWP입니다. 그래서 두 라이브러리가 모두 필요하고, 같은 메이커가 둘 다 유지하는 구조가 실용적입니다.

어디에 쓰이나

• 전자문서 시스템의 HWP 생성·변환
• 공공기관 연계 시스템의 문서 파싱
• 문서 자동 생성(증명서·계약서·보고서)
• 배치 변환 파이프라인

없으면 곤란한 사람이 몇 명인가

화제성은 낮지만 대체 불가능한 인프라를 오래 유지하는 유형입니다. 이런 프로젝트는 스타 수보다 “없으면 곤란한 사람이 얼마나 되는가”로 가치를 재야 합니다. 한국 기업 시스템에서 HWP를 다뤄본 개발자라면 대부분 이 이름을 만나게 됩니다.

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

• hwpers (Rust 파서)
• pyhwp (Python 파서)
• hwpjs (JavaScript 뷰어)
• rhwp (Rust·WASM 뷰어·에디터)
• pypandoc-hwpx (Pandoc 기반 변환)

그리고 자바 라이브러리는 서버 환경에 붙이기는 좋지만 데스크톱·웹에서는 무겁습니다. 브라우저에서 보여줘야 한다면 다른 구현을 함께 봐야 합니다.

이런 분께 맞아요

• Java·Spring 시스템에서 HWP를 다뤄야 하는 개발자
• 공공기관 연계 문서 시스템을 구축하는 팀
• 증명서·계약서 자동 생성이 필요한 서비스
• 오래 유지되는 오픈소스 운영 방식을 참고하려는 메이커