파일

14. 파일#

열 명의 5미터 다이빙 경기의 점수를 저장한 텍스트 파일에서 필요한 정보를 추출하는 과정을 살펴본다. 파일의 내용은 다음과 같이 첫째 줄엔 ‘이름’과 ‘점수’라는 구분이 표시되어 있으며, 둘째 줄부터 총 열 명의 이름과 점수가 기록되어 있다. 이름과 점수는 공백space로 구분된다.

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

14.1. 파일의 종류와 경로#

텍스트 파일과 바이너리 파일

파일은 텍스트text 파일과 바이너리binary 파일 두 가지로 나뉜다.

바이너리 파일은 한컴 오피스의 한글 파일, MS 워드 파일과 파워포인트 파일, jpg, png, gif 등의 사진 파일 등 특정 소프트웨어를 사용해야만 내용을 확인할 수 있는 파일이다. 그리고 exe 확장자를 갖는 앱 설치 파일 등도 바이너리 파일이다.

반면에 텍스트 파일은 내용을 확인하기 위해 특별한 기능이 필요 없고 임의의 텍스트 편집기로 내용을 바로 확인할 수 있다. 예를 들어 파이썬 편집기로 열 수도 있다. 여기서는 텍스트 파일만을 대상으로 파일 다운로드, 열기, 수정하기 등을 살펴본다.

디렉토리와 폴더

디렉토리directory와 폴더folder는 동일한 개념이다. 다만 리눅스 계열 운영체제에서는 디렉토리를, 윈도우 운영체제에서는 폴더를 선호한다. 그리고 리눅스 계열 운영체제에서는 디렉토리를 파일이라고 부르기도 한다. 하지만 여기서는 디렉토리를 폴더 개념으로만 사용하며 파일과는 구분한다.

경로

경로는 특정 디렉토리 또는 파일의 위치를 나타내는 문자열이다. 사용하는 운영체제마다 표현 방법이 다르기에 조심해야 한다. 예를 들어 현재 파이썬 코드가 실행되는 디렉토리의 경로는 리눅스와 윈도우의 경우 다음과 같이 다르게 표현된다.

  • 리눅스의 경우: ‘/home/gslee/Documents/GitHub/pybook/jupyter-book’

  • 윈도우의 경우: ‘C:₩Users₩gslee₩Documents₩GitHub₩pybook₩jupyter-book’

하지만 pathlib 모듈의 Path 자료형을 이용하면 운영체제를 신경쓰지 않고 경로를 다룰 수 있다.

현재 작업 디렉토리

보통 cwd 라고 줄여서 사용되는 현재 작업 디렉토리current working directory는 현재 파이썬이 실행되는 디렉토리를 가리킨다. 현재 작업 디렉토리를 다음과 같이 확인할 수 있다.

import os

os.getcwd()

'/content'

절대경로와 상대경로

앞서 언급한 두 개의 경로는 운영체제의 맨 상위 디렉토리를 기준으로 하는 경로라는 의미에서 절대경로라 부른다. 반면에 상대경로는 현재 작업 디렉토리(cwd)를 기준으로 경로를 작성한다. 만약에 cwd가 Documents 라면, 위 두 개의 경로의 상대경로는 다음과 같다.

  • 리눅스의 경우: ‘GitHub/pybook/jupyter-book’

  • 윈도우의 경우: ‘GitHub₩pybook₩jupyter-book’

아래와 같이 사용할 수 있다. 점(.)이 현재 작업 디렉토리를 가리킨다.

  • 리눅스의 경우: ‘./GitHub/pybook/jupyter-book’

  • 윈도우의 경우: ‘.₩GitHub₩pybook₩jupyter-book’

14.2. 파일 준비#

먼저 위에서 언급된 파일을 다운 받아서 파이썬 코딩을 실습하는 디렉토리에 저장한다. 여기서는 data라는 하위디렉토리에 results5m.txt라는 파일로 저장한다.

pathlib.Path 클래스: 디렉토리 지정

파일을 저장할 디렉토리를 지정한다. 이를 위해 pathlib 모듈의 Path 클래스를 이용한다. Path 클래스는 지정된 디렉토리 또는 파일의 경로를 담은 객체를 생성한다.

  • Path() : 현재 작업 디렉토리를 나타내는 객체. Path('.') 과 동일한 의미임.

  • 슬래시 연산자 /: 두 개의 경로를 이어붙히는 연산자. 왼쪽 인자는 Path 객체, 둘째 인자는 문자열.

