Глава 10. Файлы и CSV: чтение выгрузки и запись отчёта

Задача главы: прочитать реальную выгрузку из журнала как файл на диске и сохранить готовый отчёт отдельным файлом, не потеряв кириллицу и не перезаписав данные по ошибке.

10.1 Чтение текстового файла: `with open(..., encoding='utf-8')`

Зачем это нужно. До сих пор все данные жили прямо в коде — списки и словари, набранные руками. На практике выгрузка из системы или экспорт из таблицы приходит файлом на диске, и первый шаг любой обработки — открыть этот файл и прочитать его содержимое.

// PYTHON_EXECUTOR (Pyodide Wasm)

with open('journal.txt', encoding='utf-8') as file:   # открываем файл, кодировка — явно
  for line in file:            # файл читается построчно, как список строк
      print(line.strip())      # .strip() убирает символ конца строки '\n'

// Output:

Иванов Иван,78
Смирнова Ольга,92
Ким Юрий,50

open() возвращает объект файла, with — конструкция, которая гарантированно закроет файл после выхода из блока, даже если внутри случится ошибка. Явный encoding='utf-8' — не формальность: без него Python на разных системах может подставить свою кодировку по умолчанию (например, cp1251 на Windows), и тогда кириллица, сохранённая в utf-8 (стандарт большинства выгрузок), прочитается неправильно или не прочитается вовсе.

⚠️ Подводный камень

Первая ловушка — опечатка в имени файла или неверный путь.

// PYTHON_EXECUTOR (Pyodide Wasm)

with open('journal.tx', encoding='utf-8') as file:   # опечатка: 'journal.tx' вместо 'journal.txt'
  print(file.read())

// Output:

Traceback (most recent call last):
  File "report.py", line 1, in <module>
    with open('journal.tx', encoding='utf-8') as file:
FileNotFoundError: [Errno 2] No such file or directory: 'journal.tx'

Вторая ловушка — забытый encoding='utf-8' при чтении файла с кириллицей.

// PYTHON_EXECUTOR (Pyodide Wasm)

with open('journal.txt') as file:    # кодировка не указана явно
  print(file.read())

// Output:

Traceback (most recent call last):
  File "report.py", line 2, in <module>
    print(file.read())
UnicodeDecodeError: 'charmap' codec can't decode byte 0xd0 in position 0: character maps to <undefined>

Ошибка	Что значит для Python	Человеческий перевод
`FileNotFoundError`	«По этому пути файла нет»	Опечатка в имени файла или неверный путь — скрипт и файл-выгрузка должны лежать в одной папке, либо путь нужно указать полностью.
`UnicodeDecodeError`	«Байты файла не раскладываются в символы по выбранной кодировке»	Файл сохранён в `utf-8` (как большинство выгрузок), а Python без явного `encoding` подставил кодировку операционной системы. Кириллица в этих кодировках кодируется разными байтами.

Правильный паттерн

// PYTHON_EXECUTOR (Pyodide Wasm)

with open('journal.txt', encoding='utf-8') as file:   # путь верный, кодировка указана явно
  for line in file:
      print(line.strip())

// Output:

Пояснение логики: encoding='utf-8' в open() стоит указывать всегда, как только в файле есть кириллица, — это не зависит от того, на какой машине запускается скрипт. Путь к файлу проверяют так же внимательно, как имя переменной: опечатка в нём не подсвечивается заранее, а падает только в момент выполнения строки с open().

10.2 Разбор выгрузки: `csv.reader` и `csv.DictReader`

Зачем это нужно. Построчное чтение работает для простого текста, но настоящая выгрузка — это таблица: заголовок и строки с полями через запятую (CSV, comma-separated values). Резать такую строку руками через .split(',') рискованно — это ломается на текстовых полях, где запятая — часть значения, в кавычках. Модуль csv берёт разбор строк на себя.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('journal.csv', encoding='utf-8') as file:
  reader = csv.reader(file)      # каждая строка файла → список полей
  next(reader)                   # пропускаем строку заголовков
  for row in reader:
      student_name, score = row[0], row[1]
      print(f'{student_name}: {score}')

// Output:

Иванов Иван: 78
Смирнова Ольга: 92
Ким Юрий: 50

Удобнее обращаться к полям по имени, а не по номеру — для этого есть csv.DictReader: он сам читает первую строку как заголовки и отдаёт каждую следующую строку словарём.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('journal.csv', encoding='utf-8') as file:
  reader = csv.DictReader(file)      # заголовок читается автоматически
  for row in reader:
      print(f"{row['student_name']}: {row['score']}")   # доступ по имени колонки

// Output:

Иванов Иван: 78
Смирнова Ольга: 92
Ким Юрий: 50

⚠️ Подводный камень

Все значения, которые отдаёт csv, — строки, даже если выглядят как числа. Арифметика с ними падает.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('journal.csv', encoding='utf-8') as file:
  reader = csv.DictReader(file)
  total_score = 0
  for row in reader:
      total_score += row['score']    # row['score'] — строка, не число

