[초급반] Step 9. 모듈과 패키지: 외부 라이브러리 사용하기

안녕하세요! 파이썬 학습 아홉 번째 시간입니다. 지금까지 우리는 직접 코드를 작성하고 함수를 만들어 모듈화(Step 7)하는 방법을 배웠습니다.

오늘은 다른 개발자들이 이미 만들어 놓은 강력하고 방대한 기능을 내 코드에 가져와 사용하는 방법을 배웁니다. 이것이 바로 파이썬 생태계의 핵심인 **모듈(Module)**과 패키지(Package) 시스템입니다.

---

1. 모듈 (Module): 코드의 단위 파일

파이썬에서 모듈이란 단순히 .py 확장자를 가진 하나의 파일입니다. 이 파일 안에는 함수, 클래스, 변수 등이 정의되어 있습니다.

💡 모듈의 생성 및 불러오기

1-1. 모듈 만들기

calculator.py라는 파일을 만들고 그 안에 간단한 함수를 정의합니다.

Python

 

# calculator.py 파일 내용

def add(a, b):
    return a + b

def multiply(a, b):
    return a * b

1-2. 모듈 불러오기 (import)

main.py 파일에서 위 모듈을 사용합니다. import 키워드를 사용하여 모듈 전체를 가져올 수 있습니다.

Python

 

# main.py 파일 내용
import calculator # calculator.py 파일을 모듈로 불러옴

# 모듈 이름.함수 이름 형태로 사용
print(calculator.add(10, 5))    # 결과: 15
print(calculator.multiply(10, 5)) # 결과: 50

1-3. 다양한 import 방법

방법	사용법	장점
기본 (import)	import 모듈명	함수 사용 시 모듈명을 명시해야 하므로 이름 충돌 방지에 유리합니다. (권장)
별명 (as)	import 모듈명 as 별명	모듈 이름이 길 때 짧게 줄여서 사용합니다. (예: import pandas as pd)
특정 기능 (from)	from 모듈명 import 함수명	모듈명 없이 함수만 바로 사용할 수 있습니다. (이름 충돌 위험 증가)

Python

 

# 'calc'라는 별명으로 불러오기
import calculator as calc
print(calc.add(2, 3)) 

# add 함수만 직접 불러오기 (calculator. 없이 바로 사용 가능)
from calculator import add
print(add(2, 3))

2. 패키지 (Package): 모듈의 폴더 구조

패키지는 여러 개의 **모듈(파일)**들을 기능별로 묶어놓은 **디렉터리(폴더)**입니다. 대규모 프로젝트에서는 코드를 체계적으로 정리하기 위해 패키지 구조를 사용합니다.

💡 패키지 구조 예시

my_app/
├── main.py
└── data_processing/ # <--- 패키지 이름 (폴더)
    ├── __init__.py  # <--- 필수! 파이썬에게 이 폴더가 패키지임을 알려줌
    ├── file_io.py   # <--- 모듈 1
    └── analysis.py  # <--- 모듈 2

💡 패키지 사용법

패키지 내부의 모듈을 가져올 때는 패키지명.모듈명 형태로 경로를 지정합니다.

Python

 

# main.py에서 data_processing 패키지 내부의 file_io 모듈을 불러옴
import data_processing.file_io

# 또는 from ... import ... 형태로 사용
from data_processing import analysis

3. 외부 라이브러리 관리: pip와 PyPI

파이썬의 진정한 힘은 전 세계 개발자들이 만든 수십만 개의 외부 라이브러리(패키지)에 있습니다. 이 라이브러리들은 **PyPI (Python Package Index)**라는 중앙 저장소에 등록되어 있습니다.

💡 pip (Package Installer for Python)

pip은 PyPI에 등록된 외부 패키지들을 다운로드하고 설치, 관리해주는 파이썬의 표준 패키지 관리 도구입니다.

• 설치: 파이썬을 설치할 때 대부분 자동으로 설치됩니다.
• 사용법: 명령 프롬프트(CMD)나 터미널에서 사용합니다.

3-1. 라이브러리 설치

데이터 분석에 필수적인 pandas 라이브러리를 설치하는 예시입니다.

Bash

 

pip install pandas

3-2. 라이브러리 제거

Bash

 

pip uninstall pandas

4. 표준 라이브러리 맛보기

파이썬에는 설치 없이 바로 사용할 수 있는 강력한 표준 라이브러리가 내장되어 있습니다.

라이브러리	기능	사용 예시
math	수학 관련 함수 (제곱근, 삼각함수 등)	import math; print(math.sqrt(9))
random	난수 생성 함수	import random; print(random.randint(1, 10)) (1~10 사이 정수 난수)
os	운영체제 상호작용 (파일 경로, 환경 변수 등)	import os; print(os.getcwd()) (현재 작업 디렉터리 확인)