[파이썬] 코드 재사용을 위한 모듈 & 패키지 이해하기

 

앞에서는 함수, 클래스, 상속을 통해 코드 재사용성을 높였어요.
이번에는 한 단계 더 나아가서,
파일 단위로 코드 재사용할 수 있는 모듈(Module)과
폴더 단위로 프로젝트를 구조화할 수 있는 패키지(Package)를 배워봅시다!

 

---

 

1️⃣ 모듈(Module)이란?

파이썬 파일(.py) 하나가 모듈이에요.
다른 파이썬 코드에서 불러와서 사용할 수 있죠.

 

📌 장점

• 코드 재사용성 높다
• 프로젝트 파일 관리 용이
• 기능별로 코드 분리 가능

---

 

📝 모듈 만들기

 

1. mymodule.py 파일 작성

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

def greet(name):
    return f"안녕하세요, {name}님!"

 

 

2. 다른 파일에서 모듈 불러오기

import mymodule

print(mymodule.add(3, 5))    # 8
print(mymodule.greet("짱구"))  # 안녕하세요, 짱구님!

 

---

 

🔹 from-import로 함수 바로 불러오기

from mymodule import add, greet

print(add(2, 4))
print(greet("코딩"))

 

---

 

2️⃣ 패키지(Package)란?

여러 모듈(.py 파일)을 모아놓은 폴더
__init__.py 파일이 있으면 패키지로 인식돼요.

 

📂 예시 프로젝트 구조

myproject/
 ├── mypackage/
 │   ├── __init__.py
 │   ├── math_utils.py
 │   └── string_utils.py
 └── main.py

 

---

 

📝 패키지 사용하기

# math_utils.py
def square(x):
    return x * x

# main.py
from mypackage.math_utils import square

print(square(5))  # 25

 

---

 

🔥 표준 라이브러리 vs 사용자 모듈

• 표준 라이브러리: 파이썬이 기본으로 제공하는 모듈 (math, random, datetime 등)
• 사용자 모듈: 내가 직접 만든 모듈

---

 

📌 표준 라이브러리 예시

import math
import random
import datetime

print(math.sqrt(16))            # 4.0
print(random.randint(1, 10))    # 1~10 사이 난수
print(datetime.datetime.now())  # 현재 날짜/시간

 

---

 

📌 외부 패키지 설치하기

파이썬 패키지 인덱스(PyPI)에서 pip으로 설치 가능

 

pip install requests

 

import requests
res = requests.get("https://www.google.com")
print(res.status_code)

 

 

---

 

🎯 오늘의 핵심 정리

 

모듈: .py 파일 하나

패키지: 모듈을 묶은 폴더 (__init__.py 필수)

import, from-import로 모듈 불러오기

표준 라이브러리 & 외부 패키지로 기능 확장 가능

 

---

 

 

🔜 다음 글 예고

 

[파이썬] 표준 라이브러리 완전정리

파이썬이 기본으로 제공하는 표준 라이브러리를 활용해보아요.