from pathlib import Path

data_path = Path() / "data"

Path 객체는 다양한 정보를 다루는 메서드와 속성을 제공한다. 예를 들어, 현재 작업 디렉토리(cwd)의 경로를 확인하려면 cwd() 메서드를 실행한다.

data_path.cwd()

PosixPath('/content')

name 속성은 경로가 가리키는 디렉토리 또는 파일 이름을 가리킨다.

data_path.name

'data'

parent 속성은 지정된 경로가 가리키는 디렉토리 또는 파일이 저장된 부모 디렉토리의 이름을 가리킨다. data_path 가 현재 디렉토리의 하위 디렉토리인 data를 가리키기에 그것의 부모 디렉토리인 현재 디렉토리를 가리키는 점('.') 이 저장된다.

data_path.parent

PosixPath('.')

Path.mkdir() 메서드: 디렉토리 생성

Path 객체의 mkdir() 메서드를 이용하여 지정된 경로에 해당하는 디렉토리를 실제 생성한다. 다음 두 개의 옵션 인자를 사용한다.

  • parent=True: 부모 디렉토리가 필요하면 생성할 것. 즉, 파일이 여러 개의 중첩된 폴더 안에 위치하는 경우 사용.

  • exist_ok = True: 디렉토리가 이미 존재하면 그대로 사용할 것. 지정된 디렉토리가 이미 존재하는데 False로 설정하면 오류 발생.

data_path.mkdir(parents=True, exist_ok=True)

urllib.request.urlretrieve() 함수: 파일 다운로드

인터넷에 존재하는 파일의 복사본을 지정된 이름으로 다운로드한다. 이를 위해 urllib.request 모듈의 urlretrieve() 함수를 이용한다.

  • 첫째 인자: 다운로드할 파일 주소

  • 둘째 인자: 저장할 디렉토리와 파일명으로 구성된 경로

  • 반환값: 저장된 파일의 경로와 다운로드에 사용된 HTTP 정보로 구성된 튜플. 파일 경로에 표시되는 PosixPath 또는 WindowsPath 는 각각 리눅스 계열 방식의 경로와 윈도우 방식의 경로를 가리키며 사용하는 운영체제에 따라 결정됨.

from urllib.request import urlretrieve

# 파일 서버 기본 주소
base_url = "https://raw.githubusercontent.com/codingalzi/pybook/master/jupyter-book/data/"
# 파일명
file_name_5m = "results5m.txt"
# 파일 주소 전체
file_url_5m = base_url + file_name_5m

# 저장위치와 저장 파일명
target_path_5m = data_path / "results5m.txt"

# 다운로드와 저장 실행
urlretrieve(file_url_5m, target_path_5m)

(PosixPath('data/results5m.txt'), <http.client.HTTPMessage at 0x78af56919d80>)

파일 다운로드 함수

앞으로 파일의 이름만 달리하면서 동일한 웹 사이트에서 여러 파일을 다운로드 할 것이다. 따라서 다운로드할 파일의 이름만 지정하면 지정된 경로에 동일한 이름으로 다운로드하여 저장하는 함수를 선언하는 것이 좋다.

아래 myWget() 함수의 인자는 다운로드할 파일명을 사용할 것이기에 위 코드에서 파일명을 제외한 나머지는 거의 동일하게 사용된다.

def myWget(filename):
    # 다운로드 대상 파일 경로
    file_url = base_url + filename

    # 저장위치 지정과 생성
    data_path = Path() / "data"
    data_path.mkdir(parents=True, exist_ok=True)

    # 저장 경로와 파일명
    target_path = data_path / filename

    return urlretrieve(file_url, target_path)

앞서의 긴 코드가 다음 한 줄 코드로 대체된다.

myWget("results5m.txt")

(PosixPath('data/results5m.txt'), <http.client.HTTPMessage at 0x78af5691ab00>)

open() 함수: 저장된 파일 불러오기

컴퓨터에 저장된 파일을 활용하려면 먼저 파일 객체로 불러와야 한다. 가장 기본적인 방식으로 open() 함수를 이용하여 불러온 파일 객체를 변수에 할당한다.

f = open(파일경로)

다운로드가 잘못 되었거나 다른 곳에 저장되어 있다면 오류가 발생한다. 따라서 코드의 안전할 실행을 위해 많은 경우 다음처럼 try-except 명령문을 이용하여 예외처리를 하기도 한다. FileNotFoundError 는 지정된 파일이 존재하지 않을 때 발생하는 오류를 가리킨다.

