13강. 파일 읽기·쓰기와 pathlib

?1. 이번 강의에서 해결할 문제

코드 안에 데이터를 직접 적으면 실제 파일을 분석할 수 없습니다. Windows 경로를 안전하게 조합하고 인코딩을 명시해 로그를 읽고 결과를 저장합니다.

✓2. 학습 목표

✓이 강의를 마치면

• Path로 플랫폼에 맞는 경로를 조합합니다.
• context manager로 파일을 안전하게 엽니다.
• UTF-8 텍스트를 읽고 출력 폴더를 만듭니다.

◇3. 핵심 개념

pathlib.Path는 경로 문자열보다 결합, 확장자, 존재 검사 의도가 명확합니다. with 블록은 정상·오류 종료 모두 파일을 닫습니다. 인코딩을 생략하면 환경별 기본값이 달라질 수 있어 utf-8을 명시합니다.

</>4. 단계별 코드 예시

파일 경로: C:\dev\game-log-analyzer\data\battles.txt

data/battles.txt

Knight|Slime|Slash|80|win
Mage|Dragon|Fireball|220|loss
Knight|Goblin|Slash|120|win

파일 경로: C:\dev\game-log-analyzer\main.py

main.py

from pathlib import Path

PROJECT_ROOT = Path(__file__).resolve().parent
input_path = PROJECT_ROOT / "data" / "battles.txt"
output_path = PROJECT_ROOT / "reports" / "summary.txt"

with input_path.open("r", encoding="utf-8") as file:
    lines = [line.strip() for line in file if line.strip()]

output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_text(
    f"전투 횟수: {len(lines)}\n",
    encoding="utf-8",
)
print(output_path)

PowerShell · 실행

New-Item -ItemType Directory -Force .\data
py -3.13 .\main.py
Get-Content .\reports\summary.txt

→5. 코드가 동작하는 이유

__file__ 기준 절대 경로를 사용하므로 실행 위치가 달라도 프로젝트 파일을 찾습니다. mkdir(parents=True, exist_ok=True)는 상위 폴더까지 만들고 이미 있어도 실패하지 않습니다. write_text는 파일을 쓰고 닫는 편의 메서드입니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• Windows 역슬래시 escape 문제: 직접 문자열 결합보다 Path / "폴더"를 사용합니다.
• 기존 파일을 의도치 않게 덮어씀: 쓰기 전 exists()를 확인하거나 출력 이름에 날짜를 포함합니다.
• 인코딩 생략: 한글 깨짐을 막도록 읽기·쓰기 모두 encoding="utf-8"을 씁니다.

✎7. 직접 실습

✎직접 실습

1. 샘플 로그를 만들고 빈 줄은 제외해 읽습니다.
2. 전체 피해량을 reports/summary.txt에 추가합니다.
3. 존재하지 않는 입력 경로에서 어떤 오류가 나는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Path(__file__).resolve().parent를 기준으로 삼는 이유는 무엇인가요?
2. with 블록이 파일 처리에 안전한 이유는 무엇인가요?
3. exist_ok=True는 어떤 상황의 오류를 막나요?

■9. 핵심 요약

■핵심 요약

Path로 입력과 출력 위치를 명확히 만들고 UTF-8과 안전한 파일 닫기를 적용합니다. 파일 경로도 프로그램 입력이므로 존재와 덮어쓰기 정책을 확인합니다.