Skip to main content

🎓 Jussam Data Helper

Python Version License: MIT PyPI version

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]}))

📬 문의

📄 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다. 자유롭게 사용, 수정, 배포할 수 있습니다.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jussam-0.5.20.tar.gz (24.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jussam-0.5.20-py3-none-any.whl (24.1 MB view details)

Uploaded Python 3

File details

Details for the file jussam-0.5.20.tar.gz.

File metadata

  • Download URL: jussam-0.5.20.tar.gz
  • Upload date:
  • Size: 24.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jussam-0.5.20.tar.gz
Algorithm Hash digest
SHA256 8f72f7387f337d84a61725209a35a5e8f0975cc055d1104ec278f696bb3496a2
MD5 457fbf5608fd3c868dbd5446c06514e6
BLAKE2b-256 4039b08190fc862158a7d52ff01b8bb5514370ca10156b118112fa9df3eede10

See more details on using hashes here.

File details

Details for the file jussam-0.5.20-py3-none-any.whl.

File metadata

  • Download URL: jussam-0.5.20-py3-none-any.whl
  • Upload date:
  • Size: 24.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jussam-0.5.20-py3-none-any.whl
Algorithm Hash digest
SHA256 c7e580a323f5952c0199c22d8d36be90b6d57eedad435fde8cf816b94596df57
MD5 0e2e775e7009fe1dc8440b7f0fccfb0a
BLAKE2b-256 ce1845592c52d1ebc3f56d264524a403bf0031cc0776a8ac332f73fd734ab622

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.5.20 This release

2 files

0.5.19

2 files

0.5.18

2 files

0.5.17

2 files

0.5.16

2 files

0.5.15

2 files

0.5.14

2 files

0.5.13

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page