В этой проверке мы с Codex разобрали небольшой импорт настроек. Строка «Тема:» должна очищать поле, а строка «Тема» должна возвращаться автору с ошибкой. Если оставить от разбора только правую часть, в обоих случаях получится пустая строка. Тогда загрузчик может стереть старое значение после незаконченной записи. Для проверки взяли готовый учебный пример и дополнили его пограничными случаями.

Что получилось в тесте

Проверка выполнена локально на Python. В наборе было семь вымышленных строк. Обработчик вернул три ошибки структуры, одну команду очистки и три команды установки значения. Все семь результатов совпали с заранее записанными ожиданиями. Отдельно проверили действие над одним учебным полем. После ошибочной строки старое значение сохранилось, после явной очистки стало пустым.

В этом эксперименте проверялся текстовый разбор. Реальные документы, клиентские данные и внешние сервисы в нём не использовались. Полученный результат относится к описанному формату строк.

Как задали правило помощнику

Условие сформулировали до разбора. Запись состоит из имени поля, первого двоеточия и значения. Имя должно содержать хотя бы один непробельный символ. Двоеточие обязательно. Значение справа может быть пустым. Дополнительные двоеточия внутри значения сохраняются. Для обычного текстового поля пробелы по краям значения убираются.

Из такого условия следуют три возможных действия. Если нарушена структура, строка получает статус invalid. Если структура верна и значение пустое, возвращается clear. Если есть значение, возвращается set вместе с ним. Дальше импортёр обрабатывает эти действия по своим правилам.

Для Python использовали str.partition. Этот метод разделяет строку по первому вхождению разделителя и возвращает три части. Средняя часть позволяет проверить, встретилось ли двоеточие. В нашем примере сначала проверяется разделитель и непустое имя, затем обрезаются краевые пробелы значения и выбирается действие.

Какие строки прогнали

«Тема» вернула invalid. После этой записи в учебном поле осталось прежнее «обсудить договор».

«Тема: » вернула clear. Разделитель есть, имя заполнено, справа только пробел. Очистка соответствует заранее принятому правилу.

«Тема: план: завтра» вернула set со значением «план: завтра». Второе двоеточие сохранилось внутри текста.

«: план» и « : план» вернули invalid. У обеих записей отсутствует содержательное имя поля, хотя разделитель есть.

« Тема : встреча » вернула set со значением «встреча». Краевые пробелы значения убрались по нашему условию.

«Тема: 0» вернула set со строкой «0». Ноль здесь является текстом, который нужно сохранить. В заключительной проверке импорта поле получило именно эту строку.

Почему сохранили действие отдельно

Пустое значение может быть намерением автора. Ошибка структуры требует исправления входных данных. Если после разбора оба состояния сразу превратить в одно пустое поле, на следующем шаге уже трудно восстановить причину. Статус вместе со значением позволяет показать оператору ошибочную строку и продолжить обработку по явному договору.

Для рабочего загрузчика к этому результату нужно добавить проверку разрешённых имён полей. Наш пример отвечает только на вопрос о форме строки. Импортёр также должен решать, допускаются ли повторные записи одного поля и как применять весь пакет при ошибке в середине. Эти правила зависят от конкретной задачи.

Как повторить проверку для своего импорта

Сначала запишите ожидаемые действия для короткого набора строк. Включите заполненное и пустое значение, пропущенный разделитель, пустое имя, двоеточие внутри текста и строковый ноль. Попросите помощника показать результат для каждой строки, затем выполните проверку в среде, где работает импорт.

После разбора проверьте ещё и состояние поля. Для этого задайте заметное исходное значение и по очереди примените ошибочную запись, очистку и установку нового текста. Такой тест связывает ответ парсера с изменением данных, которое увидит пользователь.

Для паролей и других значений со значимыми пробелами потребуется другой договор об обработке. Для форматов с экранированием, многострочным текстом и комментариями стоит использовать их штатный парсер.

Другие небольшие проверки автоматизаций — в моём Telegram — https://t.me/smirnovsergei_happylife.

Текст подготовлен с помощью ИИ по выполненному в Codex учебному эксперименту. Входные строки учебные, приведённые результаты получены при их выполнении.