18. [파이썬] 모듈과 프로젝트 구조

💡 본 포스팅은 수업 내용, 교재, ChatGPT를 참고하여 정리한 학습 기록입니다.
글과 그림 등 모든 콘텐츠의 정리 및 작성은 본 블로그에서 직접 제작되었습니다.

 

Python 기초부터 Streamlit 데이터 시각화까지 정리하는 학습 기록입니다.

이 글은 '18. [파이썬] 모듈과 프로젝트 구조' 입니다.

 

Python 프로그램을 작성하다 보면 코드의 길이가 점점 길어지고, 여러 기능이 하나의 파일에 모이게 되는 경우가 많다.

이럴 때 코드를 기능별로 분리하여 관리하면 가독성과 유지보수성이 크게 향상된다.

Python에서는 이러한 구조화를 위해 모듈(module) 개념을 사용한다.

 

이번 글에서는 Python 프로그램을 구조적으로 관리하기 위한 모듈의 개념과 __name__, __main__을 활용한 기본적인 프로젝트 구조를 

정리해본다.

 

 

모듈(Module)

모듈은 Python 코드가 담긴 하나의 파일(.py) 을 의미한다.

즉, Python 파일 자체가 하나의 모듈이다.

예를 들어 다음과 같은 파일이 있다고 가정해보자.

# math_utils.py

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

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

이 파일은 math_utils라는 모듈이 된다.

다른 파일에서 이 모듈을 사용할 수 있다.

import math_utils

print(math_utils.add(3, 5))
print(math_utils.multiply(3, 5))

이처럼 모듈을 사용하면 코드를 기능별로 분리하여 재사용할 수 있다.

 

 

import

모듈을 사용하기 위해서는 import 키워드를 사용한다.

가장 기본적인 방식은 다음과 같다.

import math_utils

 

이 경우 모듈 이름을 통해 함수에 접근한다.

math_utils.add(3, 5)

 

특정 함수만 가져올 수도 있다.

from math_utils import add

 

이 경우 모듈 이름 없이 바로 사용할 수 있다.

add(3, 5)

 

 

별칭을 사용하는 방법도 있다.

import math_utils as mu

 

사용 예시

mu.add(3, 5)

이처럼 import는 다양한 방식으로 사용할 수 있다.

 

 

name

Python 파일에는 기본적으로 __name__이라는 특별한 변수가 존재한다.

이 변수는 현재 파일이 어떻게 실행되는지를 알려준다.

예를 들어 다음 코드를 보자.

print(__name__)

 

파일을 직접 실행하면 다음과 같이 출력된다.

__main__

 

하지만 다른 파일에서 import 하면 결과가 달라진다.

모듈 이름

 

즉 __name__은 현재 파일의 실행 상태를 나타낸다.

 

 

main

Python에서는 다음과 같은 구조를 자주 사용한다.

if __name__ == "__main__":
    print("program start")

이 코드는 현재 파일을 직접 실행했을 때만 코드가 실행되도록 하는 구조이다.

예를 들어 다음과 같은 모듈을 만들 수 있다.

def greet(name):
    print(f"Hello {name}")

if __name__ == "__main__":
    greet("Matt")

 

이 파일을 직접 실행하면 함수가 실행되지만, 다른 파일에서 import하면 해당 코드는 실행되지 않는다.

이 구조는 모듈 재사용과 테스트 코드 작성에 매우 유용하다.

 

 

간단한 프로젝트 구조

프로그램이 커지면 여러 모듈을 함께 사용하는 구조가 된다.

예를 들어 다음과 같은 프로젝트 구조를 만들 수 있다.

project/
├─ main.py
├─ math_utils.py
└─ data_utils.py

이처럼 기능을 모듈로 나누면

• 코드 관리가 쉬워지고
• 기능 재사용이 가능하며
• 프로그램 구조가 명확해진다.

모듈 사용의 장점

Python에서 모듈을 사용하는 이유는 다음과 같다.

• 코드 재사용
• 기능별 코드 분리
• 유지보수 용이
• 프로젝트 구조 정리

특히 프로그램이 커질수록 모듈 구조를 잘 설계하는 것이 중요하다.

 

 

정리

Python에서 모듈은 코드를 기능별로 분리하여 관리하기 위한 기본 단위이다.

.py 파일 하나가 하나의 모듈이 되며 import를 통해 다른 파일에서 사용할 수 있다.

또한 __name__과 __main__ 구조를 활용하면 모듈 재사용과 실행 코드 분리를 효과적으로 관리할 수 있다.

프로젝트 규모가 커질수록 모듈을 활용한 구조적인 코드 관리가 중요해진다.

 

다음 글에서는 Python에서 데이터를 정렬하고 처리할 때 자주 사용하는 정렬 기술과 유용한 내장 함수를 살펴본다.