Skip to content

port autorest2 template to local generate tools #669

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

Merged
merged 8 commits into from
Aug 9, 2021

Conversation

tg123
Copy link
Member

@tg123 tg123 commented Jul 24, 2021

Port https://github.com/Azure/autorest.csharp/tree/master/src/vanilla/Templates/Rest template to local generate tools

Why #563
autorest2 is no longer maintained and we need to find a new swagger generator for the sdk.
also, there are many bugs caused by generator, for example, throw when 201 returned from server, which are not easy to get fixed.

the candidates are:

openapi-generator is most reasonable one, but new generator will cause tons of breaking changes.

as a result, templates form autorest were ported into mustache template and filled with nswagger objects. this is already used in watch and automapper code generation.

roadmap
near future, fix bugs and missing features due to autorest2, for example, expose client for keepalive.
long run, maybe act as a bridge to open-generator in order to have a smooth migration.

changes in this generator

  • 200 201 202 are all treated as success return code
  • IDictionary<string, IList<>> is now generated correctly (not in autorest2)
  • parameter pretty in watch was changed to string to align with kubernetes impl

test
all testcases passed and models field compared
generated interface/impl/extension only and run test to ensure generated code are compatible with old codes.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 24, 2021
@k8s-ci-robot k8s-ci-robot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Jul 24, 2021
@tg123
Copy link
Member Author

tg123 commented Jul 24, 2021

gh test #670

@tg123 tg123 mentioned this pull request Aug 8, 2021
@brendandburns
Copy link
Contributor

/lgtm
/approve

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 9, 2021
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: brendandburns, tg123

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 9, 2021
@k8s-ci-robot k8s-ci-robot merged commit b8f78e4 into kubernetes-client:master Aug 9, 2021
@tg123 tg123 deleted the localgen branch August 9, 2021 17:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants