swagger-api / swagger-codegen

swagger-codegen contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI / Swagger definition.
http://swagger.io
Apache License 2.0
16.94k stars 6.03k forks source link

How to contribute for adding the Ballerina language client generator in swagger editor `Generate Client` option #12171

Open lnash94 opened 1 year ago

lnash94 commented 1 year ago

Hi Team,

We are currently developing a client for the Ballerina language which is an open-source, cloud-native programming language specifically designed to simplify integration development for enterprise applications. We use OpenAPI specification for generating a client via the tool. We are interested in adding this client generation tool to the "Generate Client[1]" panel in the Swagger editor UI.

[1] Generate Client panel in Swagger editor UI

swagger_UI

Could you please provide us with guidance on the process of contributing to this Swagger Editor panel? We would appreciate it if you could clarify whether you have specific requirements or guidelines related to client generation. Thank you in advance for your assistance.

Reference: https://community.smartbear.com/t5/SwaggerHub-Questions/How-to-contribute-Generate-Client-option-for-Swagger-online/td-p/250593 Ballerina OpenAPI tool : https://ballerina.io/learn/openapi-tool/ Ballerina OpenAPI tool for Client Generation: https://ballerina.io/learn/openapi-tool/#generate-ballerina-clients-from-openapi-definitions

char0n commented 1 year ago

Hi @lnash94,

Transferring this issue to https://github.com/swagger-api/swagger-codegen where code generation is being handled.

frantuma commented 1 year ago

@lnash94 in current implementation of Swagger Editor its "generators" are all implemented and provided by Swagger Codegen (this project, deployed here). This means that the only way to add a generation tool to the panel is implementing it within swagger-codegen (for OpenApi 3.0 generators in separate repo) and adding it as a "core" generator. Generators are typically including one/more java classes and handlebars templates.

lnash94 commented 1 year ago

@char0n, @frantuma Thank you so much for the information. We will be checking the ability to adapt our implementation there.