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.