Прошлый урок научил читать и записывать файлы через функцию open и конструкцию with, а значит, у любого скрипта появились две новые заботы: правильно собрать путь к нужному месту на диске и удобно сохранять данные между запусками. Обе задачи в Python решаются изящно, поэтому этот урок посвящён модулю pathlib для работы с путями и модулю json для хранения словарей и списков в текстовом виде. Весь код из урока готов к копированию и запуску, а к следующему занятию о классах и объектах читатель подойдёт уже с пониманием того, как выглядят настоящие объекты в стандартной библиотеке.

Опасная склейка путей обычными строками

Задача выглядит тривиальной: есть имя папки, есть имя файла, соединить их и открыть. Новички чаще всего делают это конкатенацией строк:

folder = "documents"
file_name = "todo.txt"
path = folder + "/" + file_name
print(path)

На Linux и macOS код работает, потому что разделителем там служит косая черта /. На Windows тот же код собирает строку documents/todo.txt, а система ожидает documents\todo.txt, и обратный слэш внутри обычной строки к тому же приходится удваивать или ставить перед строкой букву r, превращая её в сырую. Вторая ловушка подстерегает при переносе скрипта на другую машину: жёстко прописанный путь C:/Users/ivan/documents в домашней папке другого человека не существует, и программа падает с ошибкой FileNotFoundError. Опытные разработчики давно устали от подобных сюрпризов, поэтому в стандартной библиотеке появился отдельный модуль pathlib, который представляет путь не строкой, а полноценным объектом со своими методами и свойствами. Справедливости ради существовал и более старый способ os.path.join(folder, file_name), который тоже склеивал путь по правилам системы, но вызов функции на каждое соединение читался громоздко.

Сборка пути объектом Path через оператор слэш

Модуль pathlib лежит в стандартной поставке Python, устанавливать ничего не нужно. Главная идея в том, что путь создаётся вызовом Path, а части маршрута соединяются оператором /, тем самым символом, который в мире чисел означает деление:

from pathlib import Path

folder = Path("documents")
file_path = folder / "todo.txt"
print(file_path)            # documents/todo.txt
print(type(file_path))      # <class 'pathlib.Path'>

Красота решения в том, что объект Path сам знает, какой разделитель принят в текущей системе. Тот же код на Windows напечатает documents\todo.txt с правильной чертой. Соединять можно сколько угодно уровней вложенности:

from pathlib import Path

deep_path = Path("projects") / "site" / "data" / "users.csv"
print(deep_path)
print(deep_path.exists())

Оператор / здесь не делит числа, а склеивает части пути, и поначалу запись выглядит непривычно. Однако уже после пары скриптов она начинает нравиться: короткая, читается слева направо и не требует ни одного экранирования. Бонус для любознательных: pathlib умеет строить путь от домашней папки пользователя командой Path.home(), что избавляет от догадок, где именно человек хранит свои документы.

Ещё одна полезная привычка: различать относительный и абсолютный путь. Запись Path("settings.json") задаёт относительный путь, и файл будет искаться в той папке, откуда запущен скрипт. Вызов resolve() разворачивает его в полный адрес от корня диска:

from pathlib import Path

p = Path("settings.json")
print(p.resolve())      # /home/ivan/projects/settings.json

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

Проверка существования и создание папок силами pathlib

У объекта Path есть методы, которые раньше требовали отдельного модуля os.path. Метод exists() возвращает True или False в зависимости от того, есть ли файл или папка на диске. Метод mkdir() создаёт каталог, причём аргумент parents=True разрешает построить сразу всю цепочку вложенных папок, а exist_ok=True подавляет ошибку, если каталог уже существует:

from pathlib import Path

backup = Path("backup") / "2026" / "november"
if not backup.exists():
    backup.mkdir(parents=True, exist_ok=True)
    print("Создана новая папка:", backup)
else:
    print("Папка уже на месте:", backup)

Две строки внутри условия заменяют целый блок проверок, который раньше писали через os.makedirs. Есть и обратные действия: метод unlink() удаляет файл, метод rmdir() пустой каталог. Начинающему полезно знать о них: уборка за тестовыми скриптами займёт секунды.

Имя, расширение, родитель и прочие части пути

