Disambiguate shadowed builtins without API break

This suppresses A003 for `list` builtin.

`typing.List`, `typing.Dict`, `typing.Tuple` and `typing.Type` are
deprecated. Removing these annotations breaks the calls to `list` when
they are done within the same class scope, which makes them ambiguous.

Typed returns `list` resolve to the function `list` defined in the class,
shadowing the builtin function. This change is not great but a proper
one would require changing the name of the class function `list` and
breaking the API to be fixed.

Example of where it breaks:

podman/domains/images_manager.py

class ImagesManager(...):

    def list(...):
        ...

    def pull(
        self,
        ...
        ) -> Image | list[Image], [[str]]:
        ...

Here, the typed annotation of `pull` would resolve to the `list` method,
rather than the builtin.

Signed-off-by: Nicola Sella <[email protected]>

podman/domain/images_manager.py

@@ -32,6 +32,8 @@
 
 logger = logging.getLogger("podman.images")
 
+builtin_list = list
+
 
 class ImagesManager(BuildMixin, Manager):
     """Specialized Manager for Image resources."""
@@ -300,7 +302,7 @@ def push(
 
     @staticmethod
     def _push_helper(
-        decode: bool, body: list[dict[str, Any]]
+        decode: bool, body: builtin_list[dict[str, Any]]
     ) -> Iterator[Union[str, dict[str, Any]]]:
         """Helper needed to allow push() to return either a generator or a str."""
         for entry in body:
@@ -316,7 +318,7 @@ def pull(
         tag: Optional[str] = None,
         all_tags: bool = False,
         **kwargs,
-    ) -> Union[Image, list[Image], Iterator[str]]:
+    ) -> Union[Image, builtin_list[Image], Iterator[str]]:
         """Request Podman service to pull image(s) from repository.
 
         Args:
@@ -459,7 +461,7 @@ def remove(
         image: Union[Image, str],
         force: Optional[bool] = None,
         noprune: bool = False,  # pylint: disable=unused-argument
-    ) -> list[dict[Literal["Deleted", "Untagged", "Errors", "ExitCode"], Union[str, int]]]:
+    ) -> builtin_list[dict[Literal["Deleted", "Untagged", "Errors", "ExitCode"], Union[str, int]]]:
         """Delete image from Podman service.
 
         Args:
@@ -486,7 +488,7 @@ def remove(
         results.append({"ExitCode": body["ExitCode"]})
         return results
 
-    def search(self, term: str, **kwargs) -> list[dict[str, Any]]:
+    def search(self, term: str, **kwargs) -> builtin_list[dict[str, Any]]:
         """Search Images on registries.
 
         Args:

podman/domain/pods_manager.py

@@ -3,6 +3,7 @@
 import json
 import logging
 from typing import Any, Optional, Union
+from collections.abc import Iterator
 
 from podman import api
 from podman.domain.manager import Manager
@@ -11,6 +12,8 @@
 
 logger = logging.getLogger("podman.pods")
 
+builtin_list = list
+
 
 class PodsManager(Manager):
     """Specialized Manager for Pod resources."""
@@ -129,7 +132,9 @@ def remove(self, pod_id: Union[Pod, str], force: Optional[bool] = None) -> None:
         response = self.client.delete(f"/pods/{pod_id}", params={"force": force})
         response.raise_for_status()
 
-    def stats(self, **kwargs) -> Union[list[dict[str, Any]], [list[dict[str, Any]]]]:
+    def stats(
+        self, **kwargs
+    ) -> Union[builtin_list[dict[str, Any]], Iterator[builtin_list[dict[str, Any]]]]:
         """Resource usage statistics for the containers in pods.
 
         Keyword Args: