swagger-api/swagger-codegen

[Python] support type hints

Open

#5.429 geöffnet am 19. Apr. 2017

Auf GitHub ansehen
 (19 Kommentare) (34 Reaktionen) (0 zugewiesene Personen)HTML (12.701 Stars) (5.474 Forks)batch import
Client: PythonEnhancement: FeatureServer: Pythonhelp wanted

Beschreibung

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.

Contributor Guide

Tech Stack
pythonflask
Domain
backendapi
Issue Type
feature
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
3-5 days
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
stale
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
mostly clear
Voraussetzungen
Python type hints (PEP 484)Familiarity with swagger codegen generatorsFlask basics
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
30
Research-Richtung
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.