This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: _typevar_types and _paramspec_tvars are missing from _GenericAlias.copy_with
Type: behavior Stage: resolved
Components: Library (Lib) Versions: Python 3.11, Python 3.10
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: Nosy List: JelleZijlstra, gvanrossum, kj, mbogosian, posita, serhiy.storchaka, sobolevn
Priority: normal Keywords: patch

Created on 2022-01-30 13:20 by posita, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 31061 merged mbogosian, 2022-02-01 17:07
PR 31821 merged mbogosian, 2022-03-11 13:58
Messages (8)
msg412144 - (view) Author: Matt B (posita) * Date: 2022-01-30 13:20
c55ff1b352f8b82184f80d9dea220e832691acfc was submitted to fix #44098 and added the _typevar_types and _paramspec_tvars properties to _GenericAlias. However, those properties continue to be omitted from _GenericAlias.copy_with[1].

Further, typing.py is fairly intricate, which makes it hard to understand if that is the only place those properties are absent. A more careful review/audit may be in order.

[1]: https://github.com/python/cpython/blob/8b1b27f1939cc4060531d198fdb09242f247ca7c/Lib/typing.py#L1069-L1070
msg412145 - (view) Author: Matt B (posita) * Date: 2022-01-30 13:23
Filed by request: https://github.com/python/cpython/pull/26091#issuecomment-1024900261
msg412149 - (view) Author: Ken Jin (kj) * (Python committer) Date: 2022-01-30 14:44
Wow! Thanks, that's an interesting find. My hunch is that we should be passing in _typevar_types and _paramspec_tvars in the copy_with of _GenericAlias and _ConcatenateGenericAlias. Inconsistent copy_with could trigger subtle bugs in ForwardRefs and get_type_hints. I can reproduce a semi-bug right now:

>>> P = ParamSpec('P')
>>> Callable[P, int].__parameters__
(~P,)
>>> Callable[P, int].copy_with((P,int))
typing.Callable[~P, int]
>>> Callable[P, int].copy_with((P,int)).__parameters__
()
^ This shouldn't be empty!!

Would you like to submit a patch for this?
msg412266 - (view) Author: Matt B (posita) * Date: 2022-02-01 14:41
I am happy to attempt a patch, but I don't understand what's going on with _ConcatenateGenericAlias. Or rather, I don't fully understand the various copy_with semantics. This code is *very* hard to follow.

Patching _GenericAlias.copy_with seems relatively straightforward:

     def copy_with(self, params):
-        return self.__class__(self.__origin__, params, name=self._name, inst=self._inst)
+        return self.__class__(self.__origin__, params, name=self._name, inst=self._inst,
+                              _typevar_types=self._typevar_types,
+                              _paramspec_tvars=self._paramspec_tvars)

_ConcatenateGenericAlias.copy_with, on the other hand, appears to return a tuple rather than a type until it falls back to the parent implementation. What does one do with that?

Also, what about _AnnotatedAlias, _SpecialGenericAlias, _UnionGenericAlias, or _strip_annotations? Do any of those need to be modified?

I can't find any tests that deal with copy_with directly, so I'm assuming its use is stressed via higher level code paths, but it's not clear what use cases that method is supposed to serve. The good news is that its use is confined to typing.py. The bad news is that file gives little insight to those who aren't already experts in that territory.

In short, I will do my best, but I suspect I will need patience and guidance in arriving something acceptable.
msg412274 - (view) Author: Ken Jin (kj) * (Python committer) Date: 2022-02-01 15:17
> In short, I will do my best, but I suspect I will need patience and guidance in arriving something acceptable.

Yeah no worries. typing.py is really complex for many historical reasons. I still don't grasp all of it and probably never will.

> what about _AnnotatedAlias, _SpecialGenericAlias, _UnionGenericAlias, or _strip_annotations?

They shouldn't need modification. And there's an elegant reason why. Currently ParamSpec is only valid in Generic, Callable and Concatenate. We don't care about any other types. As long as ParamSpec appears in their __parameters__ and the copy_with of those 3 have the correct settings.

Well what about when they're nested? The other types blindly copy over whatever they see in __parameters__ of any nested types. So even if you don't pass those settings to their copy_with, it doesn't matter (well of course, until someone else uses this setting and expands its scope, then proceeds to trip over it :(. this seems like a potential trap affecting PEP 646's runtime.)

