Skip to content

Файл CSV: таблица в файле ​

Телефонная книга Виты живёт в памяти: программа закончилась — словарь исчез. Чтобы данные пережили перезапуск, их пишут в файл. Самый простой формат для табличных данных — CSV (Comma Separated Values, «значения, разделённые запятыми»).

Как выглядит CSV ​

Обычный текстовый файл: каждая строка файла — строка таблицы, столбцы внутри строки разделены запятой. Первая строка — заголовки:

Таблица:

Programming languageDesigned byAppearedExtension
PythonGuido van Rossum1991.py
JavaJames Gosling1995.java
C++Bjarne Stroustrup1983.cpp

Тот же файл data.csv:

csv
Programming language,Designed by,Appeared,Extension
Python,Guido van Rossum,1991,.py
Java,James Gosling,1995,.java
C++,Bjarne Stroustrup,1983,.cpp

CSV компактен и универсален: открывается в Excel и открывается в любой базе данных.

Чтение: csv.reader ​

Модуль csv встроен в Python. csv.reader() принимает открытый файл и возвращает строки по одной; каждая строка — список строк:

py
import csv

with open('data.csv', newline='') as file_csv:
    for row in csv.reader(file_csv):
        print(row)
['Programming language', 'Designed by', 'Appeared', 'Extension']
['Python', 'Guido van Rossum', '1991', '.py']
['Java', 'James Gosling', '1995', '.java']
['C++', 'Bjarne Stroustrup', '1983', '.cpp']

Заметьте: 1991 — строка, а не число. CSV не хранит типы, только текст.

Чтение: DictReader ​

Список с позициями неудобен. csv.DictReader() читает первую строку как ключи, и каждая следующая строка приходит словарём:

py
import csv

with open('data.csv', newline='') as file_csv:
    for row in csv.DictReader(file_csv):
        print(row['Programming language'], row['Appeared'])
Python 1991
Java 1995
C++ 1983

Словарём проще работать, чем позициями — поэтому DictReader/DictWriter — основной инструмент.

Запись: csv.writer и DictWriter ​

Запись — зеркальное действие. csv.writer пишет списки, csv.DictWriter — словари (ключи задаёт параметр fieldnames):

py
import csv

rows = [
    ['name', 'city', 'phone'],
    ['Серёга', 'Омск', '+7 900 123-45-67'],
    ['Соня', 'Москва', '+7 911 234-56-78']
]

with open('friends.csv', 'w', newline='') as f:
    writer = csv.writer(f)
    writer.writerows(rows)

Тем же через DictWriter (обязательные fieldnames и явная запись заголовка):

py
import csv

fieldnames = ['name', 'city', 'phone']
rows = [
    {'name': 'Серёга', 'city': 'Омск', 'phone': '+7 900 123-45-67'},
    {'name': 'Соня', 'city': 'Москва', 'phone': '+7 911 234-56-78'}
]

with open('friends.csv', 'w', newline='') as f:
    writer = csv.DictWriter(f, fieldnames=fieldnames)
    writer.writeheader()
    writer.writerows(rows)

Телефонная книга в CSV ​

Книга Виты — вложенный словарь:

py
phone_book = {
    'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
    'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
    'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}

Таблица хранит только плоские строки — вложенность придётся развернуть: имя друга становится заголовком-ключом, а его город и телефон — колонками:

py
import csv

fieldnames = ['name', 'city', 'phone']

with open('phone_book.csv', 'w', newline='') as f:
    writer = csv.DictWriter(f, fieldnames=fieldnames)
    writer.writeheader()
    for name, info in phone_book.items():
        writer.writerow({'name': name, **info})

Результат — phone_book.csv:

csv
name,city,phone
Серёга,Омск,+7 900 123-45-67
Соня,Москва,+7 911 234-56-78
Дима,Челябинск,+7 922 345-67-89

Плюсы и минусы ​

Плюсы:

  • обычный текст — читается и правится в любом редакторе;
  • открывается в Excel и импортится в базы данных;
  • формат простой, его понимает почти каждое приложение;
  • модуль csv — в стандартной библиотеке.

Минусы:

  • нет вложенности — только плоская таблица (книгу пришлось развернуть);
  • нет типов — всё строки: 1991 надо самим превращать в число;
  • заголовки не обязательны, но без них данные почти бесполезны;
  • значение с запятой внутри ('Джон, Боб') требует кавычек — модуль csv обрабатывает это сам, но наивно собранный файл сломается.

Итог ​

CSV — плоская таблица. Хорош, когда данные «табличные» и их кто-то откроет в Excel. Но телефонная книга — вложенная структура: как только данные не умещаются в таблицу, CSV упирается в потолок. Дальше — формат, который выглядит как словарь Python: JSON.


Упражнения ​

  1. Создайте файл data.csv (сохраните вручную, в редакторе) с содержимым:
csv
Programming language,Designed by,Appeared,Extension
Python,Guido van Rossum,1991,.py
Java,James Gosling,1995,.java
C++,Bjarne Stroustrup,1983,.cpp

Напишите программу, которая читает его через csv.reader() и печатает каждую строку. Ответьте в комментарии: почему 1991 — это строка, а не число?

py
import csv
# допишите код ниже
  1. Прочитайте тот же файл через csv.DictReader() и для каждой строки напечатайте название языка и год появления. Какую строку-заголовок DictReader «съедает» сам?
py
import csv
# допишите код ниже
  1. Напишите программу, которая через csv.DictWriter() создаёт файл friends.csv с тремя друзьями Виты (Серёга/Омск, Соня/Москва, Дима/Челябинск) и телефонами вида +7 900 123-45-67. Заголовки: name, city, phone.
py
import csv
# допишите код ниже
  1. В файле data.csv годы записаны сокращённо (91, 95, 83). Напишите программу:
  • читает data.csv через csv.DictReader();
  • дописывает столбец: превращает 91 → 1991, 95 → 1995, 83 → 1983;
  • переводит названия языков в верхний регистр;
  • добавляет строки JavaScript, Brendan Eich, 1995, .js и C#, Microsoft, 2000, .cs;
  • печатает результат и записывает его в data_change.csv через csv.DictWriter().
py
import csv
# допишите код ниже
  1. Сохраните телефонную книгу Виты (вложенный словарь phone_book) в файл phone_book.csv: разверните её в плоскую таблицу со столбцами name, city, phone.
py
import csv

phone_book = {
    'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
    'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
    'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}
# допишите код ниже
  1. Сделайте обратное: прочитайте phone_book.csv и соберите из плоской таблицы исходный вложенный словарь {имя: {'city': ..., 'phone': ...}}. Проверьте: совпадает ли результат с исходным phone_book?
py
import csv

phone_book = {
    'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
    'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
    'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}
# допишите код ниже