Data-Driven System Development/Project Structure

파이썬 프로젝트 / 패키지 작명 규칙 요약

Data Jun 2025. 4. 5. 21:13

**파이썬 프로젝트나 패키지 작명에도 일정한 규칙(또는 권장 컨벤션)**

파이썬 프로젝트 / 패키지 작명 규칙 요약

 

예시 비교

✅ 올바른 구조 예시

mlopsstudy/               ← 패키지 이름 (소문자 or 스네이크)
├── data_loader.py        ← 모듈 (소문자 + _)
├── ml_pipeline.py
├── MlManager.py          ← 클래스 파일이면 가능, 일반적으론 피함
└── __init__.py
# 내부 코드
from mlopsstudy import data_loader

class MlManager:
    ...

 

특별히 주의할 점

  • 패키지 이름은 반드시 소문자만 (import 시 ImportError 방지)
  • MyPackage, MyLib처럼 대문자 포함된 패키지는 ❌ 지양
    → import MyPackage는 OS/툴에 따라 문제 생김

 

결론

파이썬 프로젝트에서는 **"패키지와 모듈은 소문자 + 스네이크", "클래스는 파스칼"**이 기본 규칙이야.
특히 패키징, 배포, import 안정성까지 고려한다면 작명은 매우 중요해!