feat: vibe-coded PoC openapi-generator with document grounding and tab ai orchestration spec

[ZhongpinWang]

@mwien Vibe-coded solution using openapi-generator to give us some feeling about this generator. See the generated document grounding under document_grounding_generation and tab_ai_orchestration folders.

The extensions x-sap-cloud-sdk-... are supported via some workarounds in the preprocess_spec.py.

Demonstrated custom template.

Try to unify usage with generate.py with our generators in JS and Java SDK.

You can also find some sample code for these two services.

[mwien]

We would probably use httpx instead of urllib3 (there is an option for that). And then set supportHttpxSync to true to also get sync requests?

[ZhongpinWang]

We would probably use httpx instead of urllib3 (there is an option for that). And then set supportHttpxSync to true to also get sync requests?

Yes you are right, I was a bit in a rush and it contained quite some bugs.

Some updates since last Friday:

1. Now use httpx. proxy_client provides only all the headers (although it still is used for fetching auth tokens under the hood to set the correct Authorization header)
2. I also added sync support to the config. Yes later we will support both with httpx. I don't know when httpx2 will be an option, haven't investigated.
3. The sap openapi generator is just a wrapper with some customization written in python code. The script can be called from other packages with some configuration json. The Java OpenAPI generator actually supports method renaming as a configuration, so we only need to provide a list of mapping from operationId to the custom naming we want.
4. Aligned the options and cli interface a bit to the JS SDK generator.

All vibe coded of course to just have some feeling and see if any blockers. But overall this is the idea.