패키지

•

패키지란

•

설치

•

import

패키지 (package)

모듈(파일)들을 묶어 놓은 디렉토리 구조

여러 기능이 포함된 라이브러리의 집합입니다.

모듈 vs 패키지

구분	모듈	패키지
단위	파일 하나	디렉토리(폴더)
구성	단일 .py 파일	__init__.py + 여러 모듈 파일들
예시	module.py	package/__init__.py + module1.py + module2.py
import 방식	import module	from package import module

패키지 설치

pip install 패키지명
Shell
복사

파이썬 패키지를 설치하는 방법은 다음과 같습니다:

•

터미널/명령 프롬프트를 엽니다

•

pip install 명령어 뒤에 설치하고 싶은 패키지 이름을 입력합니다

설치가 완료되면 성공 메시지가 표시됩니다. 만약 이미 설치된 패키지라면 'Requirement already satisfied' 메시지가 나타납니다.

여러 패키지를 한 번에 설치하고 싶다면 공백으로 구분하여 입력할 수 있습니다:

pip install requests pandas matplotlib
Shell
복사

특정 버전을 설치하고 싶다면 다음과 같이 입력합니다:

pip install pandas==1.5.3
Shell
복사

import

Bash
복사

1. 패키지 전체 import

import mypackage.greetings
Python
복사

사용 시:

mypackage.greetings.hello()
Python
복사

2. 모듈만 import

from mypackage import greetings
Python
복사

사용 시:

greetings.hello()
Python
복사

3. 함수 또는 클래스만 import

from mypackage.greetings import hello
Python
복사

사용 시:

Python
복사

4. 하위 패키지 import

from mypackage.subpackage import submodule
Python
복사

5. 모든 항목 import (권장 )

from mypackage.greetings import *
Python
복사

__all__을 설정하지 않으면 예상대로 작동하지 않을 수 있어요.

참고: init.py 역할

•

__init__.py는 해당 디렉토리를 "패키지"로 인식하게 해줍니다.

•

내부에서 초기화 코드나 기본 노출 함수 등을 설정할 수 있어요.

예:

# mypackage/__init__.py
from .greetings import hello
Python
복사

이렇게 하면:

from mypackage import hello
hello()
Python
복사

모듈 import 예시

mymodule.py라는 하나의 .py 파일이 있다고 가정:

# mymodule.py
def say_hello():
    print("Hello from module!")
Python
복사

# main.py
import mymodule

mymodule.say_hello()
Python
복사

패키지 import 예시

# mypackage/
# ├── __init__.py
# ├── greetings.py
# └── utils.py
Python
복사

greetings.py

def hello():
    print("Hello from package!")
Python
복사

main.py

from mypackage import greetings

greetings.hello()
Python
복사

필요하면 상대 경로나 절대 경로 import도 예시로 보여줄 수 있어요. 더 추가할까요?

예시 코드

예 1: requests 패키지 사용 – 웹 페이지 요청

import requests

res = requests.get("https://example.com")
print(res.status_code)
print(res.text)
Python
복사

예 2: matplotlib 패키지 사용 – 그래프 그리기

import matplotlib.pyplot as plt

x = [1, 2, 3]
y = [10, 20, 30]
plt.plot(x, y)
plt.title("Sample Graph")
plt.show()
Python
복사

패키지 프로젝트 구조 예시

my_package/
├── __init__.py
├── module1.py
├── module2.py
└── subpackage/
    ├── __init__.py
    └── submodule.py
Markdown
복사

이런 구조일 때 사용 예시:

from my_package import module1
from my_package.subpackage import submodule
Python
복사

패키지 만들기 실습

패키지 이름의 폴더 생성

__init__.py 파일 생성

"패키지"로 인식하게 하는 특별한 파일

.py 모듈 파일 추가

__init__.py 에서 공개할 모듈 지정

패키지 가져와서 사용하기

패키지 이름의 폴더 생성

JSON 파일 데이터를 조회, 필터링, 저장

📦 jsonutils
Python
복사

init.py 파일 생성

"패키지"로 인식하게 하는 특별한 파일

📦 jsonutils
└── 📜 __init__.py
Python
복사

.py 모듈 파일 추가

📦 jsonutils/
├── 📜 __init__.py
├── 📦 io/
│   ├── 📜 __init__.py
│   └── 📜 json_loader.py
├── 📦 processing/
│   ├── 📜 __init__.py
│   └── 📜 filter.py
└── 📦 storage/
    ├── 📜 __init__.py
    └── 📜 json_saver.py
Markdown
복사

이런 구조로 폴더와 파일을 만들어보겠습니다:

