Когда простой API превращается в кошмар

вот значит передо мной стоит задача довольно тривиальная - в рельсовом проекте нужно дернуть апи сервиса...некакого сервиса, транзакшн движок какой то. не суть. короч в рельсовом проекте есть гем с клиентом. смотрю клиент - клиент сгенерирован изсвэггера. ну думаю классно. иду в документацию - всю излазил, но нет свэггер спеки нигде. я уже начинаю подкипать. в сам репозиторий спека не включена. ок, я пошел смотреть в ручную либу, она тоже сгенерирована через свэггер и там есть спека. посмотрел в спеку- в спеке интересующего меня метода тоже нету. возвращаюсь к гему с клиентом. начинаю медитировать. смотрю вообще на аннотейты вижу там фамилию, иду в слак. этот аккаунт уже деактивирован. ок. начинаю искать все его сообщения. в какой то момент улавливаю где то слово свэггер. начинаю читать этот чат (уже архивированный кстати). в чате нахожу, что оказывается кто то написал скрипт который парсит табличное описание апи с сайта и генерит. ок, я нашел эту репу. там руби скрипт скрэппер. ок, с какой то матерью я понял как он работает - нужно на странице с описанием апи ручками из дом дерева скопировать тбоди вставить в скрипт запустить - он сгенерирует только параметры. потом так же взять хмл ответа на странице доки и вставить ее в другой скрипт. получить структуры ответа. потом ручками пойти в спеку на 7000+ строк в нужное место и туда вставить нужные параметры и ответ. НО и это еще не все - дальше ж нужно сгенерировать либу. и вот я установил ту же верси. свэггер кодгена, начал генерить - и сука дифф феноменально огромный. потому что он перпендал классы. было {serviceName}Client а стал SwaggerClient - а все сука потому что мне теперь еще надо угадать набор флагов для swagger-codegen-cli чтобы попасть в старую генерацию, чтобы все было совместимо с текущей кодовой базой и ТОЛЬКО БЛЯДЬ ДОБАВИЛСЯ ОДИН МЕТОД

Автор описывает, как простая задача вызвать API превращается в многочасовой поиск Swagger-спеки, старого скрипта и правильных параметров генерации клиента. Шутка в стремительной эскалации сложности: вместо добавления одного метода приходится разбираться с Rails, Slack, архивами, ручным редактированием спецификации и огромным diff после генерации кода. EN: The author describes how a simple API call turns into hours of searching for a Swagger specification, an old script, and the right client-generation parameters. The joke is the escalating complexity: instead of adding one method, they must deal with Rails, Slack, archives, manual specification editing, and a huge diff after code generation.

• @profunctor_io / 2588 2019-07-11