swagger-api/swagger-codegen

[Python] support type hints

Open

#5 429 ouverte le 19 avr. 2017

Voir sur GitHub
 (19 commentaires) (34 réactions) (0 assignés)HTML (12 701 stars) (5 474 forks)batch import
Client: PythonEnhancement: FeatureServer: Pythonhelp wanted

Description

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.

Guide contributeur

Stack technique
pythonflask
Domaine
backendapi
Type d'issue
feature
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
3-5 days
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
stale
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
mostly clear
Prérequis
Python type hints (PEP 484)Familiarity with swagger codegen generatorsFlask basics
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
30
Direction de recherche
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.