Can't use _typeshed in TYPE_CHECKING block

[nineteendo]

Example:

if TYPE_CHECKING:
    from _typeshed import StrPath

def foo(path: StrPath) -> StrPath:
    return path

Output (fails a build on read the docs):

WARNING: Failed guarded type import with ModuleNotFoundError("No module named '_typeshed'")

Stubs for _typeshed: https://github.com/python/typeshed/tree/main/stdlib/_typeshed

[gaborbernat]

I do not see how we can solve this, but if someone has ideas PR welcome. I would say for now do not use _typeshed imports.

[nineteendo]

Yeah, unless this can be implemented without executing the code block?

[gaborbernat]

The code block needs to be executed, otherwise we wouldn't be able to resolve some of the objects.