2015-05-20 22 views
9

Swagger Code Generator può generare SDK in molte lingue (elencate di seguito dalla pagina del progetto Github). Qualcuno usa uno qualsiasi degli SDK generati automaticamente da Swagger in produzione, sia come alfa/beta che come GA, e in tal caso, quali organizzazioni e per quali lingue?Qualcuno usa gli SDK di Swagger Code Gen in produzione?

Ho fatto alcune ricerche su Google e ho chiesto in giro. Mentre ho trovato molti esempi di UI Swagger distribuiti, non ho ancora trovato alcun SDK Code Gen.

pagina del progetto: https://github.com/swagger-api/swagger-codegen

Lingue:

$ 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 

Aggiornamento: 2017-01-03

ho utilizzato attivamente Swagger Codegen 2.2.3 e 2.3.0 ora per Vai ora. Finora la mia esperienza è stata che fa un lavoro decente, ma è necessaria una varietà di ritocchi manuali per cui un pacchetto GitHub/repo è ancora bello. È possibile vedere alcuni dei problemi in questioni GitHub per gli SDK che mantengo:

risposta

5

ho fatto un search in Github e trovato alcuni progetti (SDK) generato da Swagger-Codegen.

Ecco un esempio: Online Convert API2 Swift SDK

Si può anche fare riferimento alla Swagger-Codegen Github page per la discussione sull'uso caso di Swagger-Codegen

UPDATE: Qui ci sono alcune, ma non tutte le aziende/progetti che utilizzano Swagger Codegen nella produzione : https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen

Nota: a partire da luglio 2017, Swagger Codegen offre più di 70 generatori per client API, stub server e documentazioni API.

+0

Grazie per la ricerca. La ricerca di "Generato da swagger-codegen" "sembra funzionare bene. – Grokify

2

Come architetto di piattaforma e DevOps, posso dire di averlo introdotto con successo in un progetto che utilizza Dreamfactory API Automation come BaaS e le API sono definite da swagger. Quindi gli SDK per l'app mobile e le applicazioni interne sono generati con swagger-codegen. Abbiamo riscontrato alcuni bug nel modello swagger-codegen per le nostre lingue, che erano abbastanza facili da risolvere. Nel complesso ha risparmiato un sacco di tempo e riduce potenziali fonti di errore.

0

L'ho usato per avviare la nostra API basata sul codice sorgente e ora lo uso per modificare e aggiungere i modelli di dominio e gli endpoint API. Devi ancora cambiare alcuni aspetti delle classi generate ma rende il refactoring molto indolore e mi impedisce di accumulare debito tecnico. È estremamente utile avere lo swagger-ui generato per i test manuali ed è possibile importare le specifiche in Postman che generano stub in modo da avere un buon punto di partenza e una panoramica TODO per scrivere i propri test.

Non hanno ancora utilizzato gli SDK. Ho provato a utilizzare i vari client js ma non hanno fornito alcun vantaggio rispetto alle semplici librerie di recupero.

Vedo un grande potenziale in codegen per framework Js più complessi come Angular o React + Redux e anche automazione di test.