hossam 0.3.16__py3-none-any.whl → 0.3.17__py3-none-any.whl

hossam-0.3.17.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,27 @@
+hossam/NotoSansKR-Regular.ttf,sha256=0SCufUQwcVWrWTu75j4Lt_V2bgBJIBXl1p8iAJJYkVY,6185516
+hossam/__init__.py,sha256=j5tp7g9ljMRUo-aCeMXRXyIOXiXkUN9dHRRMGmiG2kU,2800
+hossam/data_loader.py,sha256=UpC_gn-xUWij0s-MO51qrzJNz3b5-RCz1N6esQMZUJM,6320
+hossam/hs_classroom.py,sha256=b2vzxHapxibnJwcRwWvOfLfczjF-G3ZdT9hIUt4z4oU,27407
+hossam/hs_gis.py,sha256=9ER8gXG2Or0DZ1fpbJR84WsNVPcxu788FsNtR6LsEgo,11379
+hossam/hs_plot.py,sha256=7cngzrEeVeBvANyReI9kd3yHZGMOFZjvgBbBGA7rT2E,78467
+hossam/hs_prep.py,sha256=RMeM6QPR-dsk3X_crJity8Tva8xY-mOXlcG3L7W-qjg,36220
+hossam/hs_stats.py,sha256=2P_CeitniiiOcuX1El6si7IUOayThxIVBbuCaCASNVY,117746
+hossam/hs_timeserise.py,sha256=loRofR-m2NMxHaDEWDhZjo6DwayEf4c7qkSoCErfBWY,42165
+hossam/hs_util.py,sha256=E4LnzPlRdWeqICv7TtTL9DT5PogqBhOuTgYiaav565U,7461
+hossam/leekh.png,sha256=1PB5NQ24SDoHA5KMiBBsWpSa3iniFcwFTuGwuOsTHfI,6395
+hossam/mcp/__init__.py,sha256=uOFs4lTDpYoB_YZM4wOENkB0yWD0m8xuY7p4RQaskyE,338
+hossam/mcp/hs_classroom.py,sha256=u_5WUvNSS9e9wmBAxsMeCty5lnposZC1w-pud7jMhuk,759
+hossam/mcp/hs_gis.py,sha256=PyfzySp_degVbg7O3h0BlDfZJjgclCQKScku-klcuX8,1176
+hossam/mcp/hs_plot.py,sha256=3e9FabRrf0FEwUTtld3e3irJFWzmU7EuV99GMfzLqnY,2474
+hossam/mcp/hs_prep.py,sha256=QcaUb-kggexi-chMCRoN104YXKsDHJNZJifDJkadef4,2624
+hossam/mcp/hs_stats.py,sha256=9ODc3rXxzOasng1nvMDctbPC_T6gyeN72-hOiDCJ2eQ,796
+hossam/mcp/hs_timeserise.py,sha256=Uc5ZKLv_sBe1tUdSZ0pmBuAFOQ_yX2MH8Me3DVeBp7c,762
+hossam/mcp/hs_util.py,sha256=XsjOb9K5PUeAStgne-BluVUGyt0QEzN5wmFX77-yYGk,1237
+hossam/mcp/loader.py,sha256=Ib11QUG8gV1V0TkMUz1g5kGsFJCApiwiwQ9N1cCy7bA,857
+hossam/mcp/server.py,sha256=4B6ri8xwX22sA6OlNOWC4wN7Uwfgtt4gQ_HvROMNINo,21270
+hossam-0.3.17.dist-info/licenses/LICENSE,sha256=nIqzhlcFY_2D6QtFsYjwU7BWkafo-rUJOQpDZ-DsauI,941
+hossam-0.3.17.dist-info/METADATA,sha256=Tswwq9IlA5HvTPh7AI6GJMl_SBV1hdCpidfD3BH8jpc,5654
+hossam-0.3.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hossam-0.3.17.dist-info/entry_points.txt,sha256=0y7c7g_swXFS6See69i-4q_shcwUs-wIalfuvuYiA9I,53
+hossam-0.3.17.dist-info/top_level.txt,sha256=_-7bwjhthHplWhywEaHIJX2yL11CQCaLjCNSBlk6wiQ,7
+hossam-0.3.17.dist-info/RECORD,,

hossam-0.3.17.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hossam-mcp = hossam.mcp.server:run