hossam 0.3.20__py3-none-any.whl → 0.4.1__py3-none-any.whl

{hossam-0.3.20.dist-info → hossam-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hossam
-Version: 0.3.20
+Version: 0.4.1
 Summary: Hossam Data Helper
 Author-email: Lee Kwang-Ho <leekh4232@gmail.com>
 License-Expression: MIT
@@ -35,6 +35,10 @@ Requires-Dist: pmdarima
 Requires-Dist: prophet
 Requires-Dist: plotly
 Requires-Dist: jenkspy
+Requires-Dist: flask
+Requires-Dist: xgboost
+Requires-Dist: lightgbm
+Requires-Dist: catboost
 Dynamic: license-file
 
 ---
@@ -61,7 +65,6 @@ title: 🎓 Hossam Data Helper
 - 🤖 **MCP 서버**: VSCode/Copilot과 통합 가능한 Model Context Protocol 지원
 - 📈 **교육용 최적화**: 데이터 분석 교육에 특화된 설계
 
----
 
 ## 📦 설치
 
@@ -71,72 +74,6 @@ pip install hossam
 
 **요구사항**: Python 3.8 이상
 
----
-
-## 🚀 빠른 시작
-
-### 샘플 데이터 로드
-
-```python
-from hossam import load_data, load_info
-
-# 사용 가능한 데이터셋 확인
-datasets = load_info()
-
-# 데이터 로드
-df = load_data('AD_SALES')
-```
-
-### 간단한 시각화
-
-```python
-from hossam import hs_plot
-import pandas as pd
-import numpy as np
-
-df = pd.DataFrame({
-    'x': np.random.randn(100),
-    'y': np.random.randn(100),
-    'category': np.random.choice(['A', 'B', 'C'], 100)
-})
-
-# 산점도
-hs_plot.scatterplot(df=df, xname='x', yname='y', hue='category')
-
-# 박스플롯
-hs_plot.boxplot(df=df, xname='category', yname='x')
-```
-
----
-
-## 🤖 MCP Server
-
-Hossam은 **Model Context Protocol(MCP)** 기반 서버로도 작동하며, VSCode Copilot/Cline과 통합하여 데이터 분석 코드를 자동 생성할 수 있습니다.
-
-### 빠른 시작
-
-```bash
-# 서버 시작
-hossam-mcp
-```
-
-### VSCode + Copilot 연동
-
-VSCode에서 Copilot과 함께 사용하려면 `.vscode/settings.json` 설정이 필요합니다.
-
-**Copilot Chat에서 사용:**
-```
-@hossam 이 DataFrame의 결측치를 분석하고 처리하는 코드 작성해줘
-```
-
-**설정 가이드:**
-- [`.vscode/settings.json` 완성형 샘플](https://py.hossam.kr/guides/vscode-settings-sample/) ⭐
-- [VSCode + Copilot 연동 상세](https://py.hossam.kr/guides/vscode-copilot-integration/)
-- [MCP 서버 사용법](https://py.hossam.kr/guides/mcp/)
-- [Copilot Chat 프롬프트 예시](https://py.hossam.kr/guides/copilot-prompts/)
-
----
-
 ## 📚 전체 문서
 
 **완전한 API 문서와 가이드는 [py.hossam.kr](https://py.hossam.kr)에서 확인하세요.**
@@ -152,49 +89,11 @@ VSCode에서 Copilot과 함께 사용하려면 `.vscode/settings.json` 설정이
 
 자세한 사용법은 [API 문서](https://py.hossam.kr/api/hossam/)를 참고하세요.
 
----
-
-## 🎓 예제
-
-### 결측치 분석
-
-```python
-from hossam import hs_prep
-
-# 결측치 정보 확인
-hs_prep.hs_missing_values(df)
-
-# 결측치 시각화
-hs_prep.hs_missing_values_barplot(df)
-```
-
-### 회귀 분석
-
-```python
-from hossam import hs_stats
-
-# 단순 선형 회귀
-result = hs_stats.hs_simple_regression(df, xname='x', yname='y', plot=True)
-```
-
-### 상관분석 히트맵
-
-```python
-from hossam import hs_plot
-
-hs_plot.heatmap(df=df, annot=True, cmap='coolwarm')
-```
-
-더 많은 예제는 [문서 사이트](https://py.hossam.kr)를 참고하세요.
-
----
 
 ## 📄 라이선스
 
 이 프로젝트는 MIT 라이선스를 따릅니다. 자유롭게 사용, 수정, 배포할 수 있습니다.
 
----
-
 ## 🔗 링크
 
 - **문서**: [py.hossam.kr](https://py.hossam.kr)
@@ -203,4 +102,4 @@ hs_plot.heatmap(df=df, annot=True, cmap='coolwarm')
 
 ---
 
-**Made with ❤️ for Data Science Education**
+{% include 'HOSSAM_API.md' %}

hossam-0.4.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+hossam/NotoSansKR-Regular.ttf,sha256=0SCufUQwcVWrWTu75j4Lt_V2bgBJIBXl1p8iAJJYkVY,6185516
+hossam/__init__.py,sha256=OkMeP15jt6aCy7QNXMtkO0YRVvgOQYumkb7GuVKrbcs,2712
+hossam/data_loader.py,sha256=oUIsqbHQoRiHA_1tdElDaYo1ipmUB5fYSXYMB5gLOl0,6395
+hossam/hs_classroom.py,sha256=rgayol3U5PSo4rLfdbClfiAtG21bFrASaSW56PUsjus,27144
+hossam/hs_gis.py,sha256=DLogaf5nxJBbG-d8QoH2g8UfZ1omMtmEXDYgNg8jtT0,11410
+hossam/hs_plot.py,sha256=-ByDla2La34l6zI_T_e-FHAT3d8hLVo5J-pLBP8PixE,78285
+hossam/hs_prep.py,sha256=2ptFFxV4G1IFmy-B89TqXaPkA8jROZutr2XIkaXNHW4,36006
+hossam/hs_stats.py,sha256=qAor-RE5qNsytoZW1mriK3yql9PVif5bBGyG64YC2PM,110780
+hossam/hs_timeserise.py,sha256=gSj3cPgOGLOZEXhfW1anXbwpoJja847ZY9F8l9piJPE,42601
+hossam/hs_util.py,sha256=8byLj_VR93vS__lyf0xgQKArgMy9qFm2VvZVSCxfQX0,8444
+hossam/leekh.png,sha256=1PB5NQ24SDoHA5KMiBBsWpSa3iniFcwFTuGwuOsTHfI,6395
+hossam-0.4.1.dist-info/licenses/LICENSE,sha256=nIqzhlcFY_2D6QtFsYjwU7BWkafo-rUJOQpDZ-DsauI,941
+hossam-0.4.1.dist-info/METADATA,sha256=fLpNpWGt0DnmpnWmQf2zNs5TlO8Q9pmIXcWpN3blKVU,3676
+hossam-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hossam-0.4.1.dist-info/top_level.txt,sha256=_-7bwjhthHplWhywEaHIJX2yL11CQCaLjCNSBlk6wiQ,7
+hossam-0.4.1.dist-info/RECORD,,

hossam/mcp/__init__.py

@@ -1,12 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Hossam MCP Layer
-
-- 기존 공개 API는 유지하며, MCP 관련 코드는 이 패키지 내부에만 위치합니다.
-- 서버는 명시적 엔트리포인트로만 실행됩니다 (`hossam-mcp`).
-- 각 모듈별 `register(mcp)` 함수를 통해 MCP tool을 등록합니다.
-"""
-
-__all__ = [
-    "server",
-]

hossam/mcp/hs_classroom.py

@@ -1,22 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_classroom"""
-def register(mcp):
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_classroom as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_classroom_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_gis.py

@@ -1,30 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_gis"""
-def register(mcp):
-    from hossam.hs_gis import save_shape as _save_shape
-
-    @mcp.tool("hs_gis_save_shape")
-    def hs_save_shape(gdf_or_df, path: str, crs: str | None = None, lat_col: str = "latitude", lon_col: str = "longitude"):
-        """GeoDataFrame 또는 DataFrame을 Shapefile/GeoPackage로 저장합니다."""
-        _save_shape(gdf_or_df, path=path, crs=crs, lat_col=lat_col, lon_col=lon_col)
-        return {"saved": True, "path": path}
-
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_gis as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_gis_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_plot.py

@@ -1,53 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_plot
-
-시각화 함수는 파일 저장 경로(`save_path`)를 활용하는 사용을 권장합니다.
-"""
-from typing import Any
-from pandas import DataFrame
-
-from hossam.hs_plot import (
-    lineplot as _lineplot,
-    boxplot as _boxplot,
-    kdeplot as _kdeplot,
-)
-
-
-def register(mcp):
-    # @mcp.tool("hs_lineplot")
-    # def hs_lineplot(df: DataFrame, xname: str | None = None, yname: str | None = None, hue: str | None = None, save_path: str | None = None, **params: Any):
-    #     """선 그래프를 그립니다. 원격 환경에서는 `save_path`로 저장하여 활용하세요."""
-    #     _lineplot(df=df, xname=xname, yname=yname, hue=hue, save_path=save_path, **params)
-    #     return {"saved": bool(save_path), "path": save_path}
-
-    # @mcp.tool("hs_boxplot")
-    # def hs_boxplot(df: DataFrame, xname: str | None = None, yname: str | None = None, orient: str = "v", save_path: str | None = None, **params: Any):
-    #     """상자그림(boxplot)을 그립니다. `save_path` 지정 시 파일로 저장합니다."""
-    #     _boxplot(df=df, xname=xname, yname=yname, orient=orient, save_path=save_path, **params)
-    #     return {"saved": bool(save_path), "path": save_path}
-
-    # @mcp.tool("hs_kdeplot")
-    # def hs_kdeplot(df: DataFrame, xname: str | None = None, yname: str | None = None, hue: str | None = None, fill: bool = False, quartile_split: bool = False, save_path: str | None = None, **params: Any):
-    #     """KDE(커널 밀도) 그래프를 그립니다. 1D KDE는 `quartile_split`로 사분위별 분할 가능."""
-    #     _kdeplot(df=df, xname=xname, yname=yname, hue=hue, fill=fill, quartile_split=quartile_split, save_path=save_path, **params)
-    #     return {"saved": bool(save_path), "path": save_path}
-
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_plot as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_plot_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_prep.py

@@ -1,61 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_prep"""
-from typing import List
-from pandas import DataFrame
-
-from hossam.hs_prep import (
-    standard_scaler as _standard_scaler,
-    minmax_scaler as _minmax_scaler,
-    set_category as _set_category,
-    get_dummies as _get_dummies,
-    replace_outliner as _replace_outliner,
-)
-
-
-def register(mcp):
-    # @mcp.tool("hs_standard_scaler")
-    # def hs_standard_scaler(data: DataFrame | list | dict, yname: str | None = None, save_path: str | None = None, load_path: str | None = None):
-    #     """연속형 변수에 대해 Z-Score(Standard) 스케일링을 수행합니다."""
-    #     return _standard_scaler(data, yname=yname, save_path=save_path, load_path=load_path)
-
-    # @mcp.tool("hs_minmax_scaler")
-    # def hs_minmax_scaler(data: DataFrame | list | dict, yname: str | None = None, save_path: str | None = None, load_path: str | None = None):
-    #     """연속형 변수를 0~1로 정규화(MinMax Scaling)합니다."""
-    #     return _minmax_scaler(data, yname=yname, save_path=save_path, load_path=load_path)
-
-    # @mcp.tool("hs_set_category")
-    # def hs_set_category(df: DataFrame, fields: List[str]):
-    #     """지정된 컬럼을 pandas Categorical로 설정합니다."""
-    #     return _set_category(df, *fields)
-
-    # @mcp.tool("hs_get_dummies")
-    # def hs_get_dummies(df: DataFrame, fields: List[str] | None = None, drop_first: bool = True, dtype: str = "int"):
-    #     """명목형 변수를 더미 변수(원-핫)로 변환합니다."""
-    #     fields = fields or []
-    #     return _get_dummies(df, *fields, drop_first=drop_first, dtype=dtype)
-
-    # @mcp.tool("hs_replace_outliner")
-    # def hs_replace_outliner(df: DataFrame, method: str = "nan", fields: List[str] | None = None):
-    #     """IQR 기준 이상치를 지정된 방식으로 대체합니다."""
-    #     fields = fields or []
-    #     return _replace_outliner(df, method=method, *fields)
-
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_prep as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_prep_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_stats.py

@@ -1,25 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_stats
-
-공개 API만 thin wrapper로 노출합니다.
-"""
-def register(mcp):
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_stats as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_stats_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_timeserise.py

@@ -1,22 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_timeserise"""
-def register(mcp):
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_timeserise as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_timeserise_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/hs_util.py

@@ -1,30 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP wrappers for hossam.hs_util"""
-def register(mcp):
-    # @mcp.tool("hs_pretty_table")
-    # def hs_pretty_table(df, tablefmt: str = "simple", headers: str | list = "keys"):
-    #     """DataFrame을 단순 표 형태로 출력합니다. 원격 환경에서는 표 문자열을 반환합니다."""
-    #     # pretty_table은 print만 수행하므로, 문자열을 반환하도록 보정
-    #     from tabulate import tabulate
-    #     s = tabulate(df, headers=headers, tablefmt=tablefmt, showindex=True, numalign="right")
-    #     return s
-
-    # 자동 등록: 언더바로 시작하지 않는 모든 공개 함수 노출(중복 방지)
-    import inspect as _inspect
-    import functools as _functools
-    import hossam.hs_util as _mod
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        _tool_name = f"hs_util_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, tool_name=_tool_name):
-            @mcp.tool(tool_name, description=fn.__doc__)
-            @_functools.wraps(fn)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()

hossam/mcp/loader.py

@@ -1,29 +0,0 @@
-# -*- coding: utf-8 -*-
-"""MCP auto-wrappers for hossam.data_loader
-
-공개 함수(언더바 미사용) 전체를 MCP tool로 자동 등록합니다.
-단, load_data는 hs_util.load_data로 대체되므로 제외합니다.
-"""
-import inspect as _inspect
-import hossam.data_loader as _mod
-
-
-def register(mcp):
-    # load_data는 제외 (hs_util.load_data를 사용)
-    excluded_functions = ["load_data"]
-
-    for _name, _fn in _inspect.getmembers(_mod, _inspect.isfunction):
-        if _name.startswith("_"):
-            continue
-        if _name in excluded_functions:
-            continue
-        _tool_name = f"hs_data_{_name}"
-        if mcp.get_tool_info(_tool_name):
-            continue
-
-        def _make_tool(fn=_fn, name=_name):
-            @mcp.tool(name)
-            def _tool(**kwargs):
-                return fn(**kwargs)
-
-        _make_tool()