Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Publish supported features matrix for all clients #4951

Open
ryanackley opened this issue Mar 6, 2017 · 3 comments
Open

Publish supported features matrix for all clients #4951

ryanackley opened this issue Mar 6, 2017 · 3 comments

Comments

@ryanackley
Copy link

This is an improvement request.

My first adventure into Swagger and I'm finding massive inconsistencies between the different language implementations. What makes this extremely frustrating is that the code generator will generate stuff that isn't actually functional. For example, the Java client generator doesn't support inheritance. It happily generates a useless class instead. Objective-C supports inheritance but it doesn't support enums. Again, it will happily generate useless placeholders for the enums that have no data and break the client.

I'm finding this by trial and error by manually writing tests (the tests generated by swagger-codegen are pretty much useless without some way to specify sample input values)

It would have saved me loads of time if there was a supported feature matrix that showed which features are supported by each client and suggested workarounds. I will happily contribute to this matrix.

@wing328
Copy link
Contributor

wing328 commented Mar 7, 2017

@ryanackley Thanks for the feedback. We'd a similar discussion in another thread.

I'll try to come up with the 1st version of the feature matrix by next week. Stay tuned.

@pgordon9
Copy link

pgordon9 commented Jul 26, 2017

Would love this as well. I think it will add trust in the CodeGen project.

@wing328
Copy link
Contributor

wing328 commented Jul 27, 2017

For the time being, I've created some issues with the following labels to list out features supported by different generators:

Feature List: API clients
Feature List: API documentations
Feature List: API servers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants