importlib.resources.contents is deprecated

Author: sobolevn

stdlib/importlib/resources/__init__.pyi

@@ -5,7 +5,7 @@ from contextlib import AbstractContextManager
 from pathlib import Path
 from types import ModuleType
 from typing import Any, BinaryIO, Literal, TextIO
-from typing_extensions import TypeAlias
+from typing_extensions import TypeAlias, deprecated
 
 if sys.version_info >= (3, 11):
     from importlib.resources.abc import Traversable
@@ -64,6 +64,7 @@ else:
     def read_text(package: Package, resource: Resource, encoding: str = "utf-8", errors: str = "strict") -> str: ...
     def path(package: Package, resource: Resource) -> AbstractContextManager[Path, Literal[False]]: ...
     def is_resource(package: Package, name: str) -> bool: ...
+    @deprecated("Deprecated since Python 3.11, use `files(anchor).iterdir()`")
     def contents(package: Package) -> Iterator[str]: ...
 
 if sys.version_info >= (3, 11):

stdlib/importlib/resources/_functional.pyi

@@ -9,7 +9,7 @@ if sys.version_info >= (3, 13):
     from io import TextIOWrapper
     from pathlib import Path
     from typing import BinaryIO, Literal, overload
-    from typing_extensions import Unpack
+    from typing_extensions import Unpack, deprecated
 
     def open_binary(anchor: Anchor, *path_names: StrPath) -> BinaryIO: ...
     @overload
@@ -27,4 +27,5 @@ if sys.version_info >= (3, 13):
     def read_text(anchor: Anchor, *path_names: StrPath, encoding: str | None, errors: str | None = "strict") -> str: ...
     def path(anchor: Anchor, *path_names: StrPath) -> AbstractContextManager[Path, Literal[False]]: ...
     def is_resource(anchor: Anchor, *path_names: StrPath) -> bool: ...
+    @deprecated("Deprecated since Python 3.11, use `files(anchor).iterdir()`")
     def contents(anchor: Anchor, *path_names: StrPath) -> Iterator[str]: ...