try:
    f = open(파일경로)
except FileNotFoundError:
    print("열고자 하는 파일이 존재하지 않습니다.")

하지만 여기서는 그냥 간단한 버전을 사용한다.

f = open(target_path_5m, encoding='utf-8')

위 코드에서 encoding='utf-8'은 한글, 스페인어 등 영어에서 사용하지 않는 특수 문자를 사용하는 언어로 작성된 문서를 불러올 때 사용한다.

파일 내용 확인

f 변수가 가리키는 값의 자료형은 _io.TextIOWrapper 라는 이름도 생소한 자료형이다.

type(f)

_io.TextIOWrapper

자료형은 전혀 중요하지 않다. 대신 파일에 저장된 내용을 확인하려면 아래와 같이 for 반복문을 사용해야 한다는 점은 기억해야 한다.

for line in f:                   # 한줄씩 내용 출력하기
    print(line)

이름  점수

권준기  7.13

김세윤  8.55

나진서  9.02

마동탁  8.35

서길석  7.86

이준용  8.17

이차승  9.33

차승연  7.11

표방호  8.57

한석준  8.93

불러온 파일 객체는 한 번만 사용할 수 있는 이터레이터다.

from collections.abc import Iterator

isinstance(f, Iterator)

True

for 반복문을 다시 실행하면 더 이상 보여주는 게 없다. 이유는 이터레이터의 내용을 모두 보여줬기 때문이다.

for line in f:
    print(line)

따라서 불러온 파일을 다 사용했으면 닫아 주어야 한다. 그렇지 않으면 파일에 의도치 않은 수정이 가해질 수 있다.

f.close()

with-as 키워드 활용

파일을 불러오고 할 일을 다하면 파일 닫기를 자동으로 처리하는 다음 방식으로 진행하는 것이 권장된다.

with open(target_path_5m) as f:
    for line in f:
        print(line)

이름  점수

권준기  7.13

김세윤  8.55

나진서  9.02

마동탁  8.35

서길석  7.86

이준용  8.17

이차승  9.33

차승연  7.11

표방호  8.57

한석준  8.93

줄 간격 조절

줄 간격이 넓은 이유는 파일을 작성하면서 줄바꾸기를 할 때 사용하는 엔터에 의해 줄바꾸기 기호(\n)가 각 줄의 맨 끝에 포함되어 있기 때문이다. print() 함수 자체가 출력할 때마다 기본적으로 줄바꿈을 수행하기에 이로 인해 결국 줄바꿈이 두 번 이뤄진다.

줄바꾸기를 한 번 더 하는 것을 방지하기 위해서 문자열 자료형의 strip() 메소드를 활용하여 문자열의 양 끝에 있는 공백과 줄바꿈 기호를 없앨 수도 있다. 그리고 mode='r' 옵션인자를 이용하여 읽기 모드임을 명시하는 게 좋다.

언급한 것을 모두 반영하여 파일을 불러오고 내용을 확인하는 코드는 다음과 같다.

with open(target_path_5m, mode='r') as f:
    for line in f:
        print(line.strip())

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

read(), readline(), readlines() 메서드

read() 메서드는 파일 내용을 전체를 하나의 문자열로 불러온다.

with open(target_path_5m, mode='r') as f:
    lines = f.read()

lines

'이름  점수\n권준기  7.13\n김세윤  8.55\n나진서  9.02\n마동탁  8.35\n서길석  7.86\n이준용  8.17\n이차승  9.33\n차승연  7.11\n표방호  8.57\n한석준  8.93'

print() 함수를 이용하면 줄바꿈 기호 등을 해석하여 보다 예쁘게 출력한다.

print(lines)

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

readline() 메서드는 한 줄씩 반환한다. 일종의 이터레이터의 __next__() 메서드와 유사하다.

with open(target_path_5m, mode='r') as f:
    for _ in range(11):
        print(f.readline().strip())

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

readlines() 메서드는 파일 내용 전체를 리스트로 반환한한다. 리스트의 각 항목은 한 줄씩 채워진다.

with open(target_path_5m, mode='r', encoding='utf-8') as f:
    lines = f.readlines()

lines

