OxL Справочник OxL
РусскийEnglish

Правила хорошего кода (часть IV)

В этой главе

IV.1 Никаких «магических» значенийТаймауты, повторы, размеры, лимиты, TTL и пороги задаются один раз именованной константой или полем конфига и переиспользуются.
IV.2 Именаoxl fmt не переименовывает, анализатор выдаёт предупреждение naming.
IV.3 ОшибкиВозвращайте конкретные @error-типы, а не строки.
IV.4 АсинхронностьЦепочка — для последовательности шагов с общим обработчиком ошибок и дедлайном; простой последовательный код пишите обычными инструкциями.
IV.5 Данные и схемыНе меняйте тип поля — добавляйте новое поле и помечайте старое @removed.
IV.6 РаспределённостьЛюбой rpc, который может повторяться (саги, надёжные шаги, @retry), — @idempotent.
IV.7 ТестыНа каждый rpc — юнит-тест обработчика с моками зависимостей.