{"id":28088,"library":"pyhwp","title":"pyhwp","description":"A Python library for parsing HWP (Hangul Word Processor) files, a legacy Korean document format. Current version 0.1b15, beta release cadence is irregular.","status":"active","version":"0.1b15","language":"python","source_language":"en","source_url":"https://github.com/mete0r/pyhwp","tags":["hwp","parser","korean","document"],"install":[{"cmd":"pip install pyhwp","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"XML parsing for HWPML extraction","package":"lxml","optional":false}],"imports":[{"note":"HWPFile is in the hwp5 submodule, not top-level","wrong":"from pyhwp import HWPFile","symbol":"HWPFile","correct":"from pyhwp.hwp5 import HWPFile"}],"quickstart":{"code":"from pyhwp.hwp5 import HWPFile\nimport os\n\nhwp_path = os.environ.get('HWP_SAMPLE', 'sample.hwp')\nhwp = HWPFile(hwp_path)\nprint(hwp.to_text())","lang":"python","description":"Read text content from an HWP file."},"warnings":[{"fix":"Pin to a specific version, e.g., pyhwp==0.1b15","message":"The package is in beta (0.1b15); API stability is not guaranteed. Expect breaking changes between versions.","severity":"gotcha","affected_versions":"all"},{"fix":"Install from PyPI with correct case: pip install pyhwp","message":"PyPI name 'pyhwp' may be confused with 'pyhwp' Chinese word processor library, but this is the Korean HWP parser.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use correct import: from pyhwp.hwp5 import HWPFile","cause":"The package is installed but import path is wrong; users try 'import pyhwp' instead of 'from pyhwp.hwp5 import HWPFile'.","error":"ModuleNotFoundError: No module named 'pyhwp'"},{"fix":"Import from the hwp5 submodule: from pyhwp.hwp5 import HWPFile","cause":"Attempting to import HWPFile from the top-level pyhwp package.","error":"AttributeError: module 'pyhwp' has no attribute 'HWPFile'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}