🎓 Jussam Data Helper
jussam은 학습용 샘플 데이터셋을 키(key) 하나로 간편하게 불러오기 위한 데이터 헬퍼 라이브러리입니다.
연세대학교 주영아 교수의 머신러닝 및 데이터 분석 수업을 위해 개발되었습니다.
✨ 주요 특징
- 📦 원클릭 데이터 로드: 데이터셋 키만으로 원격(또는 로컬) 데이터셋을 즉시
DataFrame으로 로드 - 🗂️ 다양한 포맷 지원: CSV, Excel(xlsx/xls), Parquet, JSON, Shapefile(shp), ZIP 압축 파일
- 📝 메타데이터 출력: 로드 시 데이터 설명과 필드 정보를 표 형태로 함께 표시
📦 설치
pip install --upgrade jussam
요구사항: Python 3.11 이상
🚀 사용법
데이터 로드
import jussam
# 메타데이터에 정의된 키로 데이터셋 로드 (설명/메타정보가 함께 출력됩니다)
df = jussam.load_data("AD_SALES")
df.head()
load_data의 시그니처는 다음과 같습니다.
load_data(key: str, local: str | None = None, view_url: bool = False) -> DataFrame | None
| 매개변수 | 설명 |
|---|---|
key |
메타데이터에 정의된 데이터 식별자(파일명 또는 별칭) |
local |
로컬 메타데이터 경로. None이면 원격 저장소를 사용합니다. |
view_url |
True이면 데이터의 실제 URL을 함께 출력합니다. |
# 데이터 URL도 함께 확인
df = jussam.load_data("AD_SALES", view_url=True)
# 로컬 metadata.json 경로를 사용
df = jussam.load_data("AD_SALES", local="./data")
표 출력 유틸리티
my_util 서브모듈은 DataFrame을 보기 좋게 출력하는 헬퍼를 제공합니다.
from jussam import my_util
from pandas import DataFrame
my_util.pretty_table(DataFrame({"a": [1, 2], "b": [3, 4]}))
📬 문의
- 👩🏫 주영아 (연세대학교)
- 📧 Email: j.purplerose@yonsei.ac.kr / j.purplerose@gmail.com
- 📝 Website: https://juyounga.kr/
📄 라이선스
이 프로젝트는 MIT 라이선스를 따릅니다. 자유롭게 사용, 수정, 배포할 수 있습니다.
1 maintainer
Metadata
1 maintainer
Release files for jussam 0.5.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jussam-0.5.21.tar.gz | 24.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jussam-0.5.21-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.2 MB
Release files / jussam-0.5.21.tar.gz
| Download URL | jussam-0.5.21.tar.gz |
|---|---|
| Size | 24.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5aa44dc8d1b53b2bd3104fa77eb133ba54ba49fff7a24c7d7e092e91f62ba83
|
|
BLAKE2b-256 checksum How to use checksums |
253ff7711465c274edb89c2cf34d16128a21f0aee6e15275d2b3fac62d0a4874
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / jussam-0.5.21-py3-none-any.whl
| Download URL | jussam-0.5.21-py3-none-any.whl |
|---|---|
| Size | 24.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6b3a6ba75e024331d663a85e7a185c83fa5f38672a2edd0b9ac5874e6b67da80
|
|
BLAKE2b-256 checksum How to use checksums |
78a1aa00a656149f871f7030c243883f303495dae294153e5bd20e83b9ce7c20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
