hossam 0.3.5__py3-none-any.whl → 0.3.12__py3-none-any.whl

hossam/__init__.py

@@ -1,78 +1,85 @@
 from .data_loader import load_data, load_info
+from .hs_stats import oneway_anova
 from matplotlib import pyplot as plt
 from matplotlib import font_manager as fm
 from importlib.resources import files, as_file
-import os
+from importlib.metadata import version
+from types import SimpleNamespace
 import warnings
 
-__version__ = '0.3.0'
-__all__ = ['load_data', 'load_info']
+try:
+    __version__ = version("hossam")
+except Exception:
+    __version__ = "develop"
 
-my_dpi = 200  # 이미지 선명도(100~300)
+
+hs_fig = SimpleNamespace(
+    dpi=200,
+    width=600,
+    height=320,
+    font_size=6,
+    font_weight="light",
+    frame_width=0.4,
+    line_width=1,
+    grid_alpha=0.3,
+    grid_width=0.4,
+    fill_alpha=0.3
+)
+
+__all__ = ["load_data", "load_info", "hs_classroom", "hs_gis", "hs_plot", "hs_prep", "hs_stats", "hs_timeserise", "hs_util", "hs_fig"]
 
 
 def _init_korean_font():
-	"""패키지에 포함된 한글 폰트를 자동 등록하고 기본 폰트로 설정합니다.
+    """
+    패키지에 포함된 한글 폰트를 기본 폰트로 설정합니다.
+    """
+    font_file = "NotoSansKR-Regular.ttf"
+    try:
+        # 패키지 리소스에서 폰트 파일 경로 확보
+        with as_file(files("hossam") / font_file) as font_path:
+            fm.fontManager.addfont(str(font_path))
+            fprop = fm.FontProperties(fname=str(font_path))
+            fname = fprop.get_name()
 
-	- 패키지 내부의 NotoSansKR-Regular.ttf를 우선적으로 사용합니다.
-	- 폰트 파일을 찾지 못하면 말굽고딕 등 시스템 폰트로 폴백합니다.
-	"""
-	# 환경 변수 제어
-	env_disable = os.environ.get('HOSSAM_FONT_DISABLE', '').lower() in {'1', 'true', 'yes'}
-	env_family = os.environ.get('HOSSAM_FONT_FAMILY')
-	env_size = os.environ.get('HOSSAM_FONT_SIZE')
-	env_path = os.environ.get('HOSSAM_FONT_PATH')
+            plt.rcParams.update({
+                "font.family": fname,
+                "font.size": hs_fig.font_size,
+                "font.weight": hs_fig.font_weight,
+                "axes.unicode_minus": False,
+                "text.antialiased": True,
+                "lines.antialiased": True,
+                "patch.antialiased": True,
+                "figure.dpi": hs_fig.dpi,
+                "savefig.dpi": hs_fig.dpi * 2,
+                "text.hinting": "auto",
+                "text.hinting_factor": 8,
+                "pdf.fonttype": 42,
+                "ps.fonttype": 42,
+            })
+            print(
+                "\n✅ 시각화를 위한 한글 글꼴(NotoSansKR-Regular)이 자동 적용되었습니다."
+            )
+            return
+    except Exception as e:
+        warnings.warn(f"\n한글 폰트 초기화: 패키지 폰트 사용 실패 ({e}).")
 
-	if env_disable:
-		return
 
-	# 우선순위 1: 사용자 지정 폰트 경로
-	if env_path:
-		try:
-			fm.fontManager.addfont(env_path)
-			fprop = fm.FontProperties(fname=env_path)
-			fname = fprop.get_name()
-			plt.rcParams['font.family'] = env_family or fname
-			plt.rcParams['font.size'] = int(env_size) if env_size else 6
-			plt.rcParams['axes.unicode_minus'] = False
-			return
-		except Exception as e:
-			warnings.warn(f"환경 변수 경로 폰트 사용 실패 ({e}). 패키지/시스템 폰트로 폴백합니다.")
+def _init():
 
-	font_file = 'NotoSansKR-Regular.ttf'
-	try:
-		# 패키지 리소스에서 폰트 파일 경로 확보
-		with as_file(files('hossam') / font_file) as font_path:
-			fm.fontManager.addfont(str(font_path))
-			fprop = fm.FontProperties(fname=str(font_path))
-			fname = fprop.get_name()
-			plt.rcParams['font.family'] = fname
-			plt.rcParams['font.size'] = int(env_size) if env_size else 6
-			plt.rcParams['axes.unicode_minus'] = False
-			return
-	except Exception as e:
-		warnings.warn(f"한글 폰트 초기화: 패키지 폰트 사용 실패 ({e}). 시스템 폰트로 폴백합니다.")
+    # 안내 메시지 (블릿 리스트)
+    messages = [
+        "📦 아이티윌 이광호 강사가 제작한 라이브러리를 사용중입니다.",
+        "📚 자세한 사용 방법은 https://py.hossam.kr 을 참고하세요.",
+        "📧 Email: leekh4232@gmail.com",
+        "🎬 Youtube: https://www.youtube.com/@hossam-codingclub",
+        "📝 Blog: https://blog.hossam.kr/",
+        f"🔖 Version: {__version__}",
+    ]
 
-	# 시스템 폰트 폴백 (Windows 우선: Malgun Gothic, 그 외 대안)
-	fallback_fonts = [
-		'Malgun Gothic',
-		'NanumGothic',
-		'AppleGothic',
-		'Noto Sans CJK KR',
-		'Noto Sans KR',
-		'DejaVu Sans'
-	]
-	for ff in ([env_family] if env_family else []) + fallback_fonts:
-		try:
-			plt.rcParams['font.family'] = ff
-			plt.rcParams['font.size'] = int(env_size) if env_size else 6
-			plt.rcParams['axes.unicode_minus'] = False
-			return
-		except Exception:
-			continue
+    for msg in messages:
+        print(f"{msg}")
 
-	warnings.warn('한글 폰트 초기화 실패: 적절한 폰트를 찾지 못했습니다.')
+    _init_korean_font()
 
 
-# 모듈 임포트 시점에 폰트 초기화 수행
-_init_korean_font()
+_init()

hossam/data_loader.py

@@ -1,3 +1,6 @@
+# -*- coding: utf-8 -*-
+# -------------------------------------------------------------
+
 import requests
 import json
 from os.path import join, exists
@@ -8,7 +11,7 @@ from typing import Optional
 
 BASE_URL = "https://data.hossam.kr"
 
-
+# -------------------------------------------------------------
 def __get_df(path: str, index_col=None) -> DataFrame:
     p = path.rfind(".")
     exec = path[p+1:].lower()
@@ -54,6 +57,7 @@ def __get_df(path: str, index_col=None) -> DataFrame:
 
     return df
 
+# -------------------------------------------------------------
 def __get_data_url(key: str, local: str = None) -> str:
     global BASE_URL
 
@@ -89,7 +93,7 @@ def __get_data_url(key: str, local: str = None) -> str:
 
     return path, info.get('desc'), info.get('index')
 
-
+# -------------------------------------------------------------
 def load_info(search: str = None, local: str = None) -> DataFrame:
     """메타데이터에서 사용 가능한 데이터셋 정보를 로드한다.
 
@@ -152,7 +156,7 @@ def load_info(search: str = None, local: str = None) -> DataFrame:
 
     return my_df2
 
-
+# -------------------------------------------------------------
 def load_data(key: str, local: str = None) -> Optional[DataFrame]:
     """키로 지정된 데이터셋을 로드한다.