['이름  점수\n',
 '권준기  7.13\n',
 '김세윤  8.55\n',
 '나진서  9.02\n',
 '마동탁  8.35\n',
 '서길석  7.86\n',
 '이준용  8.17\n',
 '이차승  9.33\n',
 '차승연  7.11\n',
 '표방호  8.57\n',
 '한석준  8.93']

for line in lines:
    print(line.strip())

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

참고: Path.open() 메서드

Path 객체의 open() 메서드를 이용하여 파일을 열 수도 있다. 사용법은 기본적으로 동일하다. 실제로 Path 객체의 open() 메서드를 호출하면 open() 함수가 실행된다.

with target_path_5m.open(mode='r', encoding='utf-8') as f:
    for line in f:
        print(line.strip())

이름  점수
권준기  7.13
김세윤  8.55
나진서  9.02
마동탁  8.35
서길석  7.86
이준용  8.17
이차승  9.33
차승연  7.11
표방호  8.57
한석준  8.93

예제

선수들의 5미터 다이빙 점수를 기준으로 등수를 확인해보자. 먼저 선수 이름과 점수 사이의 관계를 담은 정보를 사전으로 선언한다.

# 5m 다이빙 점수 저장.
# 키: 선수 이름
# 값: 점수

scores_5m = {}

with open(target_path_5m, mode='r') as f:
    for line in f:
        name, s_5m = line.strip().split()  # 리스트 해체 활용

        try:
            scores_5m[name] = float(s_5m)
        except:
            continue

모든 선수의 5미터 다이빙 점수는 다음과 같다.

scores_5m

{'권준기': 7.13,
 '김세윤': 8.55,
 '나진서': 9.02,
 '마동탁': 8.35,
 '서길석': 7.86,
 '이준용': 8.17,
 '이차승': 9.33,
 '차승연': 7.11,
 '표방호': 8.57,
 '한석준': 8.93}

이제 점수 기준으로 사전을 정렬해보자. 그런데 사전 자체는 정렬 기능을 제공하지 않는다. 반면에 items() 메서드의 반환값에 대해 sorted() 함수를 적용한 결과를 응용할 수는 있다. key 키워드 인자를 이용해서 아이텀의 둘째 인자인 점수를 기준으로 정렬하려면 다음과 같이 정의된 람다 함수를 지정한다.

sorted_scores_5m = sorted(scores_5m.items(), key = lambda item: item[1], reverse=True)
sorted_scores_5m

[('이차승', 9.33),
 ('나진서', 9.02),
 ('한석준', 8.93),
 ('표방호', 8.57),
 ('김세윤', 8.55),
 ('마동탁', 8.35),
 ('이준용', 8.17),
 ('서길석', 7.86),
 ('권준기', 7.13),
 ('차승연', 7.11)]

5미터 다이빙 경기 결과는 다음과 같다.

print("5미터 다이빙 경기 결과\n")

count = 1
for item in sorted_scores_5m:
    print(f"{count:>3}등: {item[0]} {item[1]}")
    count += 1

5미터 다이빙 경기 결과

  1등: 이차승 9.33
  2등: 나진서 9.02
  3등: 한석준 8.93
  4등: 표방호 8.57
  5등: 김세윤 8.55
  6등: 마동탁 8.35
  7등: 이준용 8.17
  8등: 서길석 7.86
  9등: 권준기 7.13
 10등: 차승연 7.11

14.3. 텍스트 파일 생성#

mode 옵션 인자

파일을 열 때 기본적으로 읽기 모드로 열린다. 그러면 파일 내용을 읽을 수는 있지만 수정, 추가 등은 불가능하다. 수정 및 추가 등을 지원하려면 다른 모드를 지정하고 파일을 열어야 한다. 지원되는 모드는 다음과 같다.

모드 옵션

기능

‘r’

파일 처음부터 읽기

‘r+’

기존 파일 처음부터 읽기 및 쓰기. 기존 파일 없으면 오류 발생

‘w’

새 파일 생성 후 쓰기 또는 기존 파일 내용 삭제 후 새로 쓰기

‘w+’

새 파일 생성 후 쓰기 및 읽기. 기존 파일 내용 삭제 후 새로 쓰기 및 읽기

‘a’

기존 파일 끝에 추가하기. 기존 파일 없으면 새로 생성

‘a+’

기존 파일 끝에 추가와 읽기. 기존 파일 없으면 새로 생성

여기서는 쓰기 모드 활용법을 간단하게 살펴 본다. 설명을 위해 10명 선수들의 5미터 다이빙 기록 이외에 아래 10미터 다이빙 기록이 담긴 results10m.txt 파일을 추가로 활용한다.

