10. 모듈과 패키지 사용법

파이썬은 모듈과 패키지를 통해 코드를 효율적으로 분리하고 재사용할 수 있습니다. 이번 글에서는 import 구문, 사용자 정의 모듈, 디렉토리 구조를 활용하는 방법을 알아봅니다.

1. 모듈(Module)이란?

모듈은 하나의 .py 파일입니다. 함수나 변수, 클래스를 정의해두고 다른 파일에서 import해서 사용할 수 있습니다.

예: `math`, `random`, `os` 등도 모두 파이썬 내장 모듈입니다.

2. import 기본 사용법

import math
print(math.sqrt(16))  # 4.0

from random import randint
print(randint(1, 10))  # 1~10 사이 무작위 정수
  

• import 모듈명 → 전체 가져오기
• from 모듈명 import 함수명 → 원하는 항목만 가져오기
• as 별칭 → 이름을 짧게 바꾸기

3. 사용자 정의 모듈 만들기

파일 하나를 모듈처럼 만들어 재사용할 수 있습니다.

step1: mymath.py 파일 생성

# mymath.py
def add(x, y):
    return x + y

def sub(x, y):
    return x - y
  

step2: 다른 파일에서 import

import mymath

print(mymath.add(10, 5))  # 15
print(mymath.sub(10, 5))  # 5
  

4. 패키지(Package)란?

패키지는 모듈이 들어있는 폴더입니다. 반드시 __init__.py 파일이 있어야 패키지로 인식됩니다 (파이썬 3.3 이후 생략 가능).

예시 폴더 구조:

myapp/
 ├── main.py
 └── utils/
     ├── __init__.py
     └── stringtools.py
  

사용 방법:

from utils import stringtools
  

이처럼 폴더 단위로 코드를 모듈화하면 유지보수와 협업이 훨씬 쉬워집니다.

5. 실용 팁

• import *은 지양하고 필요한 함수만 명시적으로 가져오기
• 모듈명은 파일명과 같아야 하며, 반드시 같은 경로 또는 PYTHONPATH에 있어야 함
• 자주 쓰는 외부 패키지는 pip install로 설치 가능 (예: pandas, requests)

6. 정리

모듈과 패키지는 파이썬의 코드 재사용성과 구조화를 위한 필수 기능입니다. 작은 단위로 코드를 나누고 필요한 기능만 가져와 사용하는 습관은 실무에서도 매우 중요합니다.

7. 1부를 마치며

1부: 파이썬 기초 다지기에서는 변수, 자료형, 조건문, 반복문, 함수, 파일 처리 등 파이썬의 기초를 다졌습니다.

이제 여러분은 실제 프로그램을 구성할 수 있는 문법적 기반을 갖췄습니다.

8. 2부: 파이썬 실전 활용 소개

2부: 파이썬 중급 문법과 실무 활용 에서는 실무와 프로젝트에 가까운 주제를 다루겠습니다.