fix(http-client-python): api_version validation decorator reads correct config attribute name - #11392
Merged
Merged
Conversation
…ct config attribute name The generated _validation.py @api_version_validation decorator hardcoded `client._config.api_version`, but the config attribute name is derived from the API-version parameter's client_name. Specs that name the versioning parameter something other than `apiVersion` (e.g. Azure Storage Blob's `@apiVersion @Header("x-ms-version") version: string`, which produces `self.version`) hit an AttributeError that the decorator silently swallowed, disabling all API-version validation for those clients. Thread the real attribute name into the decorator via a `client_api_version_name` kwarg, emitted only when it differs from the default `api_version`. Also fix a latent NameError in the decorator's `unsupported` error-message branch that referenced an out-of-scope `version` variable. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
microsoft-github-policy-service
Bot
added
the
emitter:client:python
commit: |
Contributor
|
All changed packages have been documented.
Show changes
|
|
You can try these changes here
|
Contributor
Python emitter diffBaseline Diff summary: 4 file(s), +4 / -4 Rendered diff: inline on the run summary, or the emitter-diff-html artifact. Informational check (eng/emitter-diff); does not block the PR. |
…ion attribute fix Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
…he pylint suppression Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
…tattr Thread a client_api_version_getter (lambda config: config.<name>) into the decorator so the generated code reads self._config.<name> directly rather than via a getattr string lookup. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
Render config.<name> directly instead of threading a decorator kwarg; resolve the api-version attribute name once at package level from ConfigParameter.client_name. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
Read client._config.<name> directly; the baked-in short attribute name keeps the line under black's limit so the protected-access suppression stays attached. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e983f91-eed5-4191-b531-0eca9e696313
l0lawrence
commented
Jul 24, 2026
l0lawrence
marked this pull request as ready for review
July 24, 2026 21:22
l0lawrence
requested review from
ChenxiJiang333,
catalinaperalta,
iscai-msft,
kashifkhan,
lmazuel,
msyyc,
tadelesh and
timotheeguerin
as code owners
July 24, 2026 21:22
msyyc
approved these changes
Jul 27, 2026
timotheeguerin
pushed a commit
to timotheeguerin/typespec
that referenced
this pull request
Jul 30, 2026
Routine release of the `@typespec/http-client-python` emitter. ## Version bump `0.35.0` → `0.35.1` (patch) ## Changelog entries being released ### Bug Fixes - [microsoft#11371](microsoft#11371) Use wire names in TypedDict docstrings - [microsoft#11392](microsoft#11392) Fix the generated `_validation.py` `@api_version_validation` decorator so it reads the correct client config attribute for the API version (derived from the API-version parameter's `client_name`) instead of hardcoding `client._config.api_version`. - [microsoft#11272](microsoft#11272) Fix generated request builders serializing a `None` `content-type` header for an operation with an optional body whose content-type is required/constant. The `content-type` kwarg is now `Optional[str]` and the header is omitted when `None`. ### Internal (no changelog entry) - Track only hand-authored test fixture files instead of whole generated packages, and clean generated test code with `git clean` during regeneration. Generated via `chronus version --only "@typespec/http-client-python"`; only the http-client-python package is modified. Copilot-Session: caac437e-a2b9-40bf-b219-0454afb02bbf
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Root cause
The generated
_validation.py@api_version_validationdecorator (fromvalidation.py.jinja2) hardcoded:But the config attribute name is generated from the API-version parameter's
client_name(config.py.jinja2:self.{{ parameter.client_name }} = {{ parameter.client_name }}). Most specs name the paramapiVersion→self.api_version, so it works.Some specs name the versioning parameter
versioninstead — e.g. Azure Storage Blob, declared as@apiVersion @header("x-ms-version") version: string. Those clients getself.versionand notself.api_version, soclient._config.api_versionraisedAttributeError, which the decorator catches and silently no-ops. Result: all api-version validation was silently skipped for those clients.Caveat****: single shared decorator per package
_validation.pycontains a single shared@api_version_validationdecorator for the whole package, so only one api-version attribute name can be baked in._api_version_config_attr_name()therefore bakes the name only when all clients in the package agree on it; if a package ever had multiple clients using different api-version attribute names, the helper falls back to the conventionalapi_version. In practice a package's clients share one api-version name, which matches what_configuration.pygenerates.