Путь редко нужен целиком: чаще из него требуется вытащить имя файла, расширение или папку, где файл лежит. Раньше для этого строку резали методами replace и split, и на границе разных систем код снова рассыпался. У Path все части маршрута уже разложены по свойствам:

from pathlib import Path

p = Path("documents/notes/todo.txt")
print(p.name)      # todo.txt
print(p.stem)      # todo
print(p.suffix)    # .txt
print(p.parent)    # documents/notes

Свойство name отдаёт имя файла вместе с расширением, stem отдаёт имя без расширения, suffix хранит расширение с точкой, а parent возвращает родительский каталог, причём тоже в виде объекта Path, к которому снова применим оператор /. Это важная черта объектов: методы и свойства одного уровня возвращают объекты того же класса, поэтому цепочки вроде p.parent / "archive" / (p.stem + "_old" + p.suffix) собираются в одну строку. Для смены расширения существует метод with_suffix, например p.with_suffix(".bak") превратит todo.txt в todo.bak, не трогая исходный файл.

Перебор файлов в каталоге методами iterdir и glob

Типичная задача любого скрипта: пройтись по папке и обработать все файлы или только файлы определённого типа. Метод iterdir() выдаёт содержимое каталога по одному элементу, а метод is_dir() подсказывает, папка перед глазами или файл:

from pathlib import Path

folder = Path("documents")
for item in folder.iterdir():
    if item.is_dir():
        print("Папка:", item.name)
    else:
        print("Файл:", item.name)

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

from pathlib import Path

folder = Path("documents")
for txt in folder.glob("*.txt"):
    print("Найден текстовый файл:", txt.name)

for py in folder.glob("**/*.py"):
    print("Скрипт во вложенной папке:", py)

