Элис отвечает
IT и разработка

Один пакет на два языка: TermoCore генерирует клиентов из OpenAPI

18.11.2026 · 4 мин. чтения

Один пакет на два языка: TermoCore генерирует клиентов из OpenAPI

Сколько раз вы ловили себя на том, что после правки API на бэкенде приходится синхронно править клиентов в трёх местах — и где-то обязательно забыть? Похоже, в Termotubos решили эту боль радикально: у них появился пакет termo_core, который собирает всех клиентов компании в один модуль сразу для Rust и TypeScript.

Идея простая и оттого красивая. Каждая служба — это отдельный модуль (termo_core::bucket, termo_core::auth и так далее), а каждая ручка API — функция в одну строку, сгенерированная из openapi.json этого сервиса. Имя функции совпадает в обоих языках: на Rust и на TypeScript вы вызываете одно и то же, только синтаксис разный. Код на Rust публикуется на crates.io, TypeScript-версия — на npm, для фронтенда и бэкенда сразу. Подробности и примеры для TypeScript — на странице пакета.

Как это работает в коде

Выглядит почти по-домашнему. Берём токен пользователя, заворачиваем в CredencialDeAcesso — и дальше вызываем методы вроде buscar_pelo_id_usuario или buscar_paginador_usuario. Для общения между бэкендами есть отдельный сценарий: token_do_aplicativo() меняет секрет приложения на короткоживущий JWT, кэширует его в процессе и обновляет заранее, за минуту до истечения. Никаких фоновых задач — всё честно и предсказуемо.

Отдельная забота — окружения. Переменная AMBIENTE выбирает между локальным сервером, песочницей и продакшеном. И тут приятная деталь: если переменную забыли или написали с опечаткой, процесс просто остановится с понятным сообщением, а не уйдёт тихо-мирно в продакшен. Знакомо, правда? Такое случалось у многих — и хорошо, что кто-то решил это закрыть на уровне библиотеки.

Про версии — без сюрпризов

Авторы настойчиво просят фиксировать точную версию через знак «равно»: termo_core = “=0.1.5”. Причина честная: любое изменение контракта в песочнице поднимает последнюю цифру версии, даже если оно ломает совместимость. Так что обновляться нужно осознанно — поменять номер и проверить, что всё компилируется. Немного старомодно, зато без неожиданных сюрпризов в пятницу вечером.

Что это значит

Подход «один источник правды — OpenAPI, а клиенты генерируются» — не новость, но обычно им пользуются большие команды с отдельной инфраструктурой. Здесь же это упаковано в обычный пакет, который можно подключить одной строкой в Cargo.toml или npm install. Для небольших команд и продуктовых разработчиков это ощутимая экономия: меньше ручной синхронизации, меньше расхождений между фронтом и бэком, меньше поводов для споров «кто виноват, что поле переименовали».

Если у вас в проекте есть похожая боль с дублированием клиентов на двух языках — присмотритесь. Иногда одна аккуратно сделанная библиотека экономит месяцы раздражения.

📬 Вы можете подписаться на рубрику «IT и разработка» прямо на сайте Lamvi.Art. Уведомления будут приходить в личный кабинет и на почту!

Материал подготовлен на основе информации из открытых источников. Все права на исходные материалы принадлежат их авторам. Если вы являетесь правообладателем и возражаете против использования материала, либо обнаружили неточность или имеете иное мнение о фактах, изложенных в статье, — напишите нам по адресу info@lamvi.art. Мы всегда открыты к диалогу и внимательно рассмотрим ваше обращение.

📬
Хотите получать свежие материалы по этой теме?
Подпишитесь на рубрику IT и разработка — уведомления будут приходить на почту и в личный кабинет. Частоту и время рассылки можно настроить в профиле.
Материалы носят информационно-развлекательный характер.
Элис
Автор статьи
Элис
★ Рейтинг: 5.0 · Все статьи →

Читайте также

Оставьте комментарий

Вставить смайлик:

Элис

Элис

Онлайн
Прокрутить вверх