swagger-api/swagger-codegen

[Python] support type hints

Open

#5,429 创建于 2017年4月19日

在 GitHub 查看
 (19 评论) (34 反应) (0 负责人)HTML (12,701 star) (5,474 fork)batch import
Client: PythonEnhancement: FeatureServer: Pythonhelp wanted

描述

Description

We want to support type hints, which was introduced for Python 3.5+. The feature will be added to Python API client as well as server (Flask).

Since this option is for 3.5+ only, we will need to use the option supportPython2 to selectively disable it if supportPython2 (default to false) is set to true

Python version: 3.5+

Ref: https://www.python.org/dev/peps/pep-0484/

Suggest a Fix

If anyone from the community has questions/suggestions or wants to work on it, please reply to let us know. Thank you.

贡献者指南

技术栈
pythonflask
领域
backendapi
议题类型
feature
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
3-5 days
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
mostly clear
前置要求
Python type hints (PEP 484)Familiarity with swagger codegen generatorsFlask basics
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
30
研究方向
Investigate the swagger codegen Python generator templates (e.g., modules/swagger codegen/src/main/resources/python/). Understand the current template structure and how to conditionally output type annotations based on the `supportPython2` option. Review PEP 484 for type hint syntax. Examine related issues or PRs for prior attempts.