🚀 Jupyter 한글 환경 설정 치트시트 v2.4.0

📥 설치

from urllib.request import urlretrieve; urlretrieve("https://raw.githubusercontent.com/c0z0c/jupyter_hangul/master/helper_c0z0c_dev.py", "helper_c0z0c_dev.py")
import helper_c0z0c_dev as helper # 한번에 모든 설정 완료

🎉 출력 예시:

🚀 Jupyter/Colab 한글 환경 설정 중... (helper v2.4.0)
✅ 한글 폰트 및 pandas 확장 기능 설정 완료
🎉 사용 가능: 한글 폰트, CSV 읽기, DataFrame.head_att(), 캐시 기능

🧪 베타 버전 (최신 기능 테스트)

# 베타 버전 - 실험적 기능 포함
from urllib.request import urlretrieve; urlretrieve("https://raw.githubusercontent.com/c0z0c/jupyter_hangul/refs/heads/beta/helper_c0z0c_dev.py", "helper_c0z0c_dev.py")
import helper_c0z0c_dev as helper

🎯 주요 특징

💾 캐시 기능 (신규)

# 캐시 키 생성
key = helper.cache_key("experiment_1", param1="value1")

# 데이터 저장/로드
helper.cache_save(key, data)
loaded_data = helper.cache_load(key)

# 캐시 관리
helper.cache_exists(key)     # 존재 확인
helper.cache_delete(key)     # 삭제
helper.cache_clear()         # 전체 삭제
helper.cache_list_keys()     # 키 목록
helper.cache_size()          # 캐시 크기

한글 폰트 설정

# 자동으로 완료됨 - 추가 작업 불필요!
plt.title("한글 제목")  # 바로 사용 가능

📊 pandas 확장 기능

# 컬럼 설명 설정
df.set_head_att({"id": "아이디", "name": "이름", "age": "나이"})

# 한글 설명 포함 출력 (다양한 형식 지원)
df.head_att()              # 기본 print 형식
df.head_att(out='html')    # HTML 형식 (예쁘게 표시)
df.head_att(out='str')     # 문자열 반환

# 컬럼 세트 관리
df.set_head_ext('kr', {'name': '이름', 'age': '나이'})
df.set_head_column('kr')   # 한글 컬럼명으로 변경
df.set_head_column('org')  # 원본 컬럼명으로 복원

# 설명 조회 및 삭제
df.get_head_att()          # 전체 설명 조회
df.get_head_att('name')    # 개별 설명 조회
df.remove_head_att('name') # 설명 삭제
df.clear_head_att()        # 모든 설명 삭제

편의 함수

# 파일 읽기 (Colab/로컬 자동 인식)
df = helper.pd_read_csv('data.csv')

# 라이브러리 도움말 검색
helper.dir_start(pd.DataFrame, 'head')

캐시 기능

# 캐시 키 생성 및 데이터 저장/로드
params = {'alpha': 0.1, 'model': 'RF'}
key = helper.cache_key(params)
helper.cache_save(key, model)
model = helper.cache_load(key)

# 캐시 관리
helper.cache_exists(key)      # 존재 확인
helper.cache_list()           # 목록 조회
helper.cache_delete(key)      # 삭제
helper.cache_clear()          # 전체 삭제
helper.cache_info()           # 저장 위치 정보

📝 DataFrame 커밋 기능 (신규)

# DataFrame을 git처럼 커밋
df.commit("데이터 전처리 완료")
df.commit("결측치 제거 후")
df.commit("피처 엔지니어링 적용")

# 커밋 목록 조회
df.commit_list()              # 커밋 히스토리 조회

# 커밋 관리
df.commit_rm(0)               # 인덱스로 삭제
df.commit_rm("hash123")       # 해시로 삭제
df.commit_has("hash123")      # 커밋 존재 확인

# 또는 직접 함수 사용
helper.pd_commit(df, "메시지")
helper.pd_commit_list()
helper.pd_commit_rm(0)
helper.pd_commit_has("hash123")

🛠️ 개별 함수 사용법

# 메인 함수들
helper.font_download()        # 폰트 다운로드만
helper.load_font()           # 폰트 로딩만
helper.set_pandas_extension() # pandas 확장만

# 캐시 함수들
helper.cache_key(params)     # 캐시 키 생성
helper.cache_save(key, data) # 데이터 저장
helper.cache_load(key)       # 데이터 로드
helper.cache_exists(key)     # 존재 확인
helper.cache_delete(key)     # 캐시 삭제
helper.cache_list()          # 캐시 목록
helper.cache_clear()         # 전체 삭제
helper.cache_info()          # 캐시 정보
helper.cache_size()          # 캐시 크기
helper.cache_get_path()      # 캐시 경로

# DataFrame 커밋 함수들
helper.pd_commit(df, msg)    # DataFrame 커밋
helper.pd_commit_list()      # 커밋 목록 조회
helper.pd_commit_rm(idx)     # 커밋 삭제
helper.pd_commit_has(hash)   # 커밋 존재 확인

🎨 컬럼 설명 관리

# 여러 컬럼 한번에 설정
df.set_head_att({"col1": "설명1", "col2": "설명2"})

# 단일 컬럼 설정
df.set_head_att("col1", "새로운 설명")

# 설명 조회
df.get_head_att()

# 설명 삭제
df.remove_head_att("col1")  # 특정 컬럼 (리스트도 지원)
df.clear_head_att()         # 모든 컬럼

📊 출력 옵션

# DataFrame 출력 옵션
df.head_att()              # 기본 5행, print 형식
df.head_att(10)            # 10행
df.head_att("all")         # 모든 행
df.head_att(0)             # 헤더만

# 출력 형식 옵션
df.head_att(out='print')   # 콘솔 출력 (기본값)
df.head_att(out='html')    # HTML 형식 (예쁘게 표시)
df.head_att(out='str')     # 문자열 반환

# Series도 동일하게 지원
series.head_att()
series.head_att(out='html')

💡 팁

🆘 문제 해결

# 문제 발생 시
helper.setup()                 # 다시 설정

# 캐시 관련 문제
helper.cache_info()            # 캐시 저장 위치 확인
helper.cache_clear()           # 캐시 전체 삭제

📍 캐시 저장 위치