// Output:

Traceback (most recent call last):
  File "report.py", line 6, in <module>
    total_score += row['score']
TypeError: unsupported operand type(s) for +=: 'int' and 'str'

Ошибка	Что значит для Python	Человеческий перевод
`TypeError`	«Нельзя сложить `int` и `str`»	Модуль `csv` всегда отдаёт значения строками — даже колонку с баллами. Это та же ловушка, что с `input()` в главе Переменные и ввод данных, только источник строк теперь файл, а не клавиатура. Перед арифметикой нужен `int()` или `float()`.

Правильный паттерн

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('journal.csv', encoding='utf-8') as file:
  reader = csv.DictReader(file)
  total_score = 0
  for row in reader:
      score = int(row['score'])    # приводим к числу один раз, сразу после чтения
      total_score += score
print(f'Сумма баллов: {total_score}')

// Output:

Сумма баллов: 220

Пояснение логики: строки к числам стоит приводить сразу при чтении строки, а не откладывать на потом — тогда в остальном коде score уже гарантированно число, и не приходится помнить в каждом месте, что где-то в переменной может прятаться строка.

10.3 Запись отчёта: режимы `'w'` и `'a'`, `csv.writer`, `newline=''`

Зачем это нужно. Результат расчётов нужно не только напечатать на экране, но и сохранить файлом — таким, который можно переслать коллеге или открыть в Excel. За это отвечает csv.writer: он сам расставляет запятые и кавычки там, где нужно.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

report_rows = [
  ['student_name', 'average_score'],
  ['Иванов Иван', '71.7'],
  ['Смирнова Ольга', '91.7'],
]

with open('report.csv', 'w', encoding='utf-8', newline='') as file:   # 'w' — режим записи
  writer = csv.writer(file)
  writer.writerows(report_rows)      # список строк целиком

// Output:

'w' (write) открывает файл для записи: если файла не было — создаёт, если был — начинает с чистого листа. 'a' (append) дописывает в конец существующего файла, не трогая то, что там уже есть. newline='' в open() — обязательный спутник csv.writer в этой книге, о нём — ниже.

⚠️ Подводный камень

Первая ловушка — режим 'w' не предупреждает, что в файле что-то было: если случайно открыть в нём отчёт прошлого запуска, старые данные исчезают без единого сообщения об ошибке.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

# Второй запуск скрипта в тот же день — отчёт за вчера в report.csv уже есть
new_report_rows = [['student_name', 'average_score'], ['Ким Юрий', '48.3']]

with open('report.csv', 'w', encoding='utf-8', newline='') as file:   # 'w' стирает всё, что было
  writer = csv.writer(file)
  writer.writerows(new_report_rows)
# файл report.csv теперь содержит только строку про Кима Юрия — вчерашние строки потеряны

// Output:

Traceback не появится — файл честно перезаписался, как и попросили.

Вторая ловушка — забытый newline='' при открытии файла для csv.writer: в файле появляются пустые строки между записями.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('report.csv', 'w', encoding='utf-8') as file:   # забыли newline=''
  writer = csv.writer(file)
  writer.writerow(['student_name', 'average_score'])
  writer.writerow(['Иванов Иван', '71.7'])

// Output:

student_name,average_score

Иванов Иван,71.7

Ошибка	Что значит для Python	Человеческий перевод
— (тихая ошибка)	«`'w'` — режим “начать с чистого листа”»	Открытие существующего файла с накопленными данными в режиме `'w'` стирает их безвозвратно и без предупреждения. Для дозаписи нужен режим `'a'`.
— (тихая ошибка)	«Без `newline=''` перевод строки добавляется дважды»	`csv.writer` сам ставит `\r\n` после каждой строки, а текстовый режим файла на некоторых системах ещё раз переводит `\n` в `\r\n` — в сумме между записями остаются пустые строки.

Правильный паттерн

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

with open('report.csv', 'w', encoding='utf-8', newline='') as file:   # newline='' — обязательно с csv
  writer = csv.writer(file)
  writer.writerow(['student_name', 'average_score'])
  writer.writerow(['Иванов Иван', '71.7'])

// Output:

student_name,average_score
Иванов Иван,71.7

Пояснение логики: newline='' в open() отдаёт управление переводом строк целиком модулю csv — он сам знает нужный формат. Выбор между 'w' и 'a' — вопрос смысла: новый отчёт на каждый запуск — 'w'; журнал, который должен копить историю всех запусков, — 'a' (и тогда заголовок пишут только один раз, при первом создании файла).

10.4 Мини-словарик ошибок десятой главы

