[docker-py] Fix Container.top() return type

Author: roberfi

stubs/docker/docker/api/container.pyi

@@ -6,7 +6,7 @@ from typing_extensions import TypeAlias
 from docker._types import WaitContainerResponse
 from docker.types.daemon import CancellableStream
 
-from ..types import ContainerConfig, EndpointConfig, HostConfig, NetworkingConfig
+from ..types import ContainerConfig, EndpointConfig, HostConfig, NetworkingConfig, TopResult
 
 @type_check_only
 class _HasId(TypedDict):
@@ -145,7 +145,7 @@ class ContainerApiMixin:
     def start(self, container: _Container) -> None: ...
     def stats(self, container: _Container, decode: bool | None = None, stream: bool = True, one_shot: bool | None = None): ...
     def stop(self, container: _Container, timeout: int | None = None) -> None: ...
-    def top(self, container: _Container, ps_args: str | None = None) -> str: ...
+    def top(self, container: _Container, ps_args: str | None = None) -> TopResult: ...
     def unpause(self, container: _Container) -> None: ...
     def update_container(
         self,

stubs/docker/docker/models/containers.pyi

@@ -6,7 +6,7 @@ from typing_extensions import NotRequired
 
 from docker._types import ContainerWeightDevice, WaitContainerResponse
 from docker.types import EndpointConfig
-from docker.types.containers import DeviceRequest, LogConfig, Ulimit
+from docker.types.containers import DeviceRequest, LogConfig, TopResult, Ulimit
 from docker.types.daemon import CancellableStream
 from docker.types.services import Mount
 
@@ -91,7 +91,7 @@ class Container(Model):
     def start(self) -> None: ...
     def stats(self, **kwargs): ...
     def stop(self, *, timeout: float | None = None) -> None: ...
-    def top(self, *, ps_args: str | None = None) -> str: ...
+    def top(self, *, ps_args: str | None = None) -> TopResult: ...
     def unpause(self): ...
     def update(
         self,

stubs/docker/docker/types/__init__.pyi

@@ -3,6 +3,7 @@ from .containers import (
     DeviceRequest as DeviceRequest,
     HostConfig as HostConfig,
     LogConfig as LogConfig,
+    TopResult as TopResult,
     Ulimit as Ulimit,
 )
 from .daemon import CancellableStream as CancellableStream

stubs/docker/docker/types/containers.pyi

@@ -1,6 +1,6 @@
 from _typeshed import Incomplete
 from collections.abc import Iterable, Mapping
-from typing import Any, Final, Literal
+from typing import Any, Final, Literal, TypedDict, type_check_only
 
 from docker._types import ContainerWeightDevice
 
@@ -172,3 +172,8 @@ class ContainerConfig(dict[str, Incomplete]):
         stop_timeout: int | None = None,
         runtime: str | None = None,
     ) -> None: ...
+
+@type_check_only
+class TopResult(TypedDict):
+    Titles: list[str]
+    Processes: list[list[str]]