You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[python] typeddict camelcase docstrings like on the wire instead of snakecase #11355
This issue questions whether TypedDict parameter names in the Python client emitter should use snake_case (Python convention) or camelCase (as they appear on the wire).
Category: Feature Request (or possible bug, depending on intended behavior) Area: emitter:client:python
⚠️ No reproduction provided. A minimal repro showing the generated TypedDict and the expected vs actual naming would help clarify the issue.
🔍 Analysis
The Python client emitter (@typespec/http-client-python) generates TypedDict types for model parameters.
Python convention (PEP 8) favors snake_case for identifiers, but API wire formats typically use camelCase.
The question is whether the TypedDict keys should reflect Python naming conventions or mirror the wire/JSON representation.
This has usability implications: snake_case is more Pythonic but requires mapping when constructing requests/parsing responses.
No duplicate issues found.
📝 Suggested next steps
Clarify whether this is a bug (current behavior is unintentional) or a feature request (requesting a change or option).
Provide a minimal TypeSpec definition and show the generated TypedDict to illustrate the current behavior.
Consider whether an emitter option (snake_case vs camelCase) would be appropriate to support both use cases.
changed the title [-][python] typeddict camelcase params like on the wire instead of snakecase[/-][+][python] typeddict camelcase docstrings like on the wire instead of snakecase[/+]on Jul 22, 2026
Activity
github-actions commentedon Jul 22, 2026
🎯 Issue Triage
This issue questions whether
TypedDictparameter names in the Python client emitter should use snake_case (Python convention) or camelCase (as they appear on the wire).Category: Feature Request (or possible bug, depending on intended behavior)
Area:
emitter:client:python🔍 Analysis
@typespec/http-client-python) generatesTypedDicttypes for model parameters.snake_casefor identifiers, but API wire formats typically usecamelCase.📝 Suggested next steps
snake_casevscamelCase) would be appropriate to support both use cases.[-][python] typeddict camelcase params like on the wire instead of snakecase[/-][+][python] typeddict camelcase docstrings like on the wire instead of snakecase[/+][python] Use wire names in TypedDict docstrings (microsoft#11371)