Avoid import-time dependency on `typing` in common cases - #329

Draft

Sachaa-Thanasius wants to merge 10 commits into

python:mainfrom

Sachaa-Thanasius:avoid-runtime-typing-in-common-cases

Commits on Apr 7, 2025

Create a submodule with just Traversable to begin isolating import-time usage of typing constructs (in this case, Protocol).
Sachaa-Thanasius
committed
e466636
Add module-level __getattr__ and TYPE_CHECKING hack to importlib_resources.abc to 1) publicly export Traversable from importlib_resources._traversable and 2) use Traversable in internal annotations…
Sachaa-Thanasius
committed
edbcd90
Now that a previously unavoidable import-time dependency on typing has been removed from importlib_resources.abc, do the same for importlib_resources._common by avoiding typing.cast and avoiding ea…
Sachaa-Thanasius
committed
1904af5
Create a _typing submodule that lazily exports typing/annotation symbols. This will be used shortly to avoid import-time typing imports in importlib_resources_common and importlib_resources.abc.
Sachaa-Thanasius
committed
27cde7f
Adjust all annotations in importlib_resource.abc to be lazy, using the previously created _typing shim in conjunction with deferred annotations. This way, importlib_resources.abc never imports typi…
Sachaa-Thanasius
committed
d459459
Fix: Remove unnecessary quotes around annotation since rom __future__ import annotations is active.
Sachaa-Thanasius
committed
6f30c34
Adjust all annotations in importlib_resource._common to be lazy, using the previously created _typing shim in conjunction with deferred annotations. This way, importlib_resources._common never impo…
Sachaa-Thanasius
committed
8a1fb18
Improve inspectability of modules by adding module-level __dir__ functions to complement the __getattr__ functions. Also, improve __getattr__ comments and ensure those functions have the same struc…
Sachaa-Thanasius
committed
d250ffa
Fix: Move __getattr__ shim for Anchor and Package to importlib_resources.__init__, since that's where it's eagerly imported from.
Sachaa-Thanasius
committed
1d58285
The most controversial step: Refactor functions in importlib_resources._common to not use functools.singledispatch, since singledispatch will always import typing.
Sachaa-Thanasius
committed
21e0bae