eKoNLPy 2.2.0__tar.gz → 2.2.2__tar.gz

ekonlpy-2.2.2/.github/workflows/deploy-docs.yaml

@@ -0,0 +1,69 @@
+---
+name: deploy-docs
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - "README.md"
+      - "mkdocs.yaml"
+      - "docs/**"
+      - "pyproject.toml"
+      - ".github/workflows/deploy-docs.yaml"
+  push:
+    branches:
+      - master
+    # Paths can be used to only trigger actions when you have edited certain files, such as a file within the /docs directory
+    paths:
+      - "README.md"
+      - "mkdocs.yaml"
+      - "docs/**"
+      - "pyproject.toml"
+      - ".github/workflows/deploy-docs.yaml"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: deploy-docs-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: 3.12
+
+      - uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          key: docs-${{ runner.os }}-${{ hashFiles('docs/requirements.txt') }}
+          path: .cache
+      - name: Build documentation strictly
+        run: |
+          pip install .
+          pip install -r docs/requirements.txt
+          mkdocs build --strict
+
+  deploy:
+    if: >-
+      github.workflow == 'deploy-docs' && github.ref == 'refs/heads/master' &&
+      (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+    needs: validate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.12"
+      - name: Install documentation dependencies
+        run: |
+          pip install .
+          pip install -r docs/requirements.txt
+      - name: Deploy documentation
+        run: mkdocs gh-deploy --strict --force

ekonlpy-2.2.2/.github/workflows/lint_and_test.yaml

@@ -0,0 +1,97 @@
+---
+name: lint & test
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - master
+    paths:
+      - "src/**"
+      - "tests/**"
+      - "pyproject.toml"
+      - "Makefile"
+      - ".python-version"
+      - ".pre-commit-config.yaml"
+      - ".github/workflows/lint_and_test.yaml"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: lint-and-test-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.12"
+      - run: make install
+      - run: make check
+      - run: make docs-test
+
+  build:
+    name: Python ${{ matrix.python-version }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.12", "3.13", "3.14"]
+        include:
+          - os: ubuntu-latest
+            python-version: "3.9"
+          - os: ubuntu-latest
+            python-version: "3.10"
+          - os: ubuntu-latest
+            python-version: "3.11"
+    defaults:
+      run:
+        shell: bash
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install runtime and test dependencies
+        run: uv sync --no-default-groups --group test
+      - name: Run tests with failure propagation
+        run: UV_NO_SYNC=true make test
+      - name: Check installed dependencies
+        run: uv pip check
+      - name: Build distributions
+        run: uv build
+      - name: Test installed wheel outside checkout
+        run: |
+          wheel=$(python -c 'from pathlib import Path; print(next(Path("dist").glob("*.whl")).resolve().as_posix())')
+          cd "$RUNNER_TEMP"
+          uv run --isolated --no-project --with "$wheel" --with 'pytest>=7.2.1' python -m pytest "$GITHUB_WORKSPACE/tests" -q
+      - name: Test installed source distribution
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.14'
+        run: |
+          sdist=$(python -c 'from pathlib import Path; print(next(Path("dist").glob("*.tar.gz")).resolve().as_posix())')
+          cd "$RUNNER_TEMP"
+          uv run --isolated --no-project --with "$sdist" --with 'pytest>=7.2.1' python -m pytest "$GITHUB_WORKSPACE/tests" -q
+      - name: Upload test reports
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: tests-${{ matrix.os }}-${{ matrix.python-version }}
+          path: |
+            tests/pytest-coverage.txt
+            tests/pytest.xml
+            coverage.xml

{ekonlpy-2.2.0 → ekonlpy-2.2.2}/.github/workflows/release-test.yaml

@@ -8,10 +8,19 @@ on:
     branches:
       - test-release*
 
+concurrency:
+  group: release-publication
+  cancel-in-progress: false
+
 jobs:
+  validate:
+    uses: ./.github/workflows/lint_and_test.yaml
+    permissions:
+      contents: read
+
   release:
+    needs: validate
     runs-on: ubuntu-latest
-    concurrency: release
 
     permissions:
       id-token: write
@@ -22,19 +31,22 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v5
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
 
       - name: Setup | Force correct release branch on workflow sha
+        env:
+          RELEASE_BRANCH: ${{ github.ref_name }}
+          RELEASE_SHA: ${{ github.sha }}
         run: |
-          git checkout -B ${{ github.ref_name }} ${{ github.sha }}
+          git checkout -B "$RELEASE_BRANCH" "$RELEASE_SHA"
 
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v10.4.1
+        uses: python-semantic-release/python-semantic-release@9a026e9303981c866c3425723009becb2437c757 # v10.6.2
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -42,14 +54,14 @@ jobs:
           git_committer_email: "actions@users.noreply.github.com"
 
       - name: Publish | Upload package to TestPyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
         if: steps.release.outputs.released == 'true'
         with:
             password: ${{ secrets.TEST_PYPI_API_TOKEN }}
             repository-url: https://test.pypi.org/legacy/
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v10.4.1
+        uses: python-semantic-release/publish-action@6d89e2de8d40ecb3717316ecbbf15a6fa8ea9039 # v10.6.2
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

{ekonlpy-2.2.0 → ekonlpy-2.2.2}/.github/workflows/release.yaml

@@ -11,10 +11,19 @@ on:
       - "src/**"
       - "pyproject.toml"
 
+concurrency:
+  group: release-publication
+  cancel-in-progress: false
+
 jobs:
+  validate:
+    uses: ./.github/workflows/lint_and_test.yaml
+    permissions:
+      contents: read
+
   release:
+    needs: validate
     runs-on: ubuntu-latest
-    concurrency: release
 
     permissions:
       id-token: write
@@ -25,19 +34,22 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v5
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
 
       - name: Setup | Force correct release branch on workflow sha
+        env:
+          RELEASE_BRANCH: ${{ github.ref_name }}
+          RELEASE_SHA: ${{ github.sha }}
         run: |
-          git checkout -B ${{ github.ref_name }} ${{ github.sha }}
+          git checkout -B "$RELEASE_BRANCH" "$RELEASE_SHA"
 
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v10.4.1
+        uses: python-semantic-release/python-semantic-release@9a026e9303981c866c3425723009becb2437c757 # v10.6.2
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -45,11 +57,11 @@ jobs:
           git_committer_email: "actions@users.noreply.github.com"
 
       - name: Publish | Upload package to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
         if: steps.release.outputs.released == 'true'
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v10.4.1
+        uses: python-semantic-release/publish-action@6d89e2de8d40ecb3717316ecbbf15a6fa8ea9039 # v10.6.2
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

{ekonlpy-2.2.0 → ekonlpy-2.2.2}/.gitignore

@@ -29,4 +29,7 @@ pytest-coverage.*
 
 
 uv.lock
-workspace
+workspace
+
+# MkDocs output
+/site/

{ekonlpy-2.2.0 → ekonlpy-2.2.2}/CHANGELOG.md

@@ -1,5 +1,69 @@
 <!--next-version-placeholder-->
 
+## v2.2.2 (2026-09-17)
+
+### Bug Fixes
+
+- Harden data loading, correct classifier metric bugs, and modernize typing
+  ([#125](https://github.com/entelecheia/eKoNLPy/pull/125),
+  [`a6144e1`](https://github.com/entelecheia/eKoNLPy/commit/a6144e18f09f680874648dd3e5f1f152e34b8833))
+
+- Resolve fugashi-build-dict via PATH fallback and tighten loader consistency
+  ([#125](https://github.com/entelecheia/eKoNLPy/pull/125),
+  [`a6144e1`](https://github.com/entelecheia/eKoNLPy/commit/a6144e18f09f680874648dd3e5f1f152e34b8833))
+
+- Use forward slashes for dictionary compiler paths on Windows
+  ([#125](https://github.com/entelecheia/eKoNLPy/pull/125),
+  [`a6144e1`](https://github.com/entelecheia/eKoNLPy/commit/a6144e18f09f680874648dd3e5f1f152e34b8833))
+
+### Testing
+
+- Expect normalized dictionary compiler paths in build_userdic assertions
+  ([#125](https://github.com/entelecheia/eKoNLPy/pull/125),
+  [`a6144e1`](https://github.com/entelecheia/eKoNLPy/commit/a6144e18f09f680874648dd3e5f1f152e34b8833))
+
+
+## v2.2.1 (2026-09-16)
+
+### Bug Fixes
+
+- Modernize Python compatibility, documentation, and CI
+  ([#124](https://github.com/entelecheia/eKoNLPy/pull/124),
+  [`c07fe16`](https://github.com/entelecheia/eKoNLPy/commit/c07fe16d0b00bbeb0b0f219cf04e22dea2b10815))
+
+- Restore modern Python and notebook reliability
+  ([#124](https://github.com/entelecheia/eKoNLPy/pull/124),
+  [`c07fe16`](https://github.com/entelecheia/eKoNLPy/commit/c07fe16d0b00bbeb0b0f219cf04e22dea2b10815))
+
+### Build System
+
+- **deps**: Bump astral-sh/setup-uv from 6 to 7
+  ([`50dbab6`](https://github.com/entelecheia/eKoNLPy/commit/50dbab651ae9999b136f2f375fc02f4f6b7e325a))
+
+- **deps**: Update pandas requirement
+  ([`66e3713`](https://github.com/entelecheia/eKoNLPy/commit/66e37130d57c7ce5c64b9104b7fe0f17b39f326d))
+
+### Continuous Integration
+
+- Avoid duplicate branch and pull request test runs
+  ([#124](https://github.com/entelecheia/eKoNLPy/pull/124),
+  [`c07fe16`](https://github.com/entelecheia/eKoNLPy/commit/c07fe16d0b00bbeb0b0f219cf04e22dea2b10815))
+
+### Documentation
+
+- Add CLAUDE.md and REVIEW.md for the agent contract
+  ([#121](https://github.com/entelecheia/eKoNLPy/pull/121),
+  [`52f0fb3`](https://github.com/entelecheia/eKoNLPy/commit/52f0fb3cb1934b2de98265559f4aab54e33ecabf))
+
+- Correct CI scope, mypy status, and the ruff test ignores
+  ([#121](https://github.com/entelecheia/eKoNLPy/pull/121),
+  [`52f0fb3`](https://github.com/entelecheia/eKoNLPy/commit/52f0fb3cb1934b2de98265559f4aab54e33ecabf))
+
+- State what the gates actually run and the make test blind spot
+  ([#121](https://github.com/entelecheia/eKoNLPy/pull/121),
+  [`52f0fb3`](https://github.com/entelecheia/eKoNLPy/commit/52f0fb3cb1934b2de98265559f4aab54e33ecabf))
+
+
 ## v2.2.0 (2025-09-21)
 
 ### Chores

ekonlpy-2.2.2/CLAUDE.md

@@ -0,0 +1,76 @@
+# eKoNLPy
+
+Korean NLP library for economic analysis: it extends the KoNLPy `Mecab` tagger so economic terms,
+financial institutions, and company names are treated as single nouns, and adds sentiment scoring
+for monetary policy text (hawkish or dovish). Package `ekonlpy`, sources under `src/ekonlpy/`.
+
+`README.md` and the docs site (https://ekonlpy.entelecheia.ai) carry the usage detail. This file
+covers what an agent needs before its first commit.
+
+## Commands
+
+- Install: `make install` (uv sync, then installs the pre-commit hooks)
+- Check: `make check` (lock-file consistency, `pre-commit run -a`, `deptry .`)
+- Test: `make test` (pytest with coverage, writes `tests/pytest.xml` and `coverage.xml`)
+- Build: `make build` (wheel via hatch), Docs: `make docs-test` (strict mkdocs build), `make docs`
+- Bare `make` prints the target list (`.DEFAULT_GOAL := help`).
+
+## Verifying your work
+
+```bash
+make check && make test
+```
+
+- **Run both before reporting a task complete, and paste the output.** Run `make install` first in a
+  fresh clone, or the hooks `make check` invokes are not present.
+- Make recipes use Bash; the test recipe explicitly enables `pipefail` (also on macOS Make 3.81).
+  A failing pytest run must fail `make test` while still
+  writing the coverage log. Windows contributors can use Git Bash for Make commands.
+- When a test fails, fix the code, not the test. Do not weaken a gate to make a run pass.
+- CI runs on every PR and on master pushes changing source, tests, dependency metadata, Makefile,
+  Python pin, hooks, or the test workflow. It tests Python 3.12-3.14 on Linux/macOS/Windows
+  and 3.9-3.11 on Linux, including installed wheel tests outside the checkout. The Linux 3.14
+  job also tests the sdist. Quality checks run separately on 3.12.
+- Minimal test setup: `uv sync --no-default-groups --group test`; then
+  `UV_NO_SYNC=true make test`. Set `UV_PYTHON` to override the development interpreter in CI.
+
+## Conventions
+
+- Python 3.12 is pinned for development (`.python-version`); the package supports >=3.9,<4.0, and
+  ruff targets py39, so do not use syntax newer than 3.9 in shipped code. Line length 120.
+- Commit messages are gated: the commitizen `commit-msg` pre-commit hook rejects anything that is
+  not a conventional commit.
+- Versioning is automated with python-semantic-release; do not bump versions by hand.
+- Tooling is **configured but not all wired into a gate**. `pyproject.toml` holds settings for ruff
+  (including bandit `S` rules), black, isort, flake8, mypy, deptry, and coverage, yet `make check`
+  runs only the lock check, the configured pre-commit hooks, and `deptry`. The pre-commit hooks are
+  pygrep checks, whitespace and end-of-file fixers scoped to Python, YAML/JSON/large-file checks,
+  and the commitizen `commit-msg` gate. Run the formatters and linters yourself (`uv run ruff check
+  .`, `uv run black --check .`, `uv run mypy src`) or through the `.tasks.toml` poe tasks; nothing
+  else will.
+
+## Things the agent gets wrong
+
+- **`src/ekonlpy/_version.py` is generated** by semantic-release (`version_variables` in
+  `pyproject.toml`). black and isort exclude it and flake8 carries a `W292` per-file ignore for it.
+  Never hand-edit it.
+- **The lock file is local, not committed**: `uv.lock` is gitignored and generated by `make install`
+  (`uv sync`). `make check` starts with `uv lock --locked`, which fails when the generated lock no
+  longer matches `pyproject.toml`, so re-run `uv lock` (or `make install`) after editing
+  dependencies. There is nothing to stage for it.
+- **`deptry` flags dependency drift**: an import that is not a declared dependency, or a declared
+  dependency nothing imports, fails the gate.
+- **pre-commit is `fail_fast`**: the first failing hook stops the run, so fix hooks in order rather
+  than assuming one failure is the only one.
+- **Tests live in `tests/ekonlpy/`** and `testpaths = ["tests"]`; flake8 excludes `tests`, and ruff
+  keeps its rules there minus four per-file ignores: `S101`, `UP035`, `UP006`, `S603`.
+- **Tagger behavior changed in 2.0.0**: the extended tagger is the default and `Mecab` is importable
+  from `ekonlpy` directly; `use_original_tagger=True` restores the original path, and `Mecab.pos()`
+  takes `text`, not `phrase`. Changing tagger defaults is user-visible and needs a test.
+- **The dictionary is a dependency, not vendored**: `mecab-ko-dic` and `fugashi` supply it, so a
+  tagging difference across machines is usually a dependency version difference.
+
+---
+
+Contract and update rule for this file: `_meta/rules/development-lifecycle.md` §6 in the workspace
+repo. When the same mistake appears twice, add the correction here in the same PR.

{ekonlpy-2.2.0 → ekonlpy-2.2.2}/Makefile

@@ -1,3 +1,5 @@
+SHELL := bash
+
 .PHONY: install
 install: install-uv ## Install the virtual environment and install the pre-commit hooks
 	@echo "🚀 Creating virtual environment using uv"
@@ -16,7 +18,7 @@ check: ## Run code quality tools.
 .PHONY: test
 test: ## Test the code with pytest
 	@echo "🚀 Testing code: Running pytest"
-	@uv run python -m pytest --cov --cov-config=pyproject.toml --cov-report=xml --junitxml=tests/pytest.xml | tee tests/pytest-coverage.txt
+	@set -o pipefail; uv run python -m pytest --cov --cov-config=pyproject.toml --cov-report=xml --junitxml=tests/pytest.xml | tee tests/pytest-coverage.txt
 
 .PHONY: build
 build: clean-build ## Build wheel file

ekonlpy-2.2.2/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.5
+Name: eKoNLPy
+Version: 2.2.2
+Summary: A Korean natural language processing toolkit for economic analysis
+Project-URL: Homepage, https://ekonlpy.entelecheia.ai
+Project-URL: Repository, https://github.com/entelecheia/eKoNLPy
+Project-URL: Documentation, https://ekonlpy.entelecheia.ai
+Author-email: Young Joon Lee <yj.lee@chu.ac.kr>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: KoNLPy,Monetary policy,Sentiment analysis,Tokenization
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.9
+Requires-Dist: click>=8.1.6
+Requires-Dist: fugashi>=1.3.3
+Requires-Dist: mecab-ko-dic>=1.0.0
+Requires-Dist: nltk>=3.8.1
+Requires-Dist: numpy>=1.23.5
+Requires-Dist: pandas>=1.5.3
+Requires-Dist: scipy>1.10.0
+Description-Content-Type: text/markdown
+
+# eKoNLPy
+
+[![PyPI](https://img.shields.io/pypi/v/ekonlpy.svg)](https://pypi.org/project/ekonlpy/)
+[![License](https://img.shields.io/github/license/entelecheia/eKoNLPy)](https://github.com/entelecheia/eKoNLPy/blob/master/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-ekonlpy.entelecheia.ai-4c7)](https://ekonlpy.entelecheia.ai)
+
+eKoNLPy is a Python library for Korean text processing in economic and financial
+research. It provides a MeCab based tagger with an economic vocabulary and
+lexicon based sentiment analyzers for Korean and English text.
+
+This documentation follows the repository source, which may include unreleased
+changes. Published versions are listed on [PyPI](https://pypi.org/project/ekonlpy/).
+
+## Install
+
+```bash
+python -m pip install ekonlpy
+```
+
+eKoNLPy supports Python 3.9 or newer, below Python 4. The main CI matrix tests
+Python 3.12-3.14 on Linux, macOS, and Windows, and Python 3.9-3.11 on Linux.
+For Jupyter or Colab, install into the active kernel:
+
+```python
+%pip install ekonlpy
+```
+
+## Quick start
+
+```python
+from ekonlpy import Mecab
+
+tagger = Mecab()
+print(tagger.pos("금통위는 금리정책을 결정했다."))
+```
+
+The default tagger applies eKoNLPy's extended vocabulary. Use
+`Mecab(use_original_tagger=True)` for the underlying fugashi/MeCab tagger.
+Instances keep their dictionaries, synonyms, and lemmas separate from one
+another. See the [documentation](https://ekonlpy.entelecheia.ai) for tagging,
+custom vocabularies, sentiment analyzers, and the CLI.
+
+## Sentiment example
+
+```python
+from ekonlpy.sentiment import MPKO
+
+analyzer = MPKO(kind=1)
+tokens = analyzer.tokenize("금리 인상이 필요하다")
+print(analyzer.get_score(tokens))
+```
+
+The sentiment package also exports `EUKO`, `KSA`, `HIV4`, `LM`, and `MPCK`.
+`KSA` uses KoNLPy's Java backed `Kkma` tokenizer and is optional. The separate
+`KOSAC` analyzer is another optional KoNLPy integration.
+
+## Development
+
+```bash
+make install
+make check
+make test
+make docs-test
+```
+
+Contributions and issue reports are welcome on [GitHub](https://github.com/entelecheia/eKoNLPy).
+For project documentation and verification steps, see the
+[contributing guide](https://ekonlpy.entelecheia.ai/contributing/).
+
+## License and citation
+
+eKoNLPy is released under the [MIT License](LICENSE). Research users can cite
+the project and the monetary policy text mining paper listed in the
+[contributing and citation notes](https://ekonlpy.entelecheia.ai/contributing/).

ekonlpy-2.2.2/README.md

@@ -0,0 +1,74 @@
+# eKoNLPy
+
+[![PyPI](https://img.shields.io/pypi/v/ekonlpy.svg)](https://pypi.org/project/ekonlpy/)
+[![License](https://img.shields.io/github/license/entelecheia/eKoNLPy)](https://github.com/entelecheia/eKoNLPy/blob/master/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-ekonlpy.entelecheia.ai-4c7)](https://ekonlpy.entelecheia.ai)
+
+eKoNLPy is a Python library for Korean text processing in economic and financial
+research. It provides a MeCab based tagger with an economic vocabulary and
+lexicon based sentiment analyzers for Korean and English text.
+
+This documentation follows the repository source, which may include unreleased
+changes. Published versions are listed on [PyPI](https://pypi.org/project/ekonlpy/).
+
+## Install
+
+```bash
+python -m pip install ekonlpy
+```
+
+eKoNLPy supports Python 3.9 or newer, below Python 4. The main CI matrix tests
+Python 3.12-3.14 on Linux, macOS, and Windows, and Python 3.9-3.11 on Linux.
+For Jupyter or Colab, install into the active kernel:
+
+```python
+%pip install ekonlpy
+```
+
+## Quick start
+
+```python
+from ekonlpy import Mecab
+
+tagger = Mecab()
+print(tagger.pos("금통위는 금리정책을 결정했다."))
+```
+
+The default tagger applies eKoNLPy's extended vocabulary. Use
+`Mecab(use_original_tagger=True)` for the underlying fugashi/MeCab tagger.
+Instances keep their dictionaries, synonyms, and lemmas separate from one
+another. See the [documentation](https://ekonlpy.entelecheia.ai) for tagging,
+custom vocabularies, sentiment analyzers, and the CLI.
+
+## Sentiment example
+
+```python
+from ekonlpy.sentiment import MPKO
+
+analyzer = MPKO(kind=1)
+tokens = analyzer.tokenize("금리 인상이 필요하다")
+print(analyzer.get_score(tokens))
+```
+
+The sentiment package also exports `EUKO`, `KSA`, `HIV4`, `LM`, and `MPCK`.
+`KSA` uses KoNLPy's Java backed `Kkma` tokenizer and is optional. The separate
+`KOSAC` analyzer is another optional KoNLPy integration.
+
+## Development
+
+```bash
+make install
+make check
+make test
+make docs-test
+```
+
+Contributions and issue reports are welcome on [GitHub](https://github.com/entelecheia/eKoNLPy).
+For project documentation and verification steps, see the
+[contributing guide](https://ekonlpy.entelecheia.ai/contributing/).
+
+## License and citation
+
+eKoNLPy is released under the [MIT License](LICENSE). Research users can cite
+the project and the monetary policy text mining paper listed in the
+[contributing and citation notes](https://ekonlpy.entelecheia.ai/contributing/).