•

 io: JSON 파일 읽기 관련 모듈

•

 processing: JSON 데이터 처리/필터링 관련 모듈

•

 storage: JSON 파일 저장 관련 모듈

import json
"""
    json 파일 읽기 
"""
def read_json(filepath):
    # 파일 열기
    with open(filepath, 'r', encoding='utf-8') as f:
        # JSON 파일 읽기
        return json.load(f)
Python
복사

'''
    리스트 필터링 함수
'''
def filter_by_field(data, field, value):
    # list 인스턴스가 아닐 때
    if not isinstance(data, list):
        # raise : 예외 강제 발생 키워드
        # ValueError : 적절한 값이 아닌 경우 발생하는 예외
        raise ValueError("리스트 형식이 아닙니다.")
    return [ item for item in data if item.get(field) == value ]
    
Python
복사

import json
'''
   JSON 데이터 저장 함수
'''
def save_json(data, filepath):
    # 쓰기 모드로 파일 열기
    with open(filepath, 'w', encoding='utf-8') as f:
        # data 를 JSON 형식으로 파일 저장
        # ensure_ascii : False 아스키 문자가 아닌 것도 그대로 저장
        # indent : 들여쓰기를 2칸으로 지정
        json.dump(data, f, ensure_ascii=False, indent=2)
Python
복사

init.py 에서 공개할 모듈 지정

from .io.json_loader import read_json
from .processing.filter import filter_by_field
from .storage.json_saver import save_json

__all__ = ['read_json', 'filter_by_field', 'save_json']
Python
복사

•

여기서는 read_json, filter_by_field, save_json만 외부에서 접근 가능하도록 설정합니다.

패키지 가져와서 사용하기

•

main.py

from jsonutils import read_json, filter_by_field, save_json

data = read_json('student.json')
filtered = filter_by_field(data, 'gender', 'female')
save_json(filtered, 'filtered.json')
Python
복사

init.py 파일이 비어 있어도 되나요?

•

네, 내용이 없어도 전혀 문제없고 아주 흔한 상황입니다.

•

단지 폴더가 패키지임을 명시하는 역할을 하며, 초기화 코드가 필요한 경우 그때 내용을 추가하면 됩니다.

상황	__init__.py 필요 여부	비고
일반 서브패키지로 만들고 싶을 때	권장 (필수 아님)	내용은 비워도 됨
네임스페이스 패키지 (PEP420)	없어도 동작 가능	복잡한 프로젝트나 라이브러리에서 활용

all

해당 패키지에서 공개적으로 제공할 이름들을 명시적으로 정의하는 리스트입니다.

__all__의 주요 목적은:

•

모듈 가져오기를 제어하여 코드의 명확성과 의도를 명시적으로 표현

•

불필요한 이름 공간 오염 방지 (필요한 것만 공개)

•

API 설계와 유지보수성 향상 (공개 인터페이스를 명확히 정의)

리소스 소모 측면에서는 큰 영향이 없습니다. Python은 실제로 모듈을 사용할 때만 메모리에 로드하기 때문입니다.

•

from package import * 를 실행할 때 어떤 모듈과 함수를 import 할지 제어합니다.

# mypackage/__init__.py
__all__ = ['module1', 'function1', 'function2']  # 이 항목들만 공개됨
Python
복사

•

__all__을 정의하지 않으면 모든 public 이름(언더스코어로 시작하지 않는 이름)이 import됩니다.

•

코드의 명확성과 안전성을 위해 __all__을 명시적으로 정의하는 것이 좋은 관행입니다.

예를 들어, 위 예제에서는 read_json, filter_by_field, save_json 함수만 외부에서 사용할 수 있도록 제한했습니다.

패키지

패키지 (package)

모듈 vs 패키지

패키지 설치

import

1. 패키지 전체 import

2. 모듈만 import

3. 함수 또는 클래스만 import

4. 하위 패키지 import

참고: __init__.py 역할

모듈 import 예시

패키지 import 예시

greetings.py

main.py

예시 코드

예 1: requests 패키지 사용 – 웹 페이지 요청

예 2: matplotlib 패키지 사용 – 그래프 그리기

패키지 프로젝트 구조 예시

패키지 만들기 실습

패키지 이름의 폴더 생성

__init__.py 파일 생성

.py 모듈 파일 추가

__init__.py 에서 공개할 모듈 지정

패키지 가져와서 사용하기

__init__.py 파일이 비어 있어도 되나요?

__all__

참고: init.py 역할

init.py 파일 생성

init.py 에서 공개할 모듈 지정

init.py 파일이 비어 있어도 되나요?

all