Работа с JSON и CSV

Превращай данные в текст и обратно модулем `json`, сохраняй азербайджанские буквы читаемыми с `ensure_ascii=False`, правильно читай и записывай таблицы модулем `csv` и работай с файлами через `pathlib`.

  • Продвинутый
  • 20 мин
  • 10 вопросов
  • Урок 36 из 66

В этом уроке ты узнаешь

  • Преобразовывать объекты Python в JSON и обратно с помощью json.dumps, json.loads, json.dump, json.load
  • Читать CSV через csv.reader и csv.DictReader и записывать через csv.writer и DictWriter
  • Строить пути, читать и записывать файлы с помощью pathlib.Path

Урок, который ты сейчас читаешь, — тоже JSON-файл: сайт и мобильные приложения берут его из одного и того же файла. Программы обмениваются данными в основном в двух текстовых форматах: JSON — язык веб-сервисов, файлов настроек и API — и CSV — таблицы из Excel, банковских выписок и отчётов. Для обоих в стандартной библиотеке Python есть готовые модули.

JSON: данные в виде текста

JSON (JavaScript Object Notation) очень похож на словари и списки Python, но есть отличия: строки пишутся только в двойных кавычках, вместо True — true, вместо None — null, а ключи объекта — всегда строки. json.dumps превращает объект Python в строку JSON (сериализация), а json.loads делает обратное.

PythonJSON
dictобъект {...}
list, tupleмассив [...]
strстрока (в двойных кавычках)
int, floatчисло
True, False, Nonetrue, false, null
Python
import json

student = {'name': 'Aysel', 'city': 'Bakı', 'age': 19,
           'grades': [5, 4, 5], 'active': True, 'mentor': None}
text = json.dumps(student)
print(text)
print(json.dumps(student, ensure_ascii=False))
back = json.loads(text)
print(back == student, type(back['grades']).__name__)
print(json.dumps({'city': 'Gəncə', 'grades': [5, 4]}, ensure_ascii=False, indent=2))
Ожидаемый результат
{"name": "Aysel", "city": "Bak\u0131", "age": 19, "grades": [5, 4, 5], "active": true, "mentor": null}
{"name": "Aysel", "city": "Bakı", "age": 19, "grades": [5, 4, 5], "active": true, "mentor": null}
True list
{
  "city": "Gəncə",
  "grades": [
    5,
    4
  ]
}
Python
import json
from datetime import date

data = {1: 'one', 'point': (3, 4)}
text = json.dumps(data)
print(text)
print(json.loads(text))
try:
    json.dumps({'when': date(2026, 9, 1)})
except TypeError as e:
    print('TypeError:', e)
print(json.dumps({'when': date(2026, 9, 1)}, default=str))
Ожидаемый результат
{"1": "one", "point": [3, 4]}
{'1': 'one', 'point': [3, 4]}
TypeError: Object of type date is not JSON serializable
{"when": "2026-09-01"}

Чтобы читать дальше, зарегистрируйся бесплатно

Остальные разделы урока, тест и заметки открываются с аккаунтом Educora. Регистрация занимает минуту, а прогресс сохраняется на всех твоих устройствах.

pathlib и файлы JSON

pathlib.Path представляет путь к файлу как объект: пути соединяются через / (Path('data') / 'report.json'), read_text и write_text читают и записывают файл одной строкой, name, stem, suffix возвращают части имени, а exists() — есть ли файл. Код одинаково работает в Windows, macOS и Linux. Для открытых файловых объектов есть json.dump и json.load.

Python
import json
from pathlib import Path

settings = {'language': 'az', 'theme': 'dark', 'subjects': ['python', 'math']}
path = Path('settings.json')
path.write_text(json.dumps(settings, indent=2), encoding='utf-8')
loaded = json.loads(path.read_text(encoding='utf-8'))
print(loaded['subjects'])

with open(path, 'w', encoding='utf-8') as f:
    json.dump(settings, f, ensure_ascii=False)
with open(path, encoding='utf-8') as f:
    print(json.load(f) == settings)
print(path.name, path.stem, path.suffix, path.exists())
Ожидаемый результат
['python', 'math']
True
settings.json settings .json True
Запомни: dumps / loads работают со строкой, а dump / load — с файлом («s» на конце — string, строка).

CSV: таблицы с модулем csv

CSV выглядит простым, но поле в кавычках может содержать запятую, перевод строки или саму кавычку. Модуль csv знает эти правила. csv.reader возвращает каждую строку списком, а csv.DictReader — словарём с именами из строки заголовка. Все значения — строки, числа преобразуй сам.

Python
import csv
import io

text = '''name,city,score
Aysel,Bakı,91
Murad,"Gəncə, Azerbaijan",76
Leyla,Sumqayıt,85'''
for row in csv.reader(io.StringIO(text)):
    print(row)
