helper-hwp 0.5.5

Python HWP 파일 파서 및 텍스트 추출 라이브러리

helper_hwp

Python으로 작성된 HWP (한글 문서) 파일 파서 및 텍스트 추출 라이브러리입니다.

특징

• HWP 5.x 포맷 지원 (CFB 기반)
• 텍스트 추출 및 마크다운 변환
• 표, 페이지 단위 파싱 지원
• 단위 변환 유틸리티 제공 (HWPUNIT ↔ cm/inch/px)

설치

pip install helper-hwp

또는 소스에서 설치:

git clone https://github.com/c0z0c-helper/helper_hwp.git
cd helper_hwp
pip install -e .

빠른 시작

텍스트 추출

from helper_hwp import hwp_to_txt

# HWP 파일에서 텍스트 추출
text = hwp_to_txt('example.hwp')
print(text)

마크다운 변환

from helper_hwp import hwp_to_markdown

# HWP 파일을 마크다운으로 변환
markdown = hwp_to_markdown('example.hwp')
print(markdown)

문서 객체 사용

from helper_hwp import open_hwp

# HWP 문서 열기
doc = open_hwp('example.hwp')

# 테그 단위 순회
for paragraph in doc.iter_tags():
    print(paragraph.text)

Examples

다음 예제를 참고하세요:

• HWP → 텍스트 변환
• HWP → Markdown 변환
• 태그 순회 → JSON

또는 소스 배포판(sdist)을 다운로드하여 확인:

pip download --no-deps helper-hwp
tar -xzf helper_hwp-*.tar.gz

문서

• 사용자 가이드 - 기본 사용법 및 예제
• 개발자 문서 - 프로젝트 구조 및 개발 가이드

요구사항

• Python 3.8 이상
• olefile >= 0.46
• pycryptodome >= 3.15.0

라이센스

이 프로젝트는 Apache License 2.0 라이센스 하에 배포됩니다.

누구나 자유롭게 사용하고 수정할 수 있으며, 사용 시 출처를 표기해 주세요.

출처: https://github.com/c0z0c-helper/helper_hwp

자세한 내용은 LICENSE 파일을 참조하세요.

기여

프로젝트에 대한 기여를 환영합니다! 기여 방법은 개발자 문서를 참조하세요.

변경 이력

변경 이력은 CHANGELOG.md를 참조하세요.