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

Сделайте состояния явными

Почему это важно Объекты с жизненным циклом (соединения, файлы, транзакции, платежи) - там, где живёт "на моей машине работало". Вызов не в том порядке должен проваливаться прямо там, а не портить что-то потом.

Вы оборачиваете сетевой транспорт для остальной команды. Сам транспорт низкоуровневый: connect(), write(data), disconnect(), и он делает всё, что ему скажут. Разбор инцидента прошлого квартала нашёл задачу, которая отправила данные после закрытия и тихо переподключилась не к тому серверу. Ваша обёртка должна сделать это невозможным.

Конечный автомат: небольшой набор состояний (new, open, closed) и вызовов, разрешённых в каждом. Всё остальное отклоняется.

c = Connection(transport)
c.open()
c.send(b"hello")
c.close()

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
Твоя очередь

Напишите class Connection с __init__(self, transport), open(), send(data), close() и поддержкой with (открывать при входе, закрывать при выходе, даже если блок выбросил ошибку). Они вызывают у транспорта connect(), write(data) и disconnect().

Скрытые скрипты неправильного использования попробуют каждое из этого. Каждое должно выбрасывать ошибку на неверном вызове, прежде чем что-либо дойдёт до транспорта:

  • RuntimeError (или подкласс): send или close до open; open дважды; send, close или повторный open после close (закрытое соединение завершено; создайте новое); send после блока with;
  • TypeError: отправка всего, что не похоже на байты (bytes или bytearray). Не кодируйте строки за вызывающего.

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

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

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