Прошлый урок научил читать и записывать файлы через функцию 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. Перед запуском она проделывает понятную цепочку шагов:
- собирает путь к файлу настроек из папки config и имени settings.json через Path и оператор /;
- создаёт папку config методом mkdir с аргументами parents и exist_ok;
- проверяет существование файла методом exists и при успехе читает настройки через json.load;
- подставляет значения по умолчанию и сохраняет их через json.dump, если файла ещё нет;
- меняет одно из значений и записывает файл обратно, чтобы изменения не потерялись.
Вот полный код, готовый к запуску:
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 возвращает объект-словарь, и весь сегодняшний материал читатель провёл среди объектов, даже не заметив этого. Следующее занятие открывает тему классов и объектов, где станет ясно, как такие вещи устроены изнутри и как создавать собственные.