Ошибка	Что значит для Python	Человеческий перевод
`FileNotFoundError`	«По этому пути файла нет»	Опечатка в имени файла, неверный путь или файл лежит в другой папке относительно скрипта.
`UnicodeDecodeError`	«Байты не раскладываются в символы по этой кодировке»	Файл сохранён в `utf-8`, а Python читал его без явного `encoding='utf-8'` и подставил кодировку операционной системы.
`TypeError` (арифметика со строкой)	«Нельзя сложить `int` и `str`»	Значения из `csv` — всегда строки, даже колонка с баллами. Перед арифметикой нужен `int()` или `float()`.
— (тихая ошибка)	«`'w'` — режим “начать с чистого листа”»	Открытие файла с накопленными данными в режиме `'w'` стирает их без предупреждения; для дозаписи нужен режим `'a'`.
— (тихая ошибка)	«Без `newline=''` перевод строки добавляется дважды»	Между записями `csv.writer` появляются пустые строки — файл всё ещё читается как CSV, но выглядит неаккуратно.

Мини-кейс: выгрузка `journal.csv` → расчёт средних → файл `report.csv`

Задача: прочитать выгрузку с результатами по предметам, сгруппировать баллы по ученику, посчитать средний балл и статус для каждого и сохранить получившийся отчёт отдельным файлом.

// PYTHON_EXECUTOR (Pyodide Wasm)

import csv

# 1. Сбор данных — сначала «создаём» выгрузку (в реальной работе такой файл уже придёт из системы)
raw_rows = [
  ['student_name', 'score'],
  ['Иванов Иван', '78'],
  ['Иванов Иван', '92'],
  ['Иванов Иван', '45'],
  ['Смирнова Ольга', '92'],
  ['Смирнова Ольга', '88'],
  ['Смирнова Ольга', '95'],
  ['Ким Юрий', '50'],
  ['Ким Юрий', '55'],
  ['Ким Юрий', '40'],
]
with open('journal.csv', 'w', encoding='utf-8', newline='') as file:
  csv.writer(file).writerows(raw_rows)

# читаем выгрузку и группируем баллы по ученику — приём из главы 05_Словари
scores_by_student = {}
with open('journal.csv', encoding='utf-8') as file:
  reader = csv.DictReader(file)
  for row in reader:
      student_name = row['student_name']
      score = int(row['score'])      # csv отдаёт строку — приводим к числу сразу
      scores_by_student.setdefault(student_name, []).append(score)

# 2. Расчёты — переиспользуем функции из главы 09_Функции
pass_threshold = 60

def calculate_average(scores):
  return sum(scores) / len(scores)

def get_status(average_score, pass_threshold=60):
  return 'зачёт' if average_score >= pass_threshold else 'незачёт'

report_rows = 'student_name', 'average_score', 'status'
for student_name, scores in scores_by_student.items():
  average_score = calculate_average(scores)
  status = get_status(average_score, pass_threshold)
  report_rows.append([student_name, f'{average_score:.1f}', status])

# 3. Вывод итогового отчёта
with open('report.csv', 'w', encoding='utf-8', newline='') as file:
  csv.writer(file).writerows(report_rows)

print('--- ОТЧЁТ СОХРАНЁН В report.csv ---')
for student_name, average_score, status in report_rows[1:]:
  print(f'{student_name}: средний балл {average_score} — {status}')

// Output:

--- ОТЧЁТ СОХРАНЁН В report.csv ---
Иванов Иван: средний балл 71.7 — зачёт
Смирнова Ольга: средний балл 91.7 — зачёт
Ким Юрий: средний балл 48.3 — незачёт

Что получилось: report.csv теперь лежит на диске рядом со скриптом и открывается в любой таблице — три колонки, без единой пустой строки между записями. setdefault() из главы Словари собрал плоскую выгрузку (одна строка — один предмет) в словарь списков, а calculate_average() и get_status() из главы Функции сработали без единой правки — ровно то, для чего их выносили в отдельные функции.

⚠️ Если в journal.csv окажется испорченная строка — пустое значение в колонке score или ученик без единой сдачи, — int() или calculate_average() уронят весь скрипт исключением, и отчёт не сохранится вовсе, даже для учеников с нормальными данными. Как перехватывать такие строки и не терять из-за них весь отчёт — тема главы Ошибки и исключения.

Чек-лист главы

Дальше: Ошибки и исключения

Глава 10. Файлы и CSV: чтение выгрузки и запись отчёта

10.1 Чтение текстового файла: with open(..., encoding='utf-8')

⚠️ Подводный камень

Правильный паттерн

10.2 Разбор выгрузки: csv.reader и csv.DictReader

⚠️ Подводный камень

Правильный паттерн

10.3 Запись отчёта: режимы 'w' и 'a', csv.writer, newline=''

⚠️ Подводный камень

Правильный паттерн

10.4 Мини-словарик ошибок десятой главы

Мини-кейс: выгрузка journal.csv → расчёт средних → файл report.csv

Чек-лист главы

10.1 Чтение текстового файла: `with open(..., encoding='utf-8')`

10.2 Разбор выгрузки: `csv.reader` и `csv.DictReader`

10.3 Запись отчёта: режимы `'w'` и `'a'`, `csv.writer`, `newline=''`

Мини-кейс: выгрузка `journal.csv` → расчёт средних → файл `report.csv`