이름  점수
권준기  9.11
김세윤  8.35
나진서  7.12
마동탁  8.65
서길석  9.31
이준용  8.71
이차승  7.33
차승연  9.11
표방호  8.75
한석준  8.39

이제 아래 방식으로 5미터 기록과 10미터 기록을 함께 담은 diving_results.txt 파일을 생성해보자.

이름  5m점수  10m점수
권준기  7.13  9.11
김세윤  8.55  8.35
나진서  9.02  7.12
마동탁  8.35  8.65
서길석  7.86  9.31
이준용  8.17  8.71
이차승  9.33  7.33
차승연  7.11  9.11
표방호  8.57  8.75
한석준  8.93  8.39

먼저 results10m.txt 파일을 results5m.txt 와 동일한 방식으로 다운로드하여 저장한다.

myWget("results10m.txt")

(PosixPath('data/results10m.txt'), <http.client.HTTPMessage at 0x78af56918f40>)

diving_results.txt 텍스트 파일에 채울 내용을 준비하자. 그러기 위해 파일로부터 이름과 점수를 키와 값으로 사용하는 사전을 생성한다. 이를 위해 파일을 불러오기 위해 open() 함수 또는 Path 객체의 메서드 둘 다 이용할 수 있다.

with target_path_5m.open() as f:
    results_5m_dict = {}
    for line in f:
        name, score = line.strip().split()
        if score != '점수':
            results_5m_dict[name] = score

results_5m_dict

{'권준기': '7.13',
 '김세윤': '8.55',
 '나진서': '9.02',
 '마동탁': '8.35',
 '서길석': '7.86',
 '이준용': '8.17',
 '이차승': '9.33',
 '차승연': '7.11',
 '표방호': '8.57',
 '한석준': '8.93'}

target_path_10m = data_path / "results10m.txt"

with open(target_path_10m) as f:
    results_10m_dict = {}
    for line in f:
        name, score = line.strip().split()
        if score != '점수':
            results_10m_dict[name] = score

results_10m_dict

{'권준기': '9.11',
 '김세윤': '8.35',
 '나진서': '7.12',
 '마동탁': '8.65',
 '서길석': '9.31',
 '이준용': '8.71',
 '이차승': '7.33',
 '차승연': '9.11',
 '표방호': '8.75',
 '한석준': '8.39'}

두 개의 점수로 이루어진 튜플을 값으로 사용하는 사전을 생성한다.

diving_results_dict = {}

for name in results_5m_dict:
    score_5m = results_5m_dict[name]
    score_10m = results_10m_dict[name]
    diving_results_dict[name] = (score_5m, score_10m)

diving_results_dict

{'권준기': ('7.13', '9.11'),
 '김세윤': ('8.55', '8.35'),
 '나진서': ('9.02', '7.12'),
 '마동탁': ('8.35', '8.65'),
 '서길석': ('7.86', '9.31'),
 '이준용': ('8.17', '8.71'),
 '이차승': ('9.33', '7.33'),
 '차승연': ('7.11', '9.11'),
 '표방호': ('8.57', '8.75'),
 '한석준': ('8.93', '8.39')}

write() 메서드

이제 diving_results.txt 텍스트 파일을 생성할 수 있다. 이를 위해 open() 함수를 'w' 모드로 연 다음에 앞서 생성된 사전의 키와 값을 적적히 조합하여 파일에 한 줄씩 추가한다. 파일에 한 줄을 추가하는 기능은 write() 메서드를 이용한다.

with open(data_path / "diving_results.txt", "w") as f:
    f.write("이름  5m점수  10m점수\n")
    for key, scores in diving_results_dict.items():
        score1, score2 = scores
        line = key + "  " + score1 + "  " + score2 + "\n"
        f.write(line)

with open("data/diving_results.txt", 'r') as f:
    for line in f:
        print(line.strip())

이름  5m점수  10m점수
권준기  7.13  9.11
김세윤  8.55  8.35
나진서  9.02  7.12
마동탁  8.35  8.65
서길석  7.86  9.31
이준용  8.17  8.71
이차승  9.33  7.33
차승연  7.11  9.11
표방호  8.57  8.75
한석준  8.93  8.39

14.4. 필수 예제#

참고: (필수 예제) 파일

14.5. 연습문제#

참고: (실습) 파일

Contents