Comment exécuter swagger-codegen pour OpenAPI 3.0.0
ressemble à officiel swagger pour openapi la spécification V3 est presque disponible https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/ et swagger-codegen a le support 3.0.0 développé et passe un certain niveau de test https://github.com/swagger-api/swagger-codegen sur la branche 3.0.0
J'ai une spécification swagger (générée à partir de ma spécification 2.0 existante via https://github.com/mermade/swagger2openapi , la sortie est bonne)
Existe-t-il un moyen simple de faire fonctionner swagger-codegen sans avoir à emballer le pot moi-même?
- c'est le résultat unique que j'ai trouvé: https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/3.0.0-SNAPSHOT/ mais cela semble fonctionner cassé (à partir de la sortie, peut-être réellement en cours d'exécution 2.0 et non 3.0.0?):
[main] INFO io.swagger.parser.Swagger20Parser - lecture dans /input/myspec.openapi3.json [main] INFO io.swagger.codegen.ignore.CodegenIgnoreProcessor - Aucun fichier .swagger-codegen-ignore trouvé . Exception dans le thread "principal" Java.lang.RuntimeException: entrée swagger manquante ou config! sur io.swagger.codegen.DefaultGenerator.generate (DefaultGenerator.Java:685) sur io.swagger.codegen.cmd.Generate.run (Generate.Java:285) sur io.swagger.codegen.SwaggerCodegen.main (SwaggerCodegen.Java:35)
Il semble que le référentiel swagger-codegen ait une manière quelque peu supportée d'exécuter un conteneur de docker après que vous avez construit; J'espère juste/devine qu'il existe un moyen supporté de faire cela sans avoir besoin de compiler localement, car j'ai besoin de l'installer à plusieurs endroits.
OpenAPI Generator } _ (trouvé par les principaux contributeurs de Swagger Codegen) supporte les spécifications OpenAPI v2 et v3.
Vous pouvez utiliser les images de menu fixe _ ou JAR Java (SNAPSHOT) pour l'essayer.
Pour plus d’informations sur OpenAPI Generator, veuillez vous reporter au projet README du projet.
Si vous avez besoin d'aide, veuillez ouvrir un numéro et nous l'examinerons.
MISE À JOUR: La première version stable 3.0.0 a été publiée: https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.0.0
Les instantanés Swagger-codegen 3.0.0 incluent désormais un nombre limité de cibles pour la génération de code à partir de définitions OpenAPI 3.0. https://github.com/swagger-api/swagger-codegen/issues/6598#issuecomment-333428808
Il existe une autre implémentation expérimentale du moteur Codegen, utilisant les modèles originaux 2.x de swagger-codegen, écrits dans Node.js: https://github.com/mermade/openapi-codegen - si votre langue est pas encore pris en charge, il suffit de créer un fichier de configuration pour mapper les fichiers modèles aux sorties.