chore(python): proper type hinting #20288

Job	Run time
setup	1m 7s
notification	9s
specs	1m 10s
scripts	0s
client javascript${{ (((needs.setup.outputs.RUN_GEN_JAVASCRIPT == 'true') && format('@{0}', fromJSON(needs.setup.outputs.JAVASCRIPT_DATA).version)) \|\| '') }}	0s
client python@3.8	3m 42s
client python@3.9	3m 56s
client python@3.10	3m 44s
client python@3.11	3m 42s
client python@3.12	4m 14s
codegen	1m 17s
client swift${{ (((needs.setup.outputs.RUN_MACOS_SWIFT_CTS == 'true') && format('@{0}', fromJSON(needs.setup.outputs.SWIFT_DATA).version)) \|\| '') }} macos	0s
client kotlin${{ (((needs.setup.outputs.RUN_MACOS_KOTLIN_BUILD == 'true') && format('@{0}', fromJSON(needs.setup.outputs.KOTLIN_DATA).version)) \|\| '') }} macos	0s
check_green	1s
push_and_release	0s
	23m 2s

Provide feedback