Программа курса Урок 69 из 148 · API, которые невозможно использовать неправильно
API, которые невозможно использовать неправильно

Никаких булевых ловушек

Почему это важно copy(src, dst, True, False) невозможно прочитать, не открыв функцию. Переставьте два флага, и пробный прогон становится настоящей перезаписью. Именованные опции заставляют каждый вызов говорить, что он делает.

У команды данных есть помощник, который копирует записи между двумя хранилищами: copy_records(src, dst, overwrite, dry_run). В прошлом месяце кто-то вызвал его как copy_records(a, b, False, True), имея в виду "пробный прогон, не перезаписывать", перепутал порядок и перезаписал продакшен-таблицу. Вы его заменяете.

Булева ловушка: аргумент, который бывает только True или False, поэтому место вызова не говорит, что он значит, и его легко переставить.

copy_records(src, dst, on_conflict="keep", mode="dry_run")
Твоя очередь

Напишите copy_records(src, dst, *, on_conflict, mode). src и dst - dict. Для каждого ключа в src: если его нет в dst, скопируйте его; если есть, решает on_conflict: "keep" (оставить значение dst), "overwrite" (взять значение src) или "fail" (выбросить ValueError и вообще ничего не менять). mode - это "apply" (менять dst) или "dry_run" (ничего не менять). Верните отсортированный список записанных ключей (или тех, что были бы записаны).

Скрытые скрипты неправильного использования попробуют каждое из этого; каждое должно выбрасывать TypeError или ValueError и оставлять dst без изменений: передачу опций по позиции, пропуск любой из опций (никаких значений по умолчанию: вызывающий должен выбрать), любое значение, которое не совпадает в точности с одной из названных строк (опечатки, другие заглавные, True, False, None), и старый ключевой аргумент overwrite=.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.