Appearance
Какой формат данных выбрать
За шесть уроков у нас целая полка форматов: CSV, JSON, YAML, XML, INI/TOML и pickle. Форматов много — вопрос не «какой лучше», а какой нужен в этой задаче. Разберём каждый по его назначению и соберём правила выбора.
Сводная таблица
| Формат | Как выглядит | Библиотека | Типы | Вложенность | Когда выбирать |
|---|---|---|---|---|---|
| CSV | плоская таблица, запятые | csv (stdlib) | строки | нет | таблица для Excel и баз данных |
| JSON | {...}, кавычки | json (stdlib) | есть (нет set/datetime) | да | обмен между программами и сервисами |
| YAML | отступы и # | yaml (pip) | есть (без safe_ — осторожно) | да | конфиг и данные, которые читает человек |
| XML | теги <a>...</a> | xml.etree.ElementTree (stdlib) | строки + атрибуты | да | строгие схемы обмена, валидация |
| INI | [секция], key = value | configparser (stdlib) | строки | секции | простые настройки утилит |
| TOML | [секция], с типами | tomllib (stdlib, 3.11+) | есть | секции + списки | настройки приложения |
| pickle | бинарник | pickle (stdlib) | все Python-типы | да | «заморозка» собственных объектов |
Шесть вопросов выбора
Кто читает — человек или программа?
- Человек правит руками → CSV, YAML, INI, TOML.
- Только программа → JSON, pickle.
Данные плоские или вложенные?
- Таблица «столбцы × строки» → CSV.
- Вложенность → JSON/YAML/XML/pickle.
Данные уходят за пределы Python?
- Да, в другие сервисы/языки → JSON (стандарт), XML (если нужна строгая схема).
- Нет → можно pickle.
Нужны ли типы?
- Числа и булевы значения «как есть» → JSON, TOML, YAML, pickle.
- Не критичны → CSV, INI (всё строки, приводите сами).
Это данные приложения или его настройки?
- Настройки (пороги, пути, переключатели) → INI/TOML.
- Данные (книга, список) → CSV/JSON/YAML/pickle.
Файл придёт от стороннего человека?
- Да → только текстовые безопасные форматы: CSV, JSON, YAML (
safe_load), XML, INI, TOML. - Пickle — никогда. Чужой pickle может выполнить код.
- Да → только текстовые безопасные форматы: CSV, JSON, YAML (
Мини-проект: телефонная книга во всех форматах
Один и тот же словарь — семь файлов:
py
import csv
import json
import yaml
import xml.etree.ElementTree as ET
import configparser
import pickle
phone_book = {
'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'}
}
# 1) CSV — плоская таблица
with open('book.csv', 'w', newline='') as f:
writer = csv.DictWriter(f, fieldnames=['name', 'city', 'phone'])
writer.writeheader()
for name, info in phone_book.items():
writer.writerow({'name': name, **info})
# 2) JSON — вложенный словарь «как есть»
with open('book.json', 'w', encoding='utf-8') as f:
json.dump(phone_book, f, indent=2, ensure_ascii=False)
# 3) YAML — «человеческий JSON»
with open('book.yaml', 'w', encoding='utf-8') as f:
yaml.safe_dump(phone_book, f, allow_unicode=True, sort_keys=False)
# 4) XML — дерево с тегами
root = ET.Element('phone_book')
for name, info in phone_book.items():
friend = ET.SubElement(root, 'friend')
ET.SubElement(friend, 'name').text = name
ET.SubElement(friend, 'city').text = info['city']
ET.SubElement(friend, 'phone').text = info['phone']
ET.indent(root)
root.write('book.xml', encoding='utf-8')
# 5) INI — секции-друзья
config = configparser.ConfigParser()
for name, info in phone_book.items():
config[name] = dict(info)
with open('book.ini', 'w') as f:
config.write(f)
# 6) TOML — вручную (tomllib только читает)
with open('book.toml', 'w', encoding='utf-8') as f:
f.write('[Серёга]\n')
f.write('city = "Омск"\n')
f.write('phone = "+7 900 123-45-67"\n')
f.write('[Соня]\n')
f.write('city = "Москва"\n')
f.write('phone = "+7 911 234-56-78"\n')
# 7) pickle — заморозка
with open('book.pkl', 'wb') as f:
pickle.dump(phone_book, f)Один словарь — семь форматов. Каждый из них уместен в своей задаче; плох тот, кто использует один формат для всего.
Итог курса
- CSV — таблица для людей и Excel.
- JSON — стандарт обмена между программами.
- YAML — конфиг и данные, приятные человеку; всегда
safe_. - XML — строгие схемы обмена; громоздко, но валидируемо.
- INI/TOML — настройки приложения; в TOML есть типы.
- pickle — собственные объекты Python; никогда не для чужих файлов.
Формат — это договор между тем, кто пишет, и тем, кто читает. Поняли «кто читает» — выбрали формат правильно.
Упражнения
- Сохраните телефонную книгу Виты в CSV, JSON и YAML (одна программа, три файла). Прочитайте каждый файл обратно и напечатайте, равны ли все три восстановленных словаря исходной книге. Какой из трёх файлов самый короткий?
py
import csv
import json
import yaml
phone_book = {
'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}
# допишите код ниже- Для каждой ситуации из списка выберите формат и в комментарии в коде объясните выбор (1–2 предложения):
- таблица выручки, которую бухгалтер откроет в Excel;
- данные для JavaScript-сайта с сервера;
- настройки вашего приложения: путь к логам, лимиты,
debug = true; - сохранение собственного объекта класса
PhoneBookв кэш между запусками программы; - документ, который разработчики будут читать руками и править.
py
# допишите ответ ниже- Друг прислал файл
data.pkl, чтобы «посмотреть, кто в списке». Напишите в комментарии: откроете ли вы его черезpickle.load(), что попросите вместо него и почему. Ссылайтесь на правило безопасности из урока про pickle.
py
# допишите ответ ниже- Сохраните телефонную книгу в
book.jsonиbook.pkl. Напечатайте размер обоих файлов в байтах. В комментарии объясните, почему pickle-файл обычно короче, и какие ещё два отличия у этих форматов.
py
import json
import pickle
import os
phone_book = {
'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}
# допишите код ниже- Сделайте «карточку выбора»: создайте словарь, где ключи — форматы (
csv,json,yaml,xml,ini,toml,pickle), а значения — по одной фразе: «выбирай, когда...». Сохраните его вcard.jsonи прочитайте обратно.
py
import json
# допишите код ниже- Итог курса: напечатайте (в коде, строками) список всех модулей этого курса и их происхождение:
csv,json,tomllib,configparser,xml.etree.ElementTree,pickle— стандартная библиотека;yaml— сторонняя (черезpip). В комментарии ответьте: какие форматы можно читать на «чистой» Python без установки?
py
# допишите ответ ниже