HOWTO · Python

Python에서 gzip 파일 읽기

이 튜토리얼은 파일 압축의 중요성을 강조하고 Python에서 gzip을 사용하여 압축 및 압축 해제하는 방법을 보여줍니다.

이 페이지의 내용

Python 표준 라이브러리의 gzip 모듈을 사용하면 먼저 압축을 풀지 않고도 .gz 파일을 읽을 수 있습니다. gzip.open()을 바이너리 모드로 열면 바이트를, 인코딩을 명시해 텍스트 모드로 열면 문자열을 얻습니다. 아래 예제에서는 gzip 파일을 만들고, 데이터를 추가하고, 압축을 푸는 방법도 보여 줍니다.

Python에서 gzip 파일 읽기

gzip 파일은 gzip 형식으로 압축된 데이터를 저장합니다. gzip.open()은 파일과 유사한 객체를 통해 내용을 제공하므로, 데이터를 한 번에 모두 읽거나 한 줄씩 처리할 수 있습니다. 다음 예제는 작은 gzip 파일을 만든 다음 UTF-8 텍스트로 읽습니다. 같은 프로그램에서 입력 파일도 만들기 때문에 예제를 그대로 실행할 수 있습니다.

이 예제를 실행하세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import gzip
import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as directory:
    path = Path(directory) / "notes.txt.gz"
    with gzip.open(path, "wt", encoding="utf-8") as compressed:
        compressed.write("Python makes gzip files easy to read.\n")

    with gzip.open(path, "rt", encoding="utf-8") as compressed:
        print(compressed.read(), end="")

바이너리 모드와 텍스트 모드 선택

압축된 내용이 이미지나 다른 바이너리 형식처럼 바이트 데이터라면 rb를 사용하세요. 바이너리 gzip 스트림을 반복하면 각 항목이 바이트 문자열로 반환됩니다. 내용이 텍스트라면 rt를 사용하고 문자 인코딩을 명시하세요. 그러면 Python이 바이트를 일관된 방식으로 디코딩합니다. gzip.open()에서 바이트를 쓸 때는 wb, 텍스트를 쓸 때는 wt를 사용합니다. 텍스트 스트림은 문자열을, 바이너리 스트림은 바이트를 받습니다.

큰 텍스트 파일은 전체 내용을 메모리에 읽어들이는 대신 텍스트 스트림을 반복해 처리하세요. 예를 들어 for line in compressed:처럼 쓸 수 있습니다. 컨텍스트 관리자를 사용하면 처리를 일찍 중단해도 gzip 스트림이 닫힙니다. 적절한 데이터는 압축으로 저장 공간과 전송량을 줄일 수 있지만, 압축과 압축 해제에는 CPU 시간이 듭니다. 절감되는 양은 데이터에 따라 다릅니다.

Python에서 gzip 파일 쓰기

텍스트를 쓰려면 대상 파일을 wt로, 바이트를 쓰려면 wb로 여세요. w 모드는 새 gzip 스트림을 만들며 대상 파일이 이미 있으면 내용을 덮어씁니다. 다음 예제는 원본 텍스트와 압축된 출력 파일을 모두 만든 뒤, 기록한 내용을 다시 읽어 쓸 수 있는 파일인지 확인합니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import gzip
import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as directory:
    path = Path(directory) / "report.txt.gz"
    with gzip.open(path, "wt", encoding="utf-8") as compressed:
        compressed.write("Daily report\n")
    with gzip.open(path, "rt", encoding="utf-8") as compressed:
        print(compressed.read(), end="")

gzip 파일에 데이터 추가

텍스트를 추가하려면 at, 바이트를 추가하려면 ab를 사용하세요. 기존 내용을 보존해야 한다면 wb를 사용하지 마세요. 쓰기 모드는 새 gzip 스트림을 시작합니다. 추가 작업은 파일에 gzip 멤버를 하나 더 만들 수 있으며, gzip 리더는 연결된 멤버들을 하나의 논리적인 스트림처럼 읽을 수 있습니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import gzip
import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as directory:
    path = Path(directory) / "log.txt.gz"
    with gzip.open(path, "wt", encoding="utf-8") as compressed:
        compressed.write("first entry\n")
    with gzip.open(path, "at", encoding="utf-8") as compressed:
        compressed.write("second entry\n")
    with gzip.open(path, "rt", encoding="utf-8") as compressed:
        print(compressed.read(), end="")

Python에서 gzip 파일 압축 해제

일반 압축 해제 파일을 만들려면 gzip 원본을 읽기 모드로, 대상 파일을 쓰기 모드로 연 다음 원본에서 대상으로 복사하세요. 순서가 중요합니다. gzip 스트림이 입력이고 일반 파일이 출력입니다. 바이너리 모드는 텍스트와 비텍스트 내용 모두에 사용할 수 있으며 바이트를 디코딩하거나 변경하지 않습니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import gzip
import shutil
import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as directory:
    source = Path(directory) / "archive.txt.gz"
    destination = Path(directory) / "archive.txt"
    with gzip.open(source, "wb") as compressed:
        compressed.write(b"Recovered contents\n")
    with gzip.open(source, "rb") as compressed:
        with destination.open("wb") as output:
            shutil.copyfileobj(compressed, output)
    print(destination.read_text(encoding="utf-8"), end="")

디코딩된 문자열이 필요하고 파일의 인코딩을 알고 있다면 텍스트 모드를 선택하세요. 원본 바이트가 필요하거나 비텍스트 데이터를 처리한다면 바이너리 모드를 선택하세요. 압축 파일을 새로 만들 때는 wt 또는 wb, 데이터를 추가할 때는 at 또는 ab를 사용합니다. 내용을 일반 파일로 풀 때는 gzip 파일을 읽으세요.