Skip to content

Какой формат данных выбрать ​

За шесть уроков у нас целая полка форматов: 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 = valueconfigparser (stdlib)строкисекциипростые настройки утилит
TOML[секция], с типамиtomllib (stdlib, 3.11+)естьсекции + спискинастройки приложения
pickleбинарникpickle (stdlib)все Python-типыда«заморозка» собственных объектов

Шесть вопросов выбора ​

  1. Кто читает — человек или программа?

    • Человек правит руками → CSV, YAML, INI, TOML.
    • Только программа → JSON, pickle.
  2. Данные плоские или вложенные?

    • Таблица «столбцы × строки» → CSV.
    • Вложенность → JSON/YAML/XML/pickle.
  3. Данные уходят за пределы Python?

    • Да, в другие сервисы/языки → JSON (стандарт), XML (если нужна строгая схема).
    • Нет → можно pickle.
  4. Нужны ли типы?

    • Числа и булевы значения «как есть» → JSON, TOML, YAML, pickle.
    • Не критичны → CSV, INI (всё строки, приводите сами).
  5. Это данные приложения или его настройки?

    • Настройки (пороги, пути, переключатели) → INI/TOML.
    • Данные (книга, список) → CSV/JSON/YAML/pickle.
  6. Файл придёт от стороннего человека?

    • Да → только текстовые безопасные форматы: CSV, JSON, YAML (safe_load), XML, INI, TOML.
    • Пickle — никогда. Чужой pickle может выполнить код.

Мини-проект: телефонная книга во всех форматах ​

Один и тот же словарь — семь файлов:

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; никогда не для чужих файлов.

Формат — это договор между тем, кто пишет, и тем, кто читает. Поняли «кто читает» — выбрали формат правильно.


Упражнения ​

  1. Сохраните телефонную книгу Виты в 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. Для каждой ситуации из списка выберите формат и в комментарии в коде объясните выбор (1–2 предложения):
  • таблица выручки, которую бухгалтер откроет в Excel;
  • данные для JavaScript-сайта с сервера;
  • настройки вашего приложения: путь к логам, лимиты, debug = true;
  • сохранение собственного объекта класса PhoneBook в кэш между запусками программы;
  • документ, который разработчики будут читать руками и править.
py
# допишите ответ ниже
  1. Друг прислал файл data.pkl, чтобы «посмотреть, кто в списке». Напишите в комментарии: откроете ли вы его через pickle.load(), что попросите вместо него и почему. Ссылайтесь на правило безопасности из урока про pickle.
py
# допишите ответ ниже
  1. Сохраните телефонную книгу в 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'}
}
# допишите код ниже
  1. Сделайте «карточку выбора»: создайте словарь, где ключи — форматы (csv, json, yaml, xml, ini, toml, pickle), а значения — по одной фразе: «выбирай, когда...». Сохраните его в card.json и прочитайте обратно.
py
import json
# допишите код ниже
  1. Итог курса: напечатайте (в коде, строками) список всех модулей этого курса и их происхождение: csv, json, tomllib, configparser, xml.etree.ElementTree, pickle — стандартная библиотека; yaml — сторонняя (через pip). В комментарии ответьте: какие форматы можно читать на «чистой» Python без установки?
py
# допишите ответ ниже