These are chat archives for APIs-guru/api-models

25th
May 2018
Stefan Junker
@steveeJ
May 25 2018 14:43
@MikeRalphson it seems that the openapi-codegen has not attracted much attention during the last few months. I'm about to spend some time on this topic again and am wondering which project to contribute to. I've found https://github.com/OpenAPITools/openapi-generator which has gained some momentum
Mike Ralphson
@MikeRalphson
May 25 2018 14:49
As I said to someone else recently, it comes down to whether you prefer a dsl driven or code driven approach, and nodejs vs java, and how much community support you want. Between swagger-codegen and openapi-generator I think it's too early to tell, but the main difference is between the larger breaking changes in sc and more continuity with og.
Stefan Junker
@steveeJ
May 25 2018 14:51
would you mind to elaborate on dsl driven vs code driven?
Stefan Junker
@steveeJ
May 25 2018 15:00
what is the completeness state of the parser? I'm willing to dig all the way into the templating and configuration, but I would be thrown off if the parser wouldn't deliver all of the specs elements
in particular I'm interested in generating Go and Rust server and client code which supports http and apiKey security schemes
Mike Ralphson
@MikeRalphson
May 25 2018 15:06
Openapi-codegen uses a domain specific language (config file driven approach) while swagger codegen and openapi-generator subclass the model generation code for each language.
Stefan Junker
@steveeJ
May 25 2018 15:06
ah, you see the config file as a DSL, makes sense
Mike Ralphson
@MikeRalphson
May 25 2018 15:07
Openapi-codegen uses a validator, but not a separate parser as such. It converts all inputs into oas3 and works directly off that as the base model.
Completeness can only really be measured by working configs /languages, but it should quickly tend towards 100%
Stefan Junker
@steveeJ
May 25 2018 15:11
I find the config file approach appealing
it allows for replacing the parser implementation
if one wanted that
Mike Ralphson
@MikeRalphson
May 25 2018 15:22
Yes, it has that benefit. I can't say how much attention it's going to get as it was initially only a hackathon proof-of-concept.
Stefan Junker
@steveeJ
May 25 2018 15:24
Can you point me to the config input parameters which would be used for the security definitions?
I have no new experience in javascript since looking at this project a couple months ago :D