Шаблон .txt ловит файлы в самой папке, а шаблон */*.py спускается и во все вложенные каталоги. Такой перебор заменяет десятки строк ручной навигации и работает как умный фильтр в проводнике, только из кода. Комбинация iterdir, glob и is_dir покрывает девять из десяти бытовых задач: найти самые большие файлы, собрать отчёты за месяц, переименовать пачку фотографий по дате.

Пара строк, и готов практичный скрипт переименования:

from pathlib import Path

folder = Path("photos")
for img in folder.glob("*.jpg"):
    new_name = img.stem + "_2026" + img.suffix
    img.rename(folder / new_name)
    print("Переименован:", img.name, "->", new_name)

Метод rename() переименовывает или переносит файл, а сборка нового имени из частей через stem и suffix показывает, насколько удобно работать с компонентами пути по отдельности, не разрезая строку вручную.

Формат JSON простыми словами для начинающих

JSON расшифровывается как JavaScript Object Notation, но к языку JavaScript имеет лишь историческое отношение: это способ записать данные в виде текста, который понимают практически все языки программирования и программы. Читатель уже знаком со словарями и списками, и тут случается приятное совпадение: JSON выглядит как словари и списки, записанные прямо в файле:

{
    "theme": "dark",
    "font_size": 14,
    "autosave": true,
    "recent_files": ["report.txt", "todo.txt", "draft.py"]
}

В фигурных скобках лежат пары ключ и значение, в квадратных скобках список, строки всегда в двойных кавычках, а вместо значений True и False из Python в JSON пишутся true и false, вместо None пишется null. Модуль json входит в стандартную поставку и умеет превращать словарь в текст и обратно. То есть программа может сохранить своё состояние в файл, а после перезапуска прочитать его и продолжить с того же места, будто её и не выключали.

Модуль json умеет и более мелкую работу: превратить словарь в строку, не трогая файлы. Для этого есть функция json.dumps:

import json

settings = {"theme": "dark", "font_size": 14}
text = json.dumps(settings, ensure_ascii=False)
print(text)          # {"theme": "dark", "font_size": 14}
print(type(text))    # <class 'str'>

Такую строку можно вывести на экран, дописать в лог или отправить по сети. В именах функций легко запутаться: dump пишет в файл, dumps возвращает строку, буква s расшифровывается как string.

Сохранение настроек программы в файл settings.json

Самый наглядный пример пользы JSON: настройки. Приложение запоминает тему оформления, размер шрифта и последние открытые файлы, чтобы после перезапуска не заставлять человека настраивать всё заново. Запись словаря в файл выполняет функция json.dump, причём аргумент ensure_ascii=False сохраняет кириллицу читаемыми буквами, а indent=4 делает файл аккуратным и удобным для глаз:

import json

settings = {
    "theme": "dark",
    "font_size": 14,
    "autosave": True,
    "recent_files": ["report.txt", "todo.txt", "draft.py"]
}

with open("settings.json", "w", encoding="utf-8") as f:
    json.dump(settings, f, ensure_ascii=False, indent=4)

print("Настройки сохранены")

Чтение обратно выполняет функция json.load, и на выходе получается обычный словарь Python, с которым работают знакомые операции:

import json

with open("settings.json", "r", encoding="utf-8") as f:
    settings = json.load(f)

print(settings["theme"])              # dark
print(settings["font_size"])          # 14
print(len(settings["recent_files"]))  # 3

settings["font_size"] = 16
settings["autosave"] = False

Отдельный приём на случай, когда ключа в файле может не оказаться: метод get для словарей. Он возвращает значение по ключу, а если ключ отсутствует, подставляет запасной вариант:

theme = settings.get("theme", "light")
volume = settings.get("volume", 50)
print("Тема:", theme, "Громкость:", volume)

Старая версия файла настроек без ключа volume больше не проблема: читатель получит громкость по умолчанию, а при следующем сохранении ключ появится в JSON сам собой.

Теперь соберём маленькую, но настоящую программу настроек, объединяющую pathlib и json. Перед запуском она проделывает понятную цепочку шагов:

  1. собирает путь к файлу настроек из папки config и имени settings.json через Path и оператор /;
  2. создаёт папку config методом mkdir с аргументами parents и exist_ok;
  3. проверяет существование файла методом exists и при успехе читает настройки через json.load;
  4. подставляет значения по умолчанию и сохраняет их через json.dump, если файла ещё нет;
  5. меняет одно из значений и записывает файл обратно, чтобы изменения не потерялись.

Вот полный код, готовый к запуску:

import json
from pathlib import Path

config_path = Path("config") / "settings.json"
default_settings = {"theme": "light", "font_size": 12, "autosave": False}

config_path.parent.mkdir(parents=True, exist_ok=True)

if config_path.exists():
    with open(config_path, "r", encoding="utf-8") as f:
        settings = json.load(f)
else:
    settings = default_settings

settings["theme"] = "dark"
with open(config_path, "w", encoding="utf-8") as f:
    json.dump(settings, f, ensure_ascii=False, indent=4)

print("Текущая тема:", settings["theme"])
print("Размер шрифта:", settings["font_size"])

После запуска в проекте появится папка config с файлом settings.json, и любое изменение переживёт перезапуск программы. Любопытная деталь прячется в строке config_path.parent: объект Path отдаёт папку config как объект того же класса, и метод mkdir вызывается прямо у него, без промежуточных переменных.

Закрепить связку pathlib и json можно ещё одним мини-примером: счётчиком запусков программы. Файл хранит словарь с числом запусков, и при каждом старте значение растёт на единицу:

import json
from pathlib import Path

stats_path = Path("config") / "stats.json"

if stats_path.exists():
    with open(stats_path, "r", encoding="utf-8") as f:
        stats = json.load(f)
else:
    stats = {"launches": 0}

stats["launches"] += 1

with open(stats_path, "w", encoding="utf-8") as f:
    json.dump(stats, f, ensure_ascii=False, indent=4)

print("Программа запущена раз:", stats["launches"])

Скрипт можно запустить хоть десять раз подряд, и число в файле будет расти с каждым запуском. Точно так же работают счётчики посещений, статистика в играх и прогресс тренировок в приложениях: всюду лежит похожая пара json.load и json.dump.

Модуль pathlib закрывает вечный вопрос со склейкой путей: один объект, один оператор / и горстка методов вместо ручной сборки строк с экранированием. Модуль json даёт программе память между запусками, причём файл настроек можно открыть обычным блокнотом и поправить руками, формат останется читаемым. Оба инструмента входят в стандартную библиотеку, поэтому встречаться будут постоянно. И последний штрих в копилку следующего урока: Path это объект со свойствами и методами, json.load возвращает объект-словарь, и весь сегодняшний материал читатель провёл среди объектов, даже не заметив этого. Следующее занятие открывает тему классов и объектов, где станет ясно, как такие вещи устроены изнутри и как создавать собственные.