>>> X = Concatenate[int, ParamSpec('P')]
>>> Container[X]
typing.Container[typing.Concatenate[int, ~P]]
>>> Container[X].copy_with(X).__parameters__
(~P,)
^ Works even though this uses _SpecialGenericAlias, which doesn't properly pass in the settings!

> I can't find any tests that deal with copy_with directly, so I'm assuming its use is stressed via higher level code paths, but it's not clear what use cases that method is supposed to serve.

Yeah. If you search for "copy_with" in typing.py. You'll find that it's called in __getitem__. Now __getitem__ is used when we subscript an already subscripted type. What I mean is:

T = TypeVar('T')
X = List[T] (__class_getitem__ is called, returning a new genericalias object)
X[int] (__getitem__ is called, returning a new genericalias object)

We need copy_with because we want to create a full "copy" of all the args into the new GenericAlias object and not face weird problems with mutability. That specific use case is tested super often.

> _ConcatenateGenericAlias.copy_with, on the other hand, appears to return a tuple rather than a type until it falls back to the parent implementation. What does one do with that?

Frankly, I was quite lost too until I saw that it was part of bpo-44791, which deals with special special (undefined) cases in PEP 612 and Concatenate. Basically for a very weird Concatenate, the core dev there has chosen to return a tuple of types instead of another type. Let's just ignore those strange tuple paths, and only care about the path using the parent implementation.
msg412283 - (view) Author: Matt B (posita) * Date: 2022-02-01 15:55
Thanks, @kj! Fantastic education and insight! I'm sad that I needed you as an interpreter but very grateful you were around to provide the interpretation. Working on a patch now….
msg414850 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2022-03-10 14:42
New changeset 32bf3597922ac3f613989582afa2bff43bea8a2f by Matt Bogosian in branch 'main':
bpo-46581: Propagate private vars via _GenericAlias.copy_with (GH-31061)
https://github.com/python/cpython/commit/32bf3597922ac3f613989582afa2bff43bea8a2f
msg414910 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2022-03-11 14:58
New changeset 3bc801960655ea265599805eac24173164b511a6 by Matt Bogosian in branch '3.10':
[3.10] bpo-46581: Propagate private vars via _GenericAlias.copy_with (GH-31061) (GH-31821)
https://github.com/python/cpython/commit/3bc801960655ea265599805eac24173164b511a6
History
Date User Action Args
2022-04-11 14:59:55adminsetgithub: 90739
2022-03-11 14:58:44serhiy.storchakasetstatus: open -> closed
resolution: fixed
stage: patch review -> resolved
2022-03-11 14:58:05serhiy.storchakasetmessages: + msg414910
2022-03-11 13:58:37mbogosiansetstage: backport needed -> patch review
pull_requests: + pull_request29919
2022-03-10 19:50:26AlexWaygoodsetnosy: + JelleZijlstra
2022-03-10 16:55:14AlexWaygoodsetstage: patch review -> backport needed
2022-03-10 14:42:42serhiy.storchakasetnosy: + serhiy.storchaka
messages: + msg414850
2022-02-01 17:07:49mbogosiansetkeywords: + patch
nosy: + mbogosian

pull_requests: + pull_request29243
stage: patch review
2022-02-01 15:55:33positasetmessages: + msg412283
2022-02-01 15:17:14kjsetmessages: + msg412274
2022-02-01 14:41:00positasetmessages: + msg412266
2022-01-30 14:44:34kjsetmessages: + msg412149
2022-01-30 14:42:27sobolevnsetnosy: + sobolevn
2022-01-30 13:35:56AlexWaygoodsetkeywords: - patch
2022-01-30 13:29:10AlexWaygoodsetpull_requests: - pull_request29201
2022-01-30 13:27:50AlexWaygoodsetnosy: + gvanrossum, kj, - miss-islington

type: behavior
stage: patch review -> (no value)
2022-01-30 13:23:00positasetmessages: + msg412145
2022-01-30 13:21:44miss-islingtonsetkeywords: + patch
nosy: + miss-islington

pull_requests: + pull_request29201
stage: patch review
2022-01-30 13:20:18positacreate