Кто-нибудь использует Swagger Codegen или OpenAPI Generator SDK в производственной среде?

Swagger Code Generator может генерировать SDK на многих языках (перечислены ниже на странице проекта Github). Кто-нибудь использует какой-либо из автоматически сгенерированных SDK Swagger в производстве, как альфа/бета, так и GA, и если да, то какие организации и для каких языков?

Я сделал несколько поисков в Google и спросил. Хотя я нашел много примеров развернутого пользовательского интерфейса Swagger, я еще не нашел ни одного SDK Code Gen.

Страница проекта: https://github.com/swagger-api/swagger-codegen

Языки:

$ ls -1 modules/swagger-codegen/src/main/java/com/wordnik/swagger/codegen/languages/
AndroidClientCodegen.java
AsyncScalaClientCodegen.java
CSharpClientCodegen.java
JavaClientCodegen.java
JaxRSServerCodegen.java
NodeJSServerCodegen.java
ObjcClientCodegen.java
PhpClientCodegen.java
PythonClientCodegen.java
RubyClientCodegen.java
ScalaClientCodegen.java
ScalatraServerCodegen.java
SpringMVCServerCodegen.java
StaticDocCodegen.java
StaticHtmlGenerator.java
SwaggerGenerator.java
SwaggerYamlGenerator.java
TizenClientCodegen.java

Обновление - Отслеживание официального проекта SDK (июнь 2018)

Я отслеживаю идентифицируемые официальные SDK Codegen от более крупных организаций, чтобы лучше отслеживать принятие. Многие организации, которые считают себя использующими некоторые проекты codegen, не публикуют SDK в своих учетных записях GitHub.

https://github.com/grokify/api-specs/blob/master/official_codegen_sdks.tsv

Обновление - личный опыт (декабрь 2017)

Сейчас я активно использую Swagger Codegen для Go (2.2.3 - 2.3.1). Пока что мой опыт показывает, что он делает достойную работу, но для получения рабочего SDK может понадобиться множество ручных настроек, поэтому пакет/репозиторий GitHub все еще хорош. Вы можете увидеть некоторые проблемы в проблемах GitHub для SDK, которые я поддерживаю. Я также добавляю постобработку к файлам codegen/swagger_codegen_command.sh в каждом репо.

Обновление - добавление OpenAPI Generator (июль 2018)

OpenAPI Generator является ответвлением Swagger Codegen, так что об этом сейчас упоминается.

Ответ 1

Я выполнил поиск в Github и нашел несколько проектов (SDK), сгенерированных Swagger-Codegen.

Вот один пример: онлайн-конвертация API2 Swift SDK

Вы также можете обратиться к странице Swagger-Codegen Github для обсуждения варианта использования Swagger-Codegen.

ОБНОВЛЕНИЕ: Вот некоторые, но не все компании/проекты, использующие Swagger Codegen в производстве: https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen

Примечание. По состоянию на июль 2017 года Swagger Codegen предлагает более 70 генераторов для API-клиента, заглушек сервера и документации API.

ОБНОВЛЕНИЕ: В мае 2018 года около 50 ведущих участников и создателей шаблонов Swagger Codegen решили раскошелиться на Swagger Codegen для поддержки управляемой сообществом версии OpenAPI Generator. Пожалуйста, обратитесь к Q & A для получения дополнительной информации.

Ответ 2

Как разработчик платформы и DevOps, я могу сказать, что успешно внедрил его в проект, который использует Dreamfactory API Automation, поскольку BaaS и API определяются swagger. Таким образом, SDK для мобильного приложения, а также внутренние приложения генерируются с помощью swagger-codegen. Мы столкнулись с несколькими ошибками в шаблоне swagger-codegen для наших языков, которые было довольно легко исправить. В целом это сэкономило много времени и уменьшает потенциальные источники ошибок.

Ответ 3

Я использовал его для загрузки нашего API на основе spring codegen и теперь использую его для изменения и добавления моделей домена и конечных точек API. Вы все равно должны изменить некоторые аспекты сгенерированных классов, но это делает рефакторинг очень безболезненным и мешает мне накладывать технический долг. Его чрезвычайно полезно иметь сгенерированный swagger-ui для ручного тестирования, и вы можете импортировать спецификацию в Postman, которые генерируют заглушки, чтобы у вас была хорошая стартовая точка и обзор TODO для написания ваших тестов.

Пока не использовали SDK. Я попытался использовать различные js-клиенты, но они не предоставили никаких преимуществ перед простыми библиотеками извлечения.

Я вижу большой потенциал в codegen для более сложных js-фреймворков вроде Angular или React + Redux, а также для автоматизации тестирования.