hossam 0.3.15__tar.gz → 0.3.17__tar.gz

hossam-0.3.17/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: hossam
+Version: 0.3.17
+Summary: Hossam Data Helper
+Author-email: Lee Kwang-Ho <leekh4232@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/leekh4232/hossam-py
+Project-URL: Repository, https://github.com/leekh4232/hossam-py
+Keywords: data,analysis,helper,hossam,tensorflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tqdm
+Requires-Dist: tabulate
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: seaborn
+Requires-Dist: requests
+Requires-Dist: openpyxl
+Requires-Dist: xlrd
+Requires-Dist: statsmodels
+Requires-Dist: scipy
+Requires-Dist: scikit-learn
+Requires-Dist: pingouin
+Requires-Dist: statannotations
+Requires-Dist: joblib
+Requires-Dist: geopandas
+Requires-Dist: kmodes
+Requires-Dist: pmdarima
+Requires-Dist: prophet
+Requires-Dist: plotly
+Dynamic: license-file
+
+---
+title: 🎓 Hossam Data Helper
+---
+
+# 🎓 Hossam Data Helper
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Version](https://img.shields.io/badge/version-0.3.8-green.svg)](https://pypi.org/project/hossam/)
+[![Documentation](https://img.shields.io/badge/docs-py.hossam.kr-blue.svg)](https://py.hossam.kr)
+
+**Hossam**은 데이터 분석, 시각화, 통계 처리를 위한 종합 헬퍼 라이브러리입니다.
+
+아이티윌(ITWILL)에서 진행 중인 머신러닝 및 데이터 분석 수업을 위해 개발되었으며, 이광호 강사의 강의에서 활용됩니다.
+
+## ✨ 주요 특징
+
+- 📊 **풍부한 시각화**: 25+ 시각화 함수 (Seaborn/Matplotlib 기반)
+- 🎯 **통계 분석**: 회귀, 분류, 시계열 분석 도구
+- 📦 **샘플 데이터**: 학습용 데이터셋 즉시 로드
+- 🔧 **데이터 전처리**: 결측치 처리, 이상치 탐지, 스케일링
+- 🤖 **MCP 서버**: VSCode/Copilot과 통합 가능한 Model Context Protocol 지원
+- 📈 **교육용 최적화**: 데이터 분석 교육에 특화된 설계
+
+---
+
+## 📦 설치
+
+```bash
+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)에서 확인하세요.**
+
+### 주요 모듈
+
+- **hs_plot**: 25+ 시각화 함수 (선 그래프, 산점도, 히스토그램, 박스플롯, 히트맵 등)
+- **hs_stats**: 회귀/분류 분석, 교차검증, 정규성 검정, 상관분석 등
+- **hs_prep**: 결측치 처리, 이상치 탐지, 스케일링, 인코딩
+- **hs_gis**: GIS 데이터 로드 및 시각화 (대한민국 지도 지원)
+- **hs_classroom**: 학습용 이진분류, 다중분류, 회귀 데이터 생성
+- **hs_util**: 예쁜 테이블 출력, 그리드 서치 등
+
+자세한 사용법은 [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)
+- **PyPI**: [pypi.org/project/hossam](https://pypi.org/project/hossam/)
+- **강사**: 이광호 (ITWILL 머신러닝 및 데이터 분석)
+
+---
+
+**Made with ❤️ for Data Science Education**

hossam-0.3.17/README.md

@@ -0,0 +1,167 @@
+---
+title: 🎓 Hossam Data Helper
+---
+
+# 🎓 Hossam Data Helper
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Version](https://img.shields.io/badge/version-0.3.8-green.svg)](https://pypi.org/project/hossam/)
+[![Documentation](https://img.shields.io/badge/docs-py.hossam.kr-blue.svg)](https://py.hossam.kr)
+
+**Hossam**은 데이터 분석, 시각화, 통계 처리를 위한 종합 헬퍼 라이브러리입니다.
+
+아이티윌(ITWILL)에서 진행 중인 머신러닝 및 데이터 분석 수업을 위해 개발되었으며, 이광호 강사의 강의에서 활용됩니다.
+
+## ✨ 주요 특징
+
+- 📊 **풍부한 시각화**: 25+ 시각화 함수 (Seaborn/Matplotlib 기반)
+- 🎯 **통계 분석**: 회귀, 분류, 시계열 분석 도구
+- 📦 **샘플 데이터**: 학습용 데이터셋 즉시 로드
+- 🔧 **데이터 전처리**: 결측치 처리, 이상치 탐지, 스케일링
+- 🤖 **MCP 서버**: VSCode/Copilot과 통합 가능한 Model Context Protocol 지원
+- 📈 **교육용 최적화**: 데이터 분석 교육에 특화된 설계
+
+---
+
+## 📦 설치
+
+```bash
+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)에서 확인하세요.**
+
+### 주요 모듈
+
+- **hs_plot**: 25+ 시각화 함수 (선 그래프, 산점도, 히스토그램, 박스플롯, 히트맵 등)
+- **hs_stats**: 회귀/분류 분석, 교차검증, 정규성 검정, 상관분석 등
+- **hs_prep**: 결측치 처리, 이상치 탐지, 스케일링, 인코딩
+- **hs_gis**: GIS 데이터 로드 및 시각화 (대한민국 지도 지원)
+- **hs_classroom**: 학습용 이진분류, 다중분류, 회귀 데이터 생성
+- **hs_util**: 예쁜 테이블 출력, 그리드 서치 등
+
+자세한 사용법은 [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)
+- **PyPI**: [pypi.org/project/hossam](https://pypi.org/project/hossam/)
+- **강사**: 이광호 (ITWILL 머신러닝 및 데이터 분석)
+
+---
+
+**Made with ❤️ for Data Science Education**

{hossam-0.3.15 → hossam-0.3.17}/hossam/__init__.py

@@ -5,6 +5,7 @@ from matplotlib import font_manager as fm
 from importlib.resources import files, as_file
 from importlib.metadata import version
 from types import SimpleNamespace
+import sys
 import warnings
 
 try:
@@ -15,14 +16,14 @@ except Exception:
 
 hs_fig = SimpleNamespace(
     dpi=200,
-    width=600,
-    height=320,
-    font_size=6,
+    width=800,
+    height=480,
+    font_size=9.5,
     font_weight="light",
-    frame_width=0.4,
-    line_width=1,
+    frame_width=0.5,
+    line_width=1.5,
     grid_alpha=0.3,
-    grid_width=0.4,
+    grid_width=0.5,
     fill_alpha=0.3
 )
 
@@ -56,9 +57,10 @@ def _init_korean_font():
                 "pdf.fonttype": 42,
                 "ps.fonttype": 42,
             })
-            print(
-                "\n✅ 시각화를 위한 한글 글꼴(NotoSansKR-Regular)이 자동 적용되었습니다."
-            )
+            if sys.stdout.isatty():
+                print(
+                    "\n✅ 시각화를 위한 한글 글꼴(NotoSansKR-Regular)이 자동 적용되었습니다."
+                )
             return
     except Exception as e:
         warnings.warn(f"\n한글 폰트 초기화: 패키지 폰트 사용 실패 ({e}).")
@@ -76,8 +78,10 @@ def _init():
         f"🔖 Version: {__version__}",
     ]
 
-    for msg in messages:
-        print(f"{msg}")
+    # MCP/stdio 환경에서는 배너를 출력하지 않음 (stdout TTY일 때만 출력)
+    if sys.stdout.isatty():
+        for msg in messages:
+            print(f"{msg}")
 
     _init_korean_font()