helper-plot-hangul 0.5.0__tar.gz

helper_plot_hangul-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 c0z0c
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

helper_plot_hangul-0.5.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include requirements.txt
+include requirements-dev.txt
+recursive-include src/helper_plot_hangul/fonts *.ttf

helper_plot_hangul-0.5.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: helper-plot-hangul
+Version: 0.5.0
+Summary: Matplotlib 한글 폰트 자동 설정 라이브러리
+Author-email: c0z0c <c0z0c.dev@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/c0z0c-helper/helper_plot_hangul
+Project-URL: Repository, https://github.com/c0z0c-helper/helper_plot_hangul
+Project-URL: Issues, https://github.com/c0z0c-helper/helper_plot_hangul/issues
+Keywords: matplotlib,한글,hangul,font,korean,plot,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib>=3.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# helper-plot-hangul
+
+Matplotlib 한글 폰트 자동 설정 라이브러리
+
+## 개요
+
+`helper-plot-hangul`은 Matplotlib에서 한글을 자동으로 표시할 수 있도록 폰트를 설정해주는 라이브러리입니다. 번거로운 폰트 설정 없이 간단하게 한글 그래프를 그릴 수 있습니다.
+
+## 특징
+
+- **자동 폰트 설정**: NanumGothic 폰트를 자동으로 로드하고 설정
+- **완전한 matplotlib 리셋**: 폰트 캐시를 포함한 완전한 초기화
+- **스타일 호환**: matplotlib 스타일 적용 후에도 한글 폰트 자동 유지
+- **Jupyter/Colab 최적화**: IPython 환경에서 완벽하게 작동
+- **NumPy 2.0+ 호환**: 최신 NumPy와 호환되는 안전한 폰트 설정
+- **내장 폰트**: NanumGothic 폰트 포함 (별도 설치 불필요)
+
+## 설치
+
+```bash
+pip install helper-plot-hangul
+
+# 테스트 서버
+pip install --index-url https://test.pypi.org/simple/ helper-plot-hangul
+```
+
+## 사용법
+
+### 기본 사용법
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 자동 설정 (NanumGothic 기본값)
+plt = matplotlib_font_reset()
+
+# 바로 한글 사용 가능
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('한글 제목')
+plt.xlabel('X축')
+plt.ylabel('Y축')
+plt.show()
+```
+
+### 사용자 정의 폰트 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 시스템 폰트 이름으로 설정
+plt = matplotlib_font_reset(font_family='맑은 고딕')
+
+# 또는 폰트 파일 경로로 설정
+plt = matplotlib_font_reset(font_path='/path/to/font.ttf')
+```
+
+### 추가 옵션 설정
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# matplotlib rcParams 추가 설정
+plt = matplotlib_font_reset(
+    font_family='NanumGothic',
+    axes_unicode_minus=False,  # 마이너스 기호 깨짐 방지
+    font_size=12,              # 기본 폰트 크기
+)
+```
+
+### 스타일과 함께 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 먼저 설정
+plt = matplotlib_font_reset()
+
+# 스타일 적용 (한글 폰트 자동 유지)
+plt.style.use('seaborn-v0_8-whitegrid')
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('스타일 적용 + 한글')
+plt.show()
+```
+
+### Jupyter/Colab에서 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 최초 1회만 실행
+matplotlib_font_reset()
+
+# 이후 셀에서 plt 바로 사용 가능
+import matplotlib.pyplot as plt
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('주피터에서 한글')
+plt.show()
+```
+
+### 선호 폰트만 등록 (리셋 없이)
+
+```python
+from helper_plot_hangul import matplotlib_font_set
+
+# matplotlib 리셋 없이 폰트만 변경
+matplotlib_font_set(font_family='맑은 고딕', font_size=11)
+```
+
+## API 레퍼런스
+
+### `matplotlib_font_reset(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 완전히 리셋하고 한글 폰트를 설정합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름 (기본값: 'NanumGothic')
+- `font_path` (str, optional): 폰트 파일 경로. 지정 시 파일에서 폰트 이름 추출
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+  - `axes_unicode_minus` (bool): 마이너스 기호 깨짐 방지 (기본값: False)
+  - `font_size` (int): 기본 폰트 크기 (기본값: 10)
+
+**Returns:**
+- `matplotlib.pyplot`: 리셋되고 한글 폰트가 설정된 pyplot 모듈
+
+**폰트 설정 우선순위:**
+1. `font_path`가 있으면 파일에서 폰트 패밀리 이름 추출
+2. `font_family`만 있으면 해당 이름 사용
+3. 둘 다 없으면 'NanumGothic' 기본값 사용 + 자동 탐색
+
+### `matplotlib_font_set(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 리셋하지 않고 선호 폰트만 등록하고 즉시 적용합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름
+- `font_path` (str, optional): 폰트 파일 경로
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+
+## 작동 원리
+
+1. **폰트 자동 탐색**: 패키지에 내장된 NanumGothic 폰트를 자동으로 찾아 로드
+2. **완전한 리셋**: matplotlib 모듈을 완전히 리로드하여 폰트 캐시 클리어
+3. **스타일 패치**: `matplotlib.style.use` 함수를 패치하여 스타일 적용 후 자동으로 한글 폰트 재설정
+4. **전역 등록**: IPython 환경과 호출자 네임스페이스에 plt를 자동 등록
+
+## 문제 해결
+
+### 한글이 여전히 깨져 보이는 경우
+
+```python
+# 1. 완전 리셋 시도
+from helper_plot_hangul import matplotlib_font_reset
+plt = matplotlib_font_reset()
+
+# 2. 폰트 캐시 수동 삭제 (필요시)
+import matplotlib.font_manager as fm
+fm._get_fontconfig_fonts.cache_clear()
+```
+
+### 특정 폰트 사용하고 싶은 경우
+
+```python
+# 시스템에 설치된 폰트 사용
+plt = matplotlib_font_reset(font_family='D2Coding')
+
+# 폰트 파일 직접 지정
+plt = matplotlib_font_reset(font_path='/usr/share/fonts/custom.ttf')
+```
+
+## 요구사항
+
+- Python >= 3.8
+- matplotlib >= 3.2.0
+
+## 라이센스
+
+MIT License
+
+## 기여
+
+버그 리포트나 기능 제안은 [GitHub Issues](https://github.com/c0z0c/helper_plot_hangul/issues)에 등록해주세요.
+
+## 변경 이력
+
+### v0.5.0(2025-12-05)
+- 최초 릴리스
+- NanumGothic 폰트 내장
+- matplotlib 완전 리셋 기능
+- 스타일 호환성 자동 패치
+- Jupyter/Colab 최적화
+
+---
+
+jupyter_hangul를 참고하여 만들어졌습니다.
+- https://c0z0c.github.io/jupyter_hangul/
+

helper_plot_hangul-0.5.0/README.md

@@ -0,0 +1,198 @@
+# helper-plot-hangul
+
+Matplotlib 한글 폰트 자동 설정 라이브러리
+
+## 개요
+
+`helper-plot-hangul`은 Matplotlib에서 한글을 자동으로 표시할 수 있도록 폰트를 설정해주는 라이브러리입니다. 번거로운 폰트 설정 없이 간단하게 한글 그래프를 그릴 수 있습니다.
+
+## 특징
+
+- **자동 폰트 설정**: NanumGothic 폰트를 자동으로 로드하고 설정
+- **완전한 matplotlib 리셋**: 폰트 캐시를 포함한 완전한 초기화
+- **스타일 호환**: matplotlib 스타일 적용 후에도 한글 폰트 자동 유지
+- **Jupyter/Colab 최적화**: IPython 환경에서 완벽하게 작동
+- **NumPy 2.0+ 호환**: 최신 NumPy와 호환되는 안전한 폰트 설정
+- **내장 폰트**: NanumGothic 폰트 포함 (별도 설치 불필요)
+
+## 설치
+
+```bash
+pip install helper-plot-hangul
+
+# 테스트 서버
+pip install --index-url https://test.pypi.org/simple/ helper-plot-hangul
+```
+
+## 사용법
+
+### 기본 사용법
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 자동 설정 (NanumGothic 기본값)
+plt = matplotlib_font_reset()
+
+# 바로 한글 사용 가능
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('한글 제목')
+plt.xlabel('X축')
+plt.ylabel('Y축')
+plt.show()
+```
+
+### 사용자 정의 폰트 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 시스템 폰트 이름으로 설정
+plt = matplotlib_font_reset(font_family='맑은 고딕')
+
+# 또는 폰트 파일 경로로 설정
+plt = matplotlib_font_reset(font_path='/path/to/font.ttf')
+```
+
+### 추가 옵션 설정
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# matplotlib rcParams 추가 설정
+plt = matplotlib_font_reset(
+    font_family='NanumGothic',
+    axes_unicode_minus=False,  # 마이너스 기호 깨짐 방지
+    font_size=12,              # 기본 폰트 크기
+)
+```
+
+### 스타일과 함께 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 먼저 설정
+plt = matplotlib_font_reset()
+
+# 스타일 적용 (한글 폰트 자동 유지)
+plt.style.use('seaborn-v0_8-whitegrid')
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('스타일 적용 + 한글')
+plt.show()
+```
+
+### Jupyter/Colab에서 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 최초 1회만 실행
+matplotlib_font_reset()
+
+# 이후 셀에서 plt 바로 사용 가능
+import matplotlib.pyplot as plt
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('주피터에서 한글')
+plt.show()
+```
+
+### 선호 폰트만 등록 (리셋 없이)
+
+```python
+from helper_plot_hangul import matplotlib_font_set
+
+# matplotlib 리셋 없이 폰트만 변경
+matplotlib_font_set(font_family='맑은 고딕', font_size=11)
+```
+
+## API 레퍼런스
+
+### `matplotlib_font_reset(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 완전히 리셋하고 한글 폰트를 설정합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름 (기본값: 'NanumGothic')
+- `font_path` (str, optional): 폰트 파일 경로. 지정 시 파일에서 폰트 이름 추출
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+  - `axes_unicode_minus` (bool): 마이너스 기호 깨짐 방지 (기본값: False)
+  - `font_size` (int): 기본 폰트 크기 (기본값: 10)
+
+**Returns:**
+- `matplotlib.pyplot`: 리셋되고 한글 폰트가 설정된 pyplot 모듈
+
+**폰트 설정 우선순위:**
+1. `font_path`가 있으면 파일에서 폰트 패밀리 이름 추출
+2. `font_family`만 있으면 해당 이름 사용
+3. 둘 다 없으면 'NanumGothic' 기본값 사용 + 자동 탐색
+
+### `matplotlib_font_set(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 리셋하지 않고 선호 폰트만 등록하고 즉시 적용합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름
+- `font_path` (str, optional): 폰트 파일 경로
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+
+## 작동 원리
+
+1. **폰트 자동 탐색**: 패키지에 내장된 NanumGothic 폰트를 자동으로 찾아 로드
+2. **완전한 리셋**: matplotlib 모듈을 완전히 리로드하여 폰트 캐시 클리어
+3. **스타일 패치**: `matplotlib.style.use` 함수를 패치하여 스타일 적용 후 자동으로 한글 폰트 재설정
+4. **전역 등록**: IPython 환경과 호출자 네임스페이스에 plt를 자동 등록
+
+## 문제 해결
+
+### 한글이 여전히 깨져 보이는 경우
+
+```python
+# 1. 완전 리셋 시도
+from helper_plot_hangul import matplotlib_font_reset
+plt = matplotlib_font_reset()
+
+# 2. 폰트 캐시 수동 삭제 (필요시)
+import matplotlib.font_manager as fm
+fm._get_fontconfig_fonts.cache_clear()
+```
+
+### 특정 폰트 사용하고 싶은 경우
+
+```python
+# 시스템에 설치된 폰트 사용
+plt = matplotlib_font_reset(font_family='D2Coding')
+
+# 폰트 파일 직접 지정
+plt = matplotlib_font_reset(font_path='/usr/share/fonts/custom.ttf')
+```
+
+## 요구사항
+
+- Python >= 3.8
+- matplotlib >= 3.2.0
+
+## 라이센스
+
+MIT License
+
+## 기여
+
+버그 리포트나 기능 제안은 [GitHub Issues](https://github.com/c0z0c/helper_plot_hangul/issues)에 등록해주세요.
+
+## 변경 이력
+
+### v0.5.0(2025-12-05)
+- 최초 릴리스
+- NanumGothic 폰트 내장
+- matplotlib 완전 리셋 기능
+- 스타일 호환성 자동 패치
+- Jupyter/Colab 최적화
+
+---
+
+jupyter_hangul를 참고하여 만들어졌습니다.
+- https://c0z0c.github.io/jupyter_hangul/
+

helper_plot_hangul-0.5.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "helper-plot-hangul"
+version = "0.5.0"
+description = "Matplotlib 한글 폰트 자동 설정 라이브러리"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    {name = "c0z0c", email = "c0z0c.dev@gmail.com"}
+]
+keywords = ["matplotlib", "한글", "hangul", "font", "korean", "plot", "visualization"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "matplotlib>=3.2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/c0z0c-helper/helper_plot_hangul"
+Repository = "https://github.com/c0z0c-helper/helper_plot_hangul"
+Issues = "https://github.com/c0z0c-helper/helper_plot_hangul/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+helper_plot_hangul = ["fonts/*.ttf"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"

helper_plot_hangul-0.5.0/requirements-dev.txt

@@ -0,0 +1,4 @@
+pytest>=7.0.0
+pytest-cov>=4.0.0
+black>=23.0.0
+ruff>=0.1.0

helper_plot_hangul-0.5.0/requirements.txt

@@ -0,0 +1 @@
+matplotlib>=3.2.0

helper_plot_hangul-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

helper_plot_hangul-0.5.0/src/helper_plot_hangul/__init__.py

@@ -0,0 +1,30 @@
+"""
+helper-plot-hangul
+==================
+
+Matplotlib 한글 폰트 자동 설정 라이브러리
+
+주요 기능:
+- 자동 폰트 설정: NanumGothic 폰트를 자동으로 로드하고 설정
+- 완전한 matplotlib 리셋: 폰트 캐시를 포함한 완전한 초기화
+- 스타일 호환: matplotlib 스타일 적용 후에도 한글 폰트 자동 유지
+- Jupyter/Colab 최적화: IPython 환경에서 완벽하게 작동
+
+기본 사용법:
+    from helper_plot_hangul import matplotlib_font_reset
+    
+    plt = matplotlib_font_reset()
+    plt.plot([1, 2, 3], [1, 4, 9])
+    plt.title('한글 제목')
+    plt.show()
+"""
+
+__version__ = "0.5.0"
+
+from .helper_plot_hangul import matplotlib_font_reset, matplotlib_font_set
+
+__all__ = [
+    "matplotlib_font_reset",
+    "matplotlib_font_set",
+    "__version__",
+]

helper_plot_hangul-0.5.0/src/helper_plot_hangul/helper_plot_hangul.py

@@ -0,0 +1,250 @@
+import os
+import sys
+import matplotlib.pyplot as plt
+import matplotlib.font_manager as fm
+import importlib.resources as resources
+import inspect
+import warnings
+from pathlib import Path
+from typing import Any
+import logging
+try:
+    import IPython
+    from IPython.display import HTML
+    IPYTHON_AVAILABLE = True
+except ImportError:
+    IPYTHON_AVAILABLE = False    
+    
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+if not logger.handlers:
+    sh = logging.StreamHandler()
+    sh.setLevel(logger.level)
+    sh.setFormatter(logging.Formatter("%(asctime)s %(levelname)s [%(name)s] %(message)s"))
+    logger.addHandler(sh)
+
+def matplotlib_font_reset(font_family: str | None = None, font_path: str | None = None, **kwargs: Any) -> Any:
+    """matplotlib 완전 리셋 (NumPy 호환성 개선).
+    
+    matplotlib 모듈을 완전히 리로드하고 한글 폰트를 설정합니다.
+    NumPy 2.0+ 호환성을 고려한 안전한 폰트 설정을 수행합니다.
+    
+    Parameters
+    ----------
+    font_family : str, optional
+        사용할 폰트 패밀리 이름 (기본값: 'NanumGothic')
+    font_path : str, optional
+        폰트 파일 경로. 지정 시 파일에서 폰트 이름 추출 (우선순위 최상위)
+    **kwargs
+        matplotlib rcParams에 전달할 추가 설정 (기본값: axes.unicode_minus=False, font.size=10)
+    
+    Returns
+    -------
+    matplotlib.pyplot
+        리셋되고 한글 폰트가 설정된 pyplot 모듈.
+    
+    Notes
+    -----
+    폰트 설정 우선순위:
+    1. font_path가 있으면 파일에서 폰트 패밀리 이름 추출
+    2. font_family만 있으면 해당 이름 사용
+    3. 둘 다 없으면 'NanumGothic' 기본값 사용 + 자동 탐색
+    """
+    
+    if isinstance(font_family, (str, bytes, os.PathLike)) and font_family and os.path.exists(font_family):
+        font_path = str(font_family)
+        font_family = None
+
+    # 기본값 설정
+    default_kwargs = {'axes.unicode_minus': False, 'font.size': 10}
+    default_kwargs.update(kwargs)
+    
+    modules_to_remove = [mod for mod in sys.modules if mod.startswith('matplotlib')]
+    for mod in modules_to_remove:
+        del sys.modules[mod]
+
+    # matplotlib 재임포트
+    import matplotlib.pyplot as plt
+    import matplotlib.font_manager as fm
+
+    # 폰트 캐시 클리어 (중요!)
+    try:
+        fm._get_fontconfig_fonts.cache_clear()
+    except:
+        pass
+    
+    try:
+        fm.fontManager.__init__()
+    except:
+        pass
+    
+    # font_path가 없고 font_family도 없으면 자동 탐색
+    if font_path is None and font_family is None:
+        font_family = 'NanumGothic'
+        # 1. 개발 환경: 로컬 fonts 폴더 확인
+        local_font_path = Path(__file__).parent / "fonts" / "NanumGothic.ttf"
+        
+        if local_font_path.exists():
+            font_path = str(local_font_path)
+        else:
+            # 2. pip 배포 환경: 패키지 내부 fonts 폴더
+            try:
+                font_path = str(resources.files("helper_plot_hangul").joinpath("fonts/NanumGothic.ttf"))
+            except Exception:
+                font_path = None
+        logger.debug(f"자동 탐색된 폰트 경로: {font_path}")
+    
+    # 우선순위: font_path > font_family
+    if font_path:
+        try:
+            fm.fontManager.addfont(font_path)  # matplotlib >= 3.2
+            fp = fm.FontProperties(fname=font_path)
+            font_name = fp.get_name()
+            plt.rcParams['font.family'] = font_name
+        except Exception:
+            # 실패 시 font_family 사용
+            if font_family:
+                plt.rcParams['font.family'] = font_family
+            else:
+                plt.rcParams['font.family'] = 'NanumGothic'
+    elif font_family:
+        plt.rcParams['font.family'] = font_family
+    else:
+        plt.rcParams['font.family'] = 'NanumGothic'
+    logger.debug(f"설정된 폰트 패밀리: {plt.rcParams['font.family']}")
+    
+    # 추가 설정 적용
+    for key, value in default_kwargs.items():
+        plt.rcParams[key] = value
+    
+    # IPython 환경에서 전역 등록 (Jupyter/Colab 호환성 개선)
+    try:
+        # IPython/Jupyter 사용자 네임스페이스에 등록
+        if IPYTHON_AVAILABLE:
+            ipy = IPython.get_ipython()
+            if ipy is not None:
+                ipy.user_ns["plt"] = plt
+
+        # 호출자 모듈의 전역(namespace)에 plt를 넣어 할당 없이 사용 가능하도록 함
+        try:
+            caller = inspect.currentframe().f_back
+            if caller is not None:
+                caller.f_globals["plt"] = plt
+        except Exception:
+            pass
+
+        # 현재 모듈의 globals에도 보장
+        globals()["plt"] = plt
+    except Exception:
+        globals()["plt"] = plt
+    
+    # 선호 폰트 정보 저장 (스타일 적용 후 재적용용)
+    globals()["_preferred_font_path"] = font_path
+    globals()["_preferred_font_family"] = font_family if font_family else plt.rcParams.get('font.family')
+    globals()["_preferred_font_kwargs"] = default_kwargs
+    
+    # matplotlib.style.use 패치 (최초 1회만)
+    if not globals().get("_style_patched", False):
+        _patch_style_use()
+        globals()["_style_patched"] = True
+    
+    return plt
+
+
+def _reapply_font_rcparams():
+    """모듈에 저장된 선호 폰트를 rcParams에 재적용 (스타일 적용 후 자동 호출)."""
+    try:
+        import matplotlib.font_manager as fm
+        import matplotlib.pyplot as _plt
+        
+        font_path = globals().get("_preferred_font_path")
+        font_family = globals().get("_preferred_font_family")
+        kwargs = globals().get("_preferred_font_kwargs", {})
+
+        if font_path:
+            try:
+                fm.fontManager.addfont(font_path)
+                fp = fm.FontProperties(fname=font_path)
+                font_name = fp.get_name()
+                _plt.rcParams['font.family'] = font_name
+                logger.debug(f"폰트 재적용: {font_name} (경로: {font_path})")
+            except Exception as e:
+                logger.debug(f"폰트 경로 재적용 실패: {e}")
+                if font_family:
+                    _plt.rcParams['font.family'] = font_family
+        elif font_family:
+            _plt.rcParams['font.family'] = font_family
+            logger.debug(f"폰트 재적용: {font_family}")
+
+        # 기타 저장된 rc 설정 재적용
+        for k, v in kwargs.items():
+            _plt.rcParams[k] = v
+            
+    except Exception as e:
+        logger.debug(f"폰트 재적용 중 예외 발생: {e}")
+
+
+def _patch_style_use():
+    """matplotlib.style.use를 패치하여 스타일 적용 후 자동으로 한글 폰트 재설정."""
+    try:
+        import matplotlib.style as mstyle
+        _orig_style_use = mstyle.use
+
+        def _patched_style_use(style, *args, **kwargs):
+            result = _orig_style_use(style, *args, **kwargs)
+            # 스타일 적용 직후 저장된 한글 폰트 재적용
+            if globals().get("_preferred_font_path") or globals().get("_preferred_font_family"):
+                _reapply_font_rcparams()
+                logger.debug(f"스타일 '{style}' 적용 후 한글 폰트 자동 재설정 완료")
+            return result
+
+        mstyle.use = _patched_style_use
+        logger.debug("matplotlib.style.use 패치 완료")
+        
+    except Exception as e:
+        logger.debug(f"matplotlib.style.use 패치 실패 (무시): {e}")
+
+
+def matplotlib_font_set(font_family: str | None = None, font_path: str | None = None, **kwargs: Any):
+    """matplotlib_font_reset를 호출하지 않고 선호 폰트만 등록 (즉시 적용).
+    
+    Parameters
+    ----------
+    font_family : str, optional
+        사용할 폰트 패밀리 이름
+    font_path : str, optional
+        폰트 파일 경로
+    **kwargs
+        matplotlib rcParams에 전달할 추가 설정
+    """
+    import matplotlib.pyplot as _plt
+    
+    default_kwargs = {'axes.unicode_minus': False, 'font.size': 10}
+    default_kwargs.update(kwargs)
+    
+    globals()["_preferred_font_path"] = font_path
+    globals()["_preferred_font_family"] = font_family
+    globals()["_preferred_font_kwargs"] = default_kwargs
+    
+    # 현재 세션의 rcParams에도 즉시 적용
+    _reapply_font_rcparams()
+    
+    # 패치 적용
+    if not globals().get("_style_patched", False):
+        _patch_style_use()
+        globals()["_style_patched"] = True
+
+
+matplotlib_font_reset()
+
+# 예시 사용법
+if __name__ == "__main__":
+    # plt = matplotlib_font_reset(r'src\helper_plot_hangul\fonts\NanumGothic.ttf')
+
+    # 스타일 적용 테스트 (자동으로 한글 폰트 재설정됨)
+    plt.style.use('seaborn-v0_8-whitegrid')
+    plt.plot([1, 2, 3], [1, 4, 9])
+    plt.title('한글 폰트 테스트')
+    plt.xlabel('X축')
+    plt.ylabel('Y축')
+    plt.show()

helper_plot_hangul-0.5.0/src/helper_plot_hangul.egg-info/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: helper-plot-hangul
+Version: 0.5.0
+Summary: Matplotlib 한글 폰트 자동 설정 라이브러리
+Author-email: c0z0c <c0z0c.dev@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/c0z0c-helper/helper_plot_hangul
+Project-URL: Repository, https://github.com/c0z0c-helper/helper_plot_hangul
+Project-URL: Issues, https://github.com/c0z0c-helper/helper_plot_hangul/issues
+Keywords: matplotlib,한글,hangul,font,korean,plot,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib>=3.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# helper-plot-hangul
+
+Matplotlib 한글 폰트 자동 설정 라이브러리
+
+## 개요
+
+`helper-plot-hangul`은 Matplotlib에서 한글을 자동으로 표시할 수 있도록 폰트를 설정해주는 라이브러리입니다. 번거로운 폰트 설정 없이 간단하게 한글 그래프를 그릴 수 있습니다.
+
+## 특징
+
+- **자동 폰트 설정**: NanumGothic 폰트를 자동으로 로드하고 설정
+- **완전한 matplotlib 리셋**: 폰트 캐시를 포함한 완전한 초기화
+- **스타일 호환**: matplotlib 스타일 적용 후에도 한글 폰트 자동 유지
+- **Jupyter/Colab 최적화**: IPython 환경에서 완벽하게 작동
+- **NumPy 2.0+ 호환**: 최신 NumPy와 호환되는 안전한 폰트 설정
+- **내장 폰트**: NanumGothic 폰트 포함 (별도 설치 불필요)
+
+## 설치
+
+```bash
+pip install helper-plot-hangul
+
+# 테스트 서버
+pip install --index-url https://test.pypi.org/simple/ helper-plot-hangul
+```
+
+## 사용법
+
+### 기본 사용법
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 자동 설정 (NanumGothic 기본값)
+plt = matplotlib_font_reset()
+
+# 바로 한글 사용 가능
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('한글 제목')
+plt.xlabel('X축')
+plt.ylabel('Y축')
+plt.show()
+```
+
+### 사용자 정의 폰트 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 시스템 폰트 이름으로 설정
+plt = matplotlib_font_reset(font_family='맑은 고딕')
+
+# 또는 폰트 파일 경로로 설정
+plt = matplotlib_font_reset(font_path='/path/to/font.ttf')
+```
+
+### 추가 옵션 설정
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# matplotlib rcParams 추가 설정
+plt = matplotlib_font_reset(
+    font_family='NanumGothic',
+    axes_unicode_minus=False,  # 마이너스 기호 깨짐 방지
+    font_size=12,              # 기본 폰트 크기
+)
+```
+
+### 스타일과 함께 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 한글 폰트 먼저 설정
+plt = matplotlib_font_reset()
+
+# 스타일 적용 (한글 폰트 자동 유지)
+plt.style.use('seaborn-v0_8-whitegrid')
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('스타일 적용 + 한글')
+plt.show()
+```
+
+### Jupyter/Colab에서 사용
+
+```python
+from helper_plot_hangul import matplotlib_font_reset
+
+# 최초 1회만 실행
+matplotlib_font_reset()
+
+# 이후 셀에서 plt 바로 사용 가능
+import matplotlib.pyplot as plt
+
+plt.plot([1, 2, 3], [1, 4, 9])
+plt.title('주피터에서 한글')
+plt.show()
+```
+
+### 선호 폰트만 등록 (리셋 없이)
+
+```python
+from helper_plot_hangul import matplotlib_font_set
+
+# matplotlib 리셋 없이 폰트만 변경
+matplotlib_font_set(font_family='맑은 고딕', font_size=11)
+```
+
+## API 레퍼런스
+
+### `matplotlib_font_reset(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 완전히 리셋하고 한글 폰트를 설정합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름 (기본값: 'NanumGothic')
+- `font_path` (str, optional): 폰트 파일 경로. 지정 시 파일에서 폰트 이름 추출
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+  - `axes_unicode_minus` (bool): 마이너스 기호 깨짐 방지 (기본값: False)
+  - `font_size` (int): 기본 폰트 크기 (기본값: 10)
+
+**Returns:**
+- `matplotlib.pyplot`: 리셋되고 한글 폰트가 설정된 pyplot 모듈
+
+**폰트 설정 우선순위:**
+1. `font_path`가 있으면 파일에서 폰트 패밀리 이름 추출
+2. `font_family`만 있으면 해당 이름 사용
+3. 둘 다 없으면 'NanumGothic' 기본값 사용 + 자동 탐색
+
+### `matplotlib_font_set(font_family=None, font_path=None, **kwargs)`
+
+matplotlib를 리셋하지 않고 선호 폰트만 등록하고 즉시 적용합니다.
+
+**Parameters:**
+- `font_family` (str, optional): 사용할 폰트 패밀리 이름
+- `font_path` (str, optional): 폰트 파일 경로
+- `**kwargs`: matplotlib rcParams에 전달할 추가 설정
+
+## 작동 원리
+
+1. **폰트 자동 탐색**: 패키지에 내장된 NanumGothic 폰트를 자동으로 찾아 로드
+2. **완전한 리셋**: matplotlib 모듈을 완전히 리로드하여 폰트 캐시 클리어
+3. **스타일 패치**: `matplotlib.style.use` 함수를 패치하여 스타일 적용 후 자동으로 한글 폰트 재설정
+4. **전역 등록**: IPython 환경과 호출자 네임스페이스에 plt를 자동 등록
+
+## 문제 해결
+
+### 한글이 여전히 깨져 보이는 경우
+
+```python
+# 1. 완전 리셋 시도
+from helper_plot_hangul import matplotlib_font_reset
+plt = matplotlib_font_reset()
+
+# 2. 폰트 캐시 수동 삭제 (필요시)
+import matplotlib.font_manager as fm
+fm._get_fontconfig_fonts.cache_clear()
+```
+
+### 특정 폰트 사용하고 싶은 경우
+
+```python
+# 시스템에 설치된 폰트 사용
+plt = matplotlib_font_reset(font_family='D2Coding')
+
+# 폰트 파일 직접 지정
+plt = matplotlib_font_reset(font_path='/usr/share/fonts/custom.ttf')
+```
+
+## 요구사항
+
+- Python >= 3.8
+- matplotlib >= 3.2.0
+
+## 라이센스
+
+MIT License
+
+## 기여
+
+버그 리포트나 기능 제안은 [GitHub Issues](https://github.com/c0z0c/helper_plot_hangul/issues)에 등록해주세요.
+
+## 변경 이력
+
+### v0.5.0(2025-12-05)
+- 최초 릴리스
+- NanumGothic 폰트 내장
+- matplotlib 완전 리셋 기능
+- 스타일 호환성 자동 패치
+- Jupyter/Colab 최적화
+
+---
+
+jupyter_hangul를 참고하여 만들어졌습니다.
+- https://c0z0c.github.io/jupyter_hangul/
+

helper_plot_hangul-0.5.0/src/helper_plot_hangul.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+requirements-dev.txt
+requirements.txt
+src/helper_plot_hangul/__init__.py
+src/helper_plot_hangul/helper_plot_hangul.py
+src/helper_plot_hangul.egg-info/PKG-INFO
+src/helper_plot_hangul.egg-info/SOURCES.txt
+src/helper_plot_hangul.egg-info/dependency_links.txt
+src/helper_plot_hangul.egg-info/requires.txt
+src/helper_plot_hangul.egg-info/top_level.txt
+src/helper_plot_hangul/fonts/NanumGothic.ttf

helper_plot_hangul-0.5.0/src/helper_plot_hangul.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

helper_plot_hangul-0.5.0/src/helper_plot_hangul.egg-info/requires.txt

@@ -0,0 +1,7 @@
+matplotlib>=3.2.0
+
+[dev]
+pytest>=7.0.0
+pytest-cov>=4.0.0
+black>=23.0.0
+ruff>=0.1.0

helper_plot_hangul-0.5.0/src/helper_plot_hangul.egg-info/top_level.txt

@@ -0,0 +1 @@
+helper_plot_hangul