HOWTO · Python
Python에서 print() 출력을 파일로 리디렉션하는 방법
이 자습서에서는 Python에서 인쇄 출력을 파일로 리디렉션하는 방법을 보여줍니다.
이 페이지의 내용
Python에서 텍스트를 파일에 저장하려면 open()으로 파일을 열고 반환된 파일 객체를 통해 씁니다. 모드 "w"는 파일을 만들거나 기존 내용을 덮어쓰고, "a"는 파일 끝에 내용을 추가합니다. with 문이 끝나면 파일이 닫힙니다.
이 예제는 report.txt에 메시지를 쓴 다음 저장된 텍스트를 표시합니다:
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "report.txt"
with path.open("w", encoding="utf-8") as file:
file.write("Monthly report\nRevenue: 1200\n")
print(f"Saved to {path.name}:")
print(path.read_text(encoding="utf-8"), end="")
Saved to report.txt:
Monthly report
Revenue: 1200
아래 예제에서는 write(), print(), 표준 출력 리디렉션, writelines() 또는 pathlib 경로 인터페이스를 언제 사용하면 좋은지 살펴봅니다. 대부분의 예제는 with 문으로 파일을 자동으로 닫습니다. sys.stdout 예제에서는 이전 스트림을 복원하고 파일을 명시적으로 닫습니다.
open()과 write()로 텍스트 쓰기
open()은 파일을 여는 방식을 선택하고, write()는 반환된 파일 객체의 메서드입니다. 모드 "w"는 파일을 만들거나 기존 내용을 덮어씁니다. 모드 "a"는 파일이 없으면 만들고 끝에 텍스트를 추가합니다. 이는 파일을 열 때 지정하는 모드이며 write()의 작업이 아닙니다.
write()는 문자열을 받아 쓰며 줄바꿈을 자동으로 추가하지 않습니다. 새 줄이 필요한 위치에 \n을 포함하세요. 반환값은 기록한 문자의 수입니다.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "notes.txt"
with path.open("w", encoding="utf-8") as file:
file.write("First line\n")
file.write("Second line\n")
print(path.read_text(encoding="utf-8"), end="")
First line
Second line
내용을 추가하려면 모드를 "a"로 바꾸세요. 예를 들어 with open("notes.txt", "a", encoding="utf-8") as file: file.write("Next entry\n")는 기존 내용 뒤에 한 줄을 추가합니다. 다른 경로를 지정하지 않으면 프로그램의 현재 작업 디렉터리를 기준으로 파일 경로가 결정됩니다.
print()로 파일에 출력하기
print(..., file=file_object)를 사용하면 print()의 익숙한 서식 지정 동작을 그대로 활용하면서 출력을 파일에 기록할 수 있습니다. 객체를 텍스트로 변환하고, 기본적으로 여러 값을 공백으로 구분하며, 끝에 줄바꿈을 추가합니다. sep와 end를 사용하면 이 동작을 바꿀 수 있습니다.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "summary.txt"
with path.open("w", encoding="utf-8") as file:
print("Count:", 3, file=file)
print("Ready:", True, file=file)
print(path.read_text(encoding="utf-8"), end="")
Count: 3
Ready: True
출력이 끝나면 with 블록이 파일을 닫습니다. 블록 안에서 close()를 호출할 필요는 없습니다. 블록이 끝날 때 Python이 파일을 닫습니다.
sys.stdout으로 표준 출력 리디렉션하기
sys.stdout은 file 인수를 지정하지 않았을 때 print()가 사용하는 스트림입니다. 파일을 sys.stdout에 할당하면 프로세스의 표준 출력이 해당 파일로 리디렉션됩니다. 따라서 이전 스트림을 저장해 복원하고 파일을 닫아야 합니다. 일상적인 범위 지정 리디렉션에는 다음 섹션의 contextlib.redirect_stdout()를 사용하는 편이 좋습니다. sys.stdout 참고 자료도 확인하세요. 이 참고 자료는 영어로만 제공되며 한국어 대상 페이지는 없습니다.
import sys
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "log.txt"
previous_stdout = sys.stdout
file = path.open("w", encoding="utf-8")
try:
sys.stdout = file
print("Job complete")
finally:
sys.stdout = previous_stdout
file.close()
print(path.read_text(encoding="utf-8"), end="")
Job complete
finally에서 원래 스트림을 복원하면 리디렉션된 블록의 코드에서 오류가 발생하더라도 이후 출력이 이전 대상으로 보내집니다. 바깥쪽 with는 임시 디렉터리를 관리합니다. 파일 자체는 sys.stdout을 복원한 뒤 명시적으로 닫습니다.
contextlib.redirect_stdout()으로 출력을 일시적으로 리디렉션하기
contextlib.redirect_stdout()은 with 블록 안에서 sys.stdout이 파일과 유사한 객체를 가리키도록 잠시 변경합니다. 블록이 끝나면 이전 표준 출력 스트림이 복원됩니다. 파일은 별도의 with 문으로 관리됩니다.
import contextlib
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "output.txt"
with path.open("w", encoding="utf-8") as file:
with contextlib.redirect_stdout(file):
print("Build finished")
print(path.read_text(encoding="utf-8"), end="")
Build finished
이 방법은 해당 컨텍스트 안에서 실행된 print() 호출과 표준 출력에 기록되는 다른 내용도 캡처합니다. 표준 오류(sys.stderr)는 리디렉션하지 않습니다.
writelines()로 문자열 시퀀스 쓰기
writelines()는 반복 가능한 객체의 각 문자열을 순서대로 파일에 씁니다. 줄바꿈을 삽입하지 않으므로 파일에 각 문자열을 별도 줄로 저장하려면 문자열에 \n을 포함하세요.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "items.txt"
lines = ["apples\n", "pears\n", "plums\n"]
with path.open("w", encoding="utf-8") as file:
file.writelines(lines)
print(path.read_text(encoding="utf-8"), end="")
apples
pears
plums
텍스트 파일에 쓰려면 요소가 문자열이어야 합니다. 줄바꿈이 필요하지 않다면 각 문자열에서 \n을 빼세요.
pathlib으로 파일 열고 쓰기
pathlib은 파일 시스템 경로를 만들고 다루기 위한 객체를 제공합니다. 파일 객체를 대체하는 것은 아닙니다. Path.open()으로 파일 객체를 얻은 다음 해당 객체의 write() 메서드를 호출하세요. 폴더나 다른 경로 구성 요소를 조합해 경로를 만들 때 유용합니다.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "archive" / "entry.txt"
path.parent.mkdir()
with path.open("w", encoding="utf-8") as file:
file.write("Stored with pathlib.\n")
print(path.read_text(encoding="utf-8"), end="")
Stored with pathlib.
파일 객체를 직접 관리할 필요 없이 텍스트를 간단히 한 번에 쓰려면 Path.write_text()를 사용하세요. 여러 번 쓰거나 writelines() 같은 메서드를 사용하려면 Path.open()으로 파일 객체를 얻을 수 있습니다.
반대 작업이 필요하다면 Python에서 파일을 문자열로 읽는 방법을 참고하세요.