2015-05-20 29 views
9

Der Swagger Code Generator kann SDKs in vielen Sprachen erzeugen (siehe unten auf der Github-Projektseite). Benutzt jemand eines der von Swagger automatisch generierten SDKs in der Produktion, sowohl als Alpha/Beta als auch als GA, und wenn ja, welche Organisationen und für welche Sprachen?Verwendet jemand Swagger Code Gen SDKs in der Produktion?

Ich habe einige Google-Suchen durchgeführt und herumgefragt. Während ich viele Beispiele für Swagger UI gefunden habe, habe ich noch keine Code Gen SDKs gefunden.

Projektseite: https://github.com/swagger-api/swagger-codegen

Sprachen:

$ 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 

Update: 2017-01-03

Ich habe aktiv wurde mit Swagger Codegen 2.2.3 und 2.3.0 jetzt für jetzt gehen. Bis jetzt ist meine Erfahrung, dass es einen anständigen Job macht, aber eine Vielzahl von Hand-Tweaks sind notwendig, so dass ein GitHub-Paket/Repo immer noch nett ist. Sie können für die SDKs einige der Probleme in den GitHub Fragen sehe ich pflegen:

Antwort

5

Ich habe eine search in Github und einige Projekte gefunden (SDKs) generiert von Swagger-Codegen. Hier

ist ein Beispiel: Online Convert API2 Swift SDK

Sie können auch auf die Swagger-Codegen Github page für die Diskussion über Anwendungsfall beziehen von Swagger-Codegen

UPDATE: Hier sind einige, aber nicht alle Unternehmen/Projekte mit Swagger Codegen in Produktion : https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen

Hinweis: Ab Juli 2017 bietet Swagger Codegen mehr als 70 Generatoren für API-Client, Server Stubs und API-Dokumentationen.

+0

Danke für die Suche. Die Suche nach "Generated by swagger-codegen" scheint gut zu funktionieren. – Grokify

2

Als Plattformarchitekt und DevOps kann ich sagen, dass ich es erfolgreich in ein Projekt eingeführt habe, das Dreamfactory API Automation als BaaS verwendet und APIs werden von swagger definiert. So werden die SDKs für die mobile App sowie interne Anwendungen mit swagger-codegen generiert. Wir haben ein paar Bugs in der Swagger-Codegen-Vorlage für unsere Sprachen gefunden, die ziemlich einfach zu beheben waren. Insgesamt spart es viel Zeit und reduziert mögliche Fehlerquellen.

0

Ich habe es verwendet, um unsere API basierend auf dem Quellcode zu bootstrappen und es jetzt zu verwenden, um die Domänenmodelle und API-Endpunkte zu ändern und hinzuzufügen. Sie müssen noch einige Aspekte der generierten Klassen ändern, aber es macht das Refactoring sehr schmerzlos und hindert mich daran, technische Schulden aufzubauen. Es ist sehr hilfreich, das erzeugte swagger-ui für manuelle Tests zu haben und Sie können die Spezifikation in Postman importieren, die Stubs generiert, so dass Sie einen guten Ausgangspunkt für die TODO-Übersicht zum Schreiben Ihrer Tests haben.

Habe die SDKs noch nicht benutzt. Ich habe versucht, die verschiedenen js-Clients zu verwenden, aber sie bieten keinen Vorteil gegenüber einfachen Abruf-Bibliotheken.

Ich sehe großes Potenzial in Codegen für komplexere js Frameworks wie Angular oder React + Redux und auch Testautomatisierung.