rows = list(csv.DictReader(io.StringIO(text)))
print(rows[1]['city'], '|', type(rows[1]['score']).__name__)
avg = sum(int(r['score']) for r in rows) / len(rows)
print(f'average: {avg:.1f}')
print('Murad,"Gəncə, Azerbaijan",76'.split(','))
Ожидаемый результат
['name', 'city', 'score']
['Aysel', 'Bakı', '91']
['Murad', 'Gəncə, Azerbaijan', '76']
['Leyla', 'Sumqayıt', '85']
Gəncə, Azerbaijan | str
average: 84.0
['Murad', '"Gəncə', ' Azerbaijan"', '76']

Для записи используют csv.writer (списки) или csv.DictWriter (словари). Модуль сам ставит кавычки там, где они нужны. По стандарту строки заканчиваются на \r\n; здесь передаём lineterminator='\n', чтобы вывести результат на экран.

Python
import csv
import io

rows = [{'product': 'Tea', 'price': 4.5, 'qty': 30},
        {'product': 'Coffee, large', 'price': 6.0, 'qty': 25}]
buf = io.StringIO()
writer = csv.DictWriter(buf, fieldnames=['product', 'price', 'qty'], lineterminator='\n')
writer.writeheader()
writer.writerows(rows)
print(buf.getvalue(), end='')
buf2 = io.StringIO()
csv.writer(buf2, delimiter=';', lineterminator='\n').writerow(['Tea', '4,5', 30])
print(buf2.getvalue(), end='')
Ожидаемый результат
product,price,qty
Tea,4.5,30
"Coffee, large",6.0,25
Tea;4,5;30

Мини-проект: от CSV к отчёту в JSON

Оценки лежат в CSV-файле, а мобильное приложение ждёт сводку по группам в JSON. Программа создаёт папку data, читает CSV через DictReader, собирает баллы по группам и записывает отчёт в report.json.

Python
import csv
import json
from pathlib import Path

folder = Path('data')
folder.mkdir(exist_ok=True)
(folder / 'grades.csv').write_text(
    'name,group,score\nAysel,A,91\nMurad,B,76\nLeyla,A,85\nElvin,B,64\n', encoding='utf-8')

with open(folder / 'grades.csv', newline='', encoding='utf-8') as f:
    rows = list(csv.DictReader(f))

groups = {}
for r in rows:
    groups.setdefault(r['group'], []).append(int(r['score']))
report = {g: {'count': len(s), 'average': round(sum(s) / len(s), 1)} for g, s in groups.items()}

(folder / 'report.json').write_text(json.dumps(report, indent=2), encoding='utf-8')
print((folder / 'report.json').read_text(encoding='utf-8'))
print(sorted(p.name for p in folder.glob('*')))
Ожидаемый результат
{
  "A": {
    "count": 2,
    "average": 88.0
  },
  "B": {
    "count": 2,
    "average": 70.0
  }
}
['grades.csv', 'report.json']
mkdir(exist_ok=True) не вызывает ошибку, если папка уже есть, а glob('*') перечисляет файлы в папке. В браузере файлы хранятся во временной файловой системе в памяти.

Задание

Прочитай заказы из строки JSON. В первой строке выведи общую сумму всех заказов (с округлением до 2 знаков), во второй — суммы по городам в виде JSON: азербайджанские буквы не должны кодироваться, а ключи должны быть отсортированы.

Задание · Python
import json

text = '[{"customer": "Aysel", "city": "Bakı", "total": 45.5}, {"customer": "Murad", "city": "Gəncə", "total": 30.0}, {"customer": "Leyla", "city": "Bakı", "total": 12.5}]'
# 1) total of all orders
# 2) totals by city as JSON (ensure_ascii=False, sort_keys=True)
Ожидаемый результат
88.0
{"Bakı": 58.0, "Gəncə": 30.0}

Задание

Прочитай CSV через csv.DictReader. В первой строке выведи словарём, сколько студентов из каждого города, во второй — город с самым высоким средним баллом и сам этот средний балл (через пробел).

Задание · Python
import csv
import io

text = '''name,city,score
Aysel,Bakı,91
Murad,Gəncə,76
Leyla,Bakı,85
Elvin,Gəncə,64
Nigar,Sumqayıt,88'''
# count students per city, then find the city with the best average
Ожидаемый результат
{'Bakı': 2, 'Gəncə': 2, 'Sumqayıt': 1}
Bakı 88.0

Запомни

  • dumps / loads работают со строками, dump / load — с файлами; в JSON есть true, false, null и только строковые ключи.
  • Для азербайджанского текста — ensure_ascii=False и encoding='utf-8'; для читаемости — indent=2.
  • Даты и множества нельзя записать в JSON напрямую: используй default=str или строки ISO.
  • Читай и пиши CSV модулем csv, а не split(','); открывай файлы с newline=''.
  • pathlib.Path: пути через /, read_text, write_text, mkdir(exist_ok=True), glob.
Заметил ошибку или неточность в уроке?

Проверь себя

Вопросов: 10. Каждый правильный ответ приносит XP.

Вопрос 1 / 10

Вопрос 1 / 10. Что вернёт json.dumps({'ok': True, 'x': None})?