Add Type Hinting with Upgraded OpenAPI

[andyliu14]

kubernetes-client/python#1984

See related issue on Kubernetes. It looks like modern versions of openapi generator can generate api objects with type hinting baked in for much easier QOL for devs. This would be great to have to bump up the version of the generator to latest and regenerate.

[pierrejeambrun]

That's has been considered for a while but new versions of the generator are breaking and not backward compatible in terms of generated client. This is mainly the reason why we never upgraded it past a certain point.

We are preparing airflow 3 (Q1 / Q2 of 2025) and this will be upgraded then I believe.

[pierrejeambrun]

People can definitely start working on that preparing for airflow 3 using the new FastAPI API that we are developing for airflow 3.

On main, the openapi spec file is https://github.com/apache/airflow/blob/main/airflow/api_fastapi/core_api/openapi/v1-generated.yaml.

And we should start playing around to see what type of client is generated with an updated generator and if it works well with our spec.