[Python] Python 모듈의 import 및 from import 정리

🟢 Python 모듈의 형태

Python에서 모듈은 일반적으로 여러 기능을 하나의 파일에 모아 놓은 Python 코드 파일 .py 파일이지만,

디렉토리(폴더)도 모듈이 될 수 있습니다.

즉, Python 모듈은 다음과 같은 형태가 가능합니다.

대상 설명

파일	module.py (일반적인 Python 파일)
디렉토리(패키지)	module/ (폴더, 내부에 __init__.py가 있어야 함)
클래스	모듈 내부의 특정 클래스 (from module import ClassName)
함수	모듈 내부의 특정 함수 (from module import function_name)

✔ 모듈의 역할

• 코드 재사용 (같은 기능을 여러 곳에서 사용 가능)
• 코드 관리 (기능별로 정리 가능)
• 유지보수 편리

---

🟣 import vs from import 문법 정리

✅ import를 사용할 때 (import 뒤에 오는 것)

  

    
    
    
    
  
import 모듈명      # 파일 또는 디렉토리(패키지) 가능
import 디렉토리.모듈명  # 디렉토리(패키지) 내부의 특정 파일 가능

✔ 파일(.py)과 디렉토리(패키지) 모두 가능하지만,

✔ 클래스(class)와 함수(def)는 직접 import할 수 없음. (from import 사용 필요)

📌 예제 1: 일반적인 모듈 (.py 파일)

  

    
    
    
    
  
import mymodule  # [mymodule.py](<http://mymodule.py/>) 가져오기

result = mymodule.some_function()  # 모듈명.함수명()으로 호출
print(result)

📌 예제 2: 패키지(디렉토리) 내부의 모듈 가져오기

  

    
    
    
    
  
import mypackage.mymodule  # mypackage 디렉토리 내 mymodule.py 가져오기

result = mypackage.mymodule.some_function()

❌ 불가능한 경우

  

    
    
    
    
  
import mymodule.MyClass  # 클래스는 직접 import 불가! (오류 발생)
import mymodule.some_function  # 함수도 직접 import 불가! (오류 발생)

🔹 클래스(class)와 함수(def)는 import 단독으로 불러올 수 없고 from import를 사용해야 함!

---

✅ from import를 사용할 때 (from 모듈명 import 뒤에 오는 것)

  

    
    
    
    
  
from 모듈 import 클래스명, 함수명, 변수명
from 디렉토리.모듈 import 클래스명, 함수명

✔ 모듈 내부의 특정 클래스, 함수, 변수를 직접 가져올 수 있음

✔ 디렉토리(패키지) 내부의 특정 모듈도 가져올 수 있음

📌 예제 1: 모듈에서 특정 함수 가져오기

  

    
    
    
    
  
from mymodule import some_function  # mymodule.py에서 some_function만 가져오기

result = some_function()

📌 예제 2: 모듈에서 특정 클래스 가져오기

  

    
    
    
    
  
from mymodule import MyClass  # mymodule.py에서 MyClass 가져오기

obj = MyClass()

📌 예제 3: 패키지(디렉토리) 내부의 모듈에서 특정 함수 가져오기

  

    
    
    
    
  
from mypackage.mymodule import some_function  # 패키지 내 특정 모듈의 함수 가져오기

result = some_function(

from import * 사용법 (비추천 ❌)

  

    
    
    
    
  
from 모듈이름 import *

• 모듈 내 모든 기능을 가져오지만, 어떤 함수가 어디서 왔는지 알기 어려움
• 충돌 가능성이 있어서 일반적으로 추천되지 않음

📌 예제

  

    
    
    
    
  
from math import *  # math 모듈의 모든 함수를 가져오기

print(sqrt(25))  # math.sqrt() 없이 직접 사용 가능
print(pi)  # math.pi 없이 pi로 사용 가능

❗ 하지만, import *는 너무 많은 기능을 가져오므로, 필요한 것만 가져오는 것이 좋음

  

    
    
    
    
  
from math import sqrt, pi  # 필요한 것만 가져오기 (추천)

🟢 import vs from import 비교

구분 import from import

불러오는 범위	모듈 전체	모듈 내 특정 함수/변수/클래스
사용 방식	모듈이름.함수명()	함수명()
코드 가독성	명확함 (math.sqrt(25))	짧고 편리 (sqrt(25))
변수 충돌 위험	낮음	높음 (다른 모듈의 같은 이름과 충돌 가능)

• 모듈 전체를 사용해야 하면 import 모듈이름
• 특정 함수/변수만 가져와서 짧게 쓰고 싶다면 from 모듈이름 import 함수명
• 필요한 것만 가져와야 가독성과 유지보수성이 좋음!

---

🔴 파일(모듈)에 함수만 있을 경우 import 가능할까?

✔ 네, 가능합니다!

✔ Python에서 import 뒤에는 파일명(확장자 .py 제외) 이 올 수 있습니다.

✔ 파일 내부에 함수만 있어도 import는 가능하지만, 모듈명.함수명() 형식으로 호출해야 함.

📌 예제: mymodule.py (파일 내부에 함수만 존재)

  

    
    
    
    
  
# mymodule.py
def my_function():
    return "Hello from my_function!"

✅ import 사용 (파일을 모듈로 가져오기)

  

    
    
    
    
  
import mymodule  # mymodule.py 전체를 불러옴

result = mymodule.my_function()  # 모듈명.함수명()으로 호출
print(result)  # "Hello from my_function!"

✅ from import 사용 (특정 함수만 가져오기)

  

    
    
    
    
  
from mymodule import my_function  # 특정 함수만 가져오기

result = my_function()  # 직접 호출 가능
print(result)  # "Hello from my_function!"

❌ import 뒤에 함수명을 직접 쓸 수 있을까?

  

    
    
    
    
  
import mymodule.my_function  # ❌ 불가능! (오류 발생)

🔹 import는 파일(모듈) 전체만 가져올 수 있고, 함수는 직접 가져올 수 없음!

🔹 특정 함수나 클래스를 가져오려면 from import 사용해야 함.

---

🛑 변수/클래스/함수 충돌 위험

✔ import 모듈명을 사용하면 충돌이 발생하지 않음

✔ from 모듈 import 변수/클래스/함수를 사용할 경우 충돌 가능성이 있음

✔ 결론적으로, from import를 사용할 때 같은 이름이 있는 경우 덮어씌워질 위험이 있음!

---

🔴 변수 충돌 예제

  

    
    
    
    
  
# module_a.py
value = "I am from module_a"

  

    
    
    
    
  
# module_b.py
value = "I am from module_b"

🚨 from import로 가져올 경우 충돌 발생 가능

  

    
    
    
    
  
from module_a import value
from module_b import value  # module_a의 value가 덮어씌워짐!

print(value)  # "I am from module_b"

✔ 해결책 → import 모듈명 사용 또는 as 별칭(alias) 사용

  

    
    
    
    
  
import module_a
import module_b

print(module_a.value)  # "I am from module_a"
print(module_b.value)  # "I am from module_b"

---

🔵 클래스 충돌 예제

  

    
    
    
    
  
# module_x.py
class MyClass:
    def show(self):
        print("This is MyClass from module_x")

  

    
    
    
    
  
# module_y.py
class MyClass:
    def show(self):
        print("This is MyClass from module_y")

🚨 from import 사용 시 충돌 발생

  

    
    
    
    
  
from module_x import MyClass
from module_y import MyClass  # module_x의 MyClass가 덮어씌워짐!

obj = MyClass()
obj.show()  # "This is MyClass from module_y"

✔ 해결책 → import 모듈명 사용 또는 as 별칭(alias) 사용

  

    
    
    
    
  
# 1. 가장 안전한 방식 (추천)
import module_x
import module_y

obj_x = module_x.MyClass()
obj_y = module_y.MyClass()

obj_x.show()  # "This is MyClass from module_x"
obj_y.show()  # "This is MyClass from module_y"

# 2. `from import` 사용 시 별칭(alias) 사용
from module_x import MyClass as XClass
from module_y import MyClass as YClass

obj_x = XClass()
obj_y = YClass()

---

🔵 함수 충돌 예제

  

    
    
    
    
  
# module_a.py
def greeting():
    return "Hello from module_a"

  

    
    
    
    
  
# module_b.py
def greeting():
    return "Hello from module_b"

🚨 from import 사용 시 충돌 발생

  

    
    
    
    
  
from module_a import greeting
from module_b import greeting  # module_a의 greeting이 덮어씌워짐!

print(greeting())  # "Hello from module_b"

✔ 해결책 → import 모듈명 사용 또는 as 별칭(alias) 사용

  

    
    
    
    
  
import module_a
import module_b

print(module_a.greeting())  # "Hello from module_a"
print(module_b.greeting())  # "Hello from module_b"

---

🔴 최종 정리

대상 import 뒤에 오는 것 from import 뒤에 오는 것

파일(모듈) (mymodule.py)	import mymodule	from mymodule import 함수명, 클래스명
디렉토리(패키지) (mypackage/)	import mypackage.모듈명	from mypackage.모듈명 import 함수명, 클래스명
클래스 (class MyClass)	❌ (import 불가)	✅ from 모듈 import MyClass
함수 (def my_function)	❌ (import 불가)	✅ from 모듈 import my_function

---

🚀 결론

1️⃣ 파일(.py)이나 디렉토리(패키지)는 import 가능

2️⃣ 클래스와 함수는 from import를 사용해야 불러올 수 있음

3️⃣ 패키지 내부의 모듈도 import 또는 from import로 가져올 수 있음

4️⃣ 파일 내부에 함수만 있어도 import 파일명 가능하지만, 모듈명.함수명() 형식으로 호출해야 함

5️⃣ 함수를 직접 import 하려면 from import를 사용해야 함!

💡 추천 스타일

  

    
    
    
    
  
# 모듈 전체 가져오기 (명확한 사용)
import mymodule
result = mymodule.some_function()

# 특정 함수/클래스만 가져오기 (짧고 편리)
from mymodule import some_function
result = some_function()

# 패키지 내부의 모듈 가져오기
import mypackage.mymodule
result = mypackage.mymodule.some_function()

# 패키지 내부의 특정 함수 가져오기
from mypackage.mymodule import some_function
result = some_function()