modal 1.1.5.dev83__py3-none-any.whl → 1.3.1.dev8__py3-none-any.whl

modal/parallel_map.pyi

@@ -5,6 +5,7 @@ import collections.abc
 import enum
 import modal._functions
 import modal._utils.async_utils
+import modal._utils.grpc_utils
 import modal.client
 import modal.functions
 import modal.retries
@@ -18,31 +19,29 @@ class _SynchronizedQueue:
     async def put(self, item): ...
     async def get(self): ...
 
-SUPERSELF = typing.TypeVar("SUPERSELF", covariant=True)
-
 class SynchronizedQueue:
     """mdmd:hidden"""
     def __init__(self, /, *args, **kwargs):
         """Initialize self.  See help(type(self)) for accurate signature."""
         ...
 
-    class __init_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __init_spec(typing_extensions.Protocol):
         def __call__(self, /): ...
         async def aio(self, /): ...
 
-    init: __init_spec[typing_extensions.Self]
+    init: __init_spec
 
-    class __put_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __put_spec(typing_extensions.Protocol):
         def __call__(self, /, item): ...
         async def aio(self, /, item): ...
 
-    put: __put_spec[typing_extensions.Self]
+    put: __put_spec
 
-    class __get_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __get_spec(typing_extensions.Protocol):
         def __call__(self, /): ...
         async def aio(self, /): ...
 
-    get: __get_spec[typing_extensions.Self]
+    get: __get_spec
 
 class _OutputValue:
     """_OutputValue(value: Any)"""
@@ -96,15 +95,8 @@ class InputPumper:
         ...
 
     def pump_inputs(self): ...
-    async def _send_inputs(
-        self,
-        fn: modal.client.UnaryUnaryWrapper,
-        request: typing.Union[
-            modal_proto.api_pb2.FunctionPutInputsRequest, modal_proto.api_pb2.FunctionRetryInputsRequest
-        ],
-    ) -> typing.Union[
-        modal_proto.api_pb2.FunctionPutInputsResponse, modal_proto.api_pb2.FunctionRetryInputsResponse
-    ]: ...
+    @property
+    def _function_inputs_retry(self) -> modal._utils.grpc_utils.Retry: ...
 
 class SyncInputPumper(InputPumper):
     """Reads inputs from a queue of FunctionPutInputsItems, and sends them to the server."""

modal/partial_function.pyi

@@ -53,7 +53,6 @@ class PartialFunction(
     ) -> modal.functions.Function[
         modal._partial_function.P, modal._partial_function.ReturnType, modal._partial_function.OriginalReturnType
     ]: ...
-    def __del__(self): ...
 
 def method(
     _warn_parentheses_missing=None, *, is_generator: typing.Optional[bool] = None
@@ -329,7 +328,10 @@ def batched(
     ...
 
 def concurrent(
-    _warn_parentheses_missing=None, *, max_inputs: int, target_inputs: typing.Optional[int] = None
+    _warn_parentheses_missing=None,
+    *,
+    max_inputs: typing.Optional[int] = None,
+    target_inputs: typing.Optional[int] = None,
 ) -> collections.abc.Callable[
     [
         typing.Union[

modal/proxy.py

@@ -3,9 +3,11 @@ from typing import Optional
 
 from modal_proto import api_pb2
 
-from ._object import _get_environment_name, _Object
+from ._load_context import LoadContext
+from ._object import _Object
 from ._resolver import Resolver
 from ._utils.async_utils import synchronize_api
+from .client import _Client
 
 
 class _Proxy(_Object, type_prefix="pr"):
@@ -20,6 +22,7 @@ class _Proxy(_Object, type_prefix="pr"):
         name: str,
         *,
         environment_name: Optional[str] = None,
+        client: Optional[_Client] = None,
     ) -> "_Proxy":
         """Reference a Proxy by its name.
 
@@ -28,16 +31,21 @@ class _Proxy(_Object, type_prefix="pr"):
 
         """
 
-        async def _load(self: _Proxy, resolver: Resolver, existing_object_id: Optional[str]):
+        async def _load(self: _Proxy, resolver: Resolver, load_context: LoadContext, existing_object_id: Optional[str]):
             req = api_pb2.ProxyGetRequest(
                 name=name,
-                environment_name=_get_environment_name(environment_name, resolver),
+                environment_name=load_context.environment_name,
             )
-            response: api_pb2.ProxyGetResponse = await resolver.client.stub.ProxyGet(req)
-            self._hydrate(response.proxy.proxy_id, resolver.client, None)
+            response: api_pb2.ProxyGetResponse = await load_context.client.stub.ProxyGet(req)
+            self._hydrate(response.proxy.proxy_id, load_context.client, None)
 
         rep = _Proxy._repr(name, environment_name)
-        return _Proxy._from_loader(_load, rep, is_another_app=True)
+        return _Proxy._from_loader(
+            _load,
+            rep,
+            is_another_app=True,
+            load_context_overrides=LoadContext(client=client, environment_name=environment_name),
+        )
 
 
 Proxy = synchronize_api(_Proxy, target_module=__name__)

modal/proxy.pyi

@@ -1,4 +1,5 @@
 import modal._object
+import modal.client
 import modal.object
 import typing
 
@@ -9,7 +10,12 @@ class _Proxy(modal._object._Object):
     a database. See [the guide](https://modal.com/docs/guide/proxy-ips) for more information.
     """
     @staticmethod
-    def from_name(name: str, *, environment_name: typing.Optional[str] = None) -> _Proxy:
+    def from_name(
+        name: str,
+        *,
+        environment_name: typing.Optional[str] = None,
+        client: typing.Optional[modal.client._Client] = None,
+    ) -> _Proxy:
         """Reference a Proxy by its name.
 
         In contrast to most other Modal objects, new Proxy objects must be
@@ -28,7 +34,9 @@ class Proxy(modal.object.Object):
         ...
 
     @staticmethod
-    def from_name(name: str, *, environment_name: typing.Optional[str] = None) -> Proxy:
+    def from_name(
+        name: str, *, environment_name: typing.Optional[str] = None, client: typing.Optional[modal.client.Client] = None
+    ) -> Proxy:
         """Reference a Proxy by its name.
 
         In contrast to most other Modal objects, new Proxy objects must be

modal/queue.py

@@ -1,4 +1,5 @@
 # Copyright Modal Labs 2022
+import builtins
 import queue  # The system library
 import time
 import warnings
@@ -8,12 +9,13 @@ from datetime import datetime
 from typing import Any, Optional, Union
 
 from google.protobuf.message import Message
-from grpclib import GRPCError, Status
+from grpclib import Status
 from synchronicity import classproperty
 from synchronicity.async_wrap import asynccontextmanager
 
 from modal_proto import api_pb2
 
+from ._load_context import LoadContext
 from ._object import (
     EPHEMERAL_OBJECT_HEARTBEAT_SLEEP,
     _get_environment_name,
@@ -25,11 +27,11 @@ from ._resolver import Resolver
 from ._serialization import deserialize, serialize
 from ._utils.async_utils import TaskContext, synchronize_api, warn_if_generator_is_not_consumed
 from ._utils.deprecation import deprecation_warning, warn_if_passing_namespace
-from ._utils.grpc_utils import retry_transient_errors
+from ._utils.grpc_utils import Retry
 from ._utils.name_utils import check_object_name
 from ._utils.time_utils import as_timestamp, timestamp_to_localized_dt
 from .client import _Client
-from .exception import AlreadyExistsError, InvalidError, NotFoundError, RequestSizeError
+from .exception import AlreadyExistsError, Error, InvalidError, NotFoundError, RequestSizeError, ResourceExhaustedError
 
 
 @dataclass
@@ -95,11 +97,9 @@ class _QueueManager:
             object_creation_type=object_creation_type,
         )
         try:
-            await retry_transient_errors(client.stub.QueueGetOrCreate, req)
-        except GRPCError as exc:
-            if exc.status == Status.ALREADY_EXISTS and not allow_existing:
-                raise AlreadyExistsError(exc.message)
-            else:
+            await client.stub.QueueGetOrCreate(req)
+        except AlreadyExistsError:
+            if not allow_existing:
                 raise
 
     @staticmethod
@@ -109,7 +109,7 @@ class _QueueManager:
         created_before: Optional[Union[datetime, str]] = None,  # Limit based on creation date
         environment_name: str = "",  # Uses active environment if not specified
         client: Optional[_Client] = None,  # Optional client with Modal credentials
-    ) -> list["_Queue"]:
+    ) -> builtins.list["_Queue"]:
         """Return a list of hydrated Queue objects.
 
         **Examples:**
@@ -147,7 +147,7 @@ class _QueueManager:
             req = api_pb2.QueueListRequest(
                 environment_name=_get_environment_name(environment_name), pagination=pagination
             )
-            resp = await retry_transient_errors(client.stub.QueueList, req)
+            resp = await client.stub.QueueList(req)
             items.extend(resp.queues)
             finished = (len(resp.queues) < max_page_size) or (max_objects is not None and len(items) >= max_objects)
             return finished
@@ -205,7 +205,7 @@ class _QueueManager:
                 raise
         else:
             req = api_pb2.QueueDeleteRequest(queue_id=obj.object_id)
-            await retry_transient_errors(obj._client.stub.QueueDelete, req)
+            await obj._client.stub.QueueDelete(req)
 
 
 QueueManager = synchronize_api(_QueueManager)
@@ -361,6 +361,7 @@ class _Queue(_Object, type_prefix="qu"):
         namespace=None,  # mdmd:line-hidden
         environment_name: Optional[str] = None,
         create_if_missing: bool = False,
+        client: Optional[_Client] = None,
     ) -> "_Queue":
         """Reference a named Queue, creating if necessary.
 
@@ -376,17 +377,24 @@ class _Queue(_Object, type_prefix="qu"):
         check_object_name(name, "Queue")
         warn_if_passing_namespace(namespace, "modal.Queue.from_name")
 
-        async def _load(self: _Queue, resolver: Resolver, existing_object_id: Optional[str]):
+        async def _load(self: _Queue, resolver: Resolver, load_context: LoadContext, existing_object_id: Optional[str]):
             req = api_pb2.QueueGetOrCreateRequest(
                 deployment_name=name,
-                environment_name=_get_environment_name(environment_name, resolver),
+                environment_name=load_context.environment_name,
                 object_creation_type=(api_pb2.OBJECT_CREATION_TYPE_CREATE_IF_MISSING if create_if_missing else None),
             )
-            response = await resolver.client.stub.QueueGetOrCreate(req)
-            self._hydrate(response.queue_id, resolver.client, response.metadata)
+            response = await load_context.client.stub.QueueGetOrCreate(req)
+            self._hydrate(response.queue_id, load_context.client, response.metadata)
 
         rep = _Queue._repr(name, environment_name)
-        return _Queue._from_loader(_load, rep, is_another_app=True, hydrate_lazily=True, name=name)
+        return _Queue._from_loader(
+            _load,
+            rep,
+            is_another_app=True,
+            hydrate_lazily=True,
+            name=name,
+            load_context_overrides=LoadContext(environment_name=environment_name, client=client),
+        )
 
     @staticmethod
     async def delete(name: str, *, client: Optional[_Client] = None, environment_name: Optional[str] = None):
@@ -424,7 +432,7 @@ class _Queue(_Object, type_prefix="qu"):
             n_values=n_values,
         )
 
-        response = await retry_transient_errors(self._client.stub.QueueGet, request)
+        response = await self._client.stub.QueueGet(request)
         if response.values:
             return [deserialize(value, self._client) for value in response.values]
         else:
@@ -449,7 +457,7 @@ class _Queue(_Object, type_prefix="qu"):
                 n_values=n_values,
             )
 
-            response = await retry_transient_errors(self._client.stub.QueueGet, request)
+            response = await self._client.stub.QueueGet(request)
 
             if response.values:
                 return [deserialize(value, self._client) for value in response.values]
@@ -469,7 +477,7 @@ class _Queue(_Object, type_prefix="qu"):
             partition_key=self.validate_partition_key(partition),
             all_partitions=all,
         )
-        await retry_transient_errors(self._client.stub.QueueClear, request)
+        await self._client.stub.QueueClear(request)
 
     @live_method
     async def get(
@@ -578,21 +586,22 @@ class _Queue(_Object, type_prefix="qu"):
             partition_ttl_seconds=partition_ttl,
         )
         try:
-            await retry_transient_errors(
-                self._client.stub.QueuePut,
+            await self._client.stub.QueuePut(
                 request,
                 # A full queue will return this status.
-                additional_status_codes=[Status.RESOURCE_EXHAUSTED],
-                max_delay=30.0,
-                max_retries=None,
-                total_timeout=timeout,
+                retry=Retry(
+                    additional_status_codes=[Status.RESOURCE_EXHAUSTED],
+                    max_delay=30.0,
+                    max_retries=None,
+                    total_timeout=timeout,
+                ),
             )
-        except GRPCError as exc:
-            if exc.status == Status.RESOURCE_EXHAUSTED:
-                raise queue.Full(str(exc))
-            elif "status = '413'" in exc.message:
+        except Error as exc:
+            if "status = '413'" in str(exc):
                 method = "put_many" if len(vs) > 1 else "put"
                 raise RequestSizeError(f"Queue.{method} request is too large") from exc
+            elif isinstance(exc, ResourceExhaustedError):
+                raise queue.Full(str(exc))
             else:
                 raise exc
 
@@ -605,13 +614,13 @@ class _Queue(_Object, type_prefix="qu"):
             partition_ttl_seconds=partition_ttl,
         )
         try:
-            await retry_transient_errors(self._client.stub.QueuePut, request)
-        except GRPCError as exc:
-            if exc.status == Status.RESOURCE_EXHAUSTED:
-                raise queue.Full(exc.message)
-            elif "status = '413'" in exc.message:
+            await self._client.stub.QueuePut(request)
+        except Error as exc:
+            if "status = '413'" in str(exc):
                 method = "put_many" if len(vs) > 1 else "put"
                 raise RequestSizeError(f"Queue.{method} request is too large") from exc
+            elif isinstance(exc, ResourceExhaustedError):
+                raise queue.Full(str(exc))
             else:
                 raise exc
 
@@ -625,7 +634,7 @@ class _Queue(_Object, type_prefix="qu"):
             partition_key=self.validate_partition_key(partition),
             total=total,
         )
-        response = await retry_transient_errors(self._client.stub.QueueLen, request)
+        response = await self._client.stub.QueueLen(request)
         return response.len
 
     @warn_if_generator_is_not_consumed()
@@ -651,9 +660,7 @@ class _Queue(_Object, type_prefix="qu"):
                 item_poll_timeout=poll_duration,
             )
 
-            response: api_pb2.QueueNextItemsResponse = await retry_transient_errors(
-                self._client.stub.QueueNextItems, request
-            )
+            response: api_pb2.QueueNextItemsResponse = await self._client.stub.QueueNextItems(request)
             if response.items:
                 for item in response.items:
                     yield deserialize(item.value, self._client)

modal/queue.pyi

@@ -213,7 +213,7 @@ class QueueManager:
             """
             ...
 
-    create: __create_spec
+    create: typing.ClassVar[__create_spec]
 
     class __list_spec(typing_extensions.Protocol):
         def __call__(
@@ -286,7 +286,7 @@ class QueueManager:
             """
             ...
 
-    list: __list_spec
+    list: typing.ClassVar[__list_spec]
 
     class __delete_spec(typing_extensions.Protocol):
         def __call__(
@@ -349,7 +349,7 @@ class QueueManager:
             """
             ...
 
-    delete: __delete_spec
+    delete: typing.ClassVar[__delete_spec]
 
 class _Queue(modal._object._Object):
     """Distributed, FIFO queue for data flow in Modal apps.
@@ -464,7 +464,12 @@ class _Queue(modal._object._Object):
 
     @staticmethod
     def from_name(
-        name: str, *, namespace=None, environment_name: typing.Optional[str] = None, create_if_missing: bool = False
+        name: str,
+        *,
+        namespace=None,
+        environment_name: typing.Optional[str] = None,
+        create_if_missing: bool = False,
+        client: typing.Optional[modal.client._Client] = None,
     ) -> _Queue:
         """Reference a named Queue, creating if necessary.
 
@@ -606,8 +611,6 @@ class _Queue(modal._object._Object):
         """
         ...
 
-SUPERSELF = typing.TypeVar("SUPERSELF", covariant=True)
-
 class Queue(modal.object.Object):
     """Distributed, FIFO queue for data flow in Modal apps.
 
@@ -695,33 +698,66 @@ class Queue(modal.object.Object):
     def _get_metadata(self) -> modal_proto.api_pb2.QueueMetadata: ...
     @staticmethod
     def validate_partition_key(partition: typing.Optional[str]) -> bytes: ...
-    @classmethod
-    def ephemeral(
-        cls: type[Queue],
-        client: typing.Optional[modal.client.Client] = None,
-        environment_name: typing.Optional[str] = None,
-        _heartbeat_sleep: float = 300,
-    ) -> synchronicity.combined_types.AsyncAndBlockingContextManager[Queue]:
-        """Creates a new ephemeral queue within a context manager:
 
-        Usage:
-        ```python
-        from modal import Queue
+    class __ephemeral_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            /,
+            client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
+            _heartbeat_sleep: float = 300,
+        ) -> synchronicity.combined_types.AsyncAndBlockingContextManager[Queue]:
+            """Creates a new ephemeral queue within a context manager:
 
-        with Queue.ephemeral() as q:
-            q.put(123)
-        ```
+            Usage:
+            ```python
+            from modal import Queue
 
-        ```python notest
-        async with Queue.ephemeral() as q:
-            await q.put.aio(123)
-        ```
-        """
-        ...
+            with Queue.ephemeral() as q:
+                q.put(123)
+            ```
+
+            ```python notest
+            async with Queue.ephemeral() as q:
+                await q.put.aio(123)
+            ```
+            """
+            ...
+
+        def aio(
+            self,
+            /,
+            client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
+            _heartbeat_sleep: float = 300,
+        ) -> typing.AsyncContextManager[Queue]:
+            """Creates a new ephemeral queue within a context manager:
+
+            Usage:
+            ```python
+            from modal import Queue
+
+            with Queue.ephemeral() as q:
+                q.put(123)
+            ```
+
+            ```python notest
+            async with Queue.ephemeral() as q:
+                await q.put.aio(123)
+            ```
+            """
+            ...
+
+    ephemeral: typing.ClassVar[__ephemeral_spec]
 
     @staticmethod
     def from_name(
-        name: str, *, namespace=None, environment_name: typing.Optional[str] = None, create_if_missing: bool = False
+        name: str,
+        *,
+        namespace=None,
+        environment_name: typing.Optional[str] = None,
+        create_if_missing: bool = False,
+        client: typing.Optional[modal.client.Client] = None,
     ) -> Queue:
         """Reference a named Queue, creating if necessary.
 
@@ -773,9 +809,9 @@ class Queue(modal.object.Object):
             """
             ...
 
-    delete: __delete_spec
+    delete: typing.ClassVar[__delete_spec]
 
-    class __info_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __info_spec(typing_extensions.Protocol):
         def __call__(self, /) -> QueueInfo:
             """Return information about the Queue object."""
             ...
@@ -784,15 +820,15 @@ class Queue(modal.object.Object):
             """Return information about the Queue object."""
             ...
 
-    info: __info_spec[typing_extensions.Self]
+    info: __info_spec
 
-    class ___get_nonblocking_spec(typing_extensions.Protocol[SUPERSELF]):
+    class ___get_nonblocking_spec(typing_extensions.Protocol):
         def __call__(self, /, partition: typing.Optional[str], n_values: int) -> list[typing.Any]: ...
         async def aio(self, /, partition: typing.Optional[str], n_values: int) -> list[typing.Any]: ...
 
-    _get_nonblocking: ___get_nonblocking_spec[typing_extensions.Self]
+    _get_nonblocking: ___get_nonblocking_spec
 
-    class ___get_blocking_spec(typing_extensions.Protocol[SUPERSELF]):
+    class ___get_blocking_spec(typing_extensions.Protocol):
         def __call__(
             self, /, partition: typing.Optional[str], timeout: typing.Optional[float], n_values: int
         ) -> list[typing.Any]: ...
@@ -800,9 +836,9 @@ class Queue(modal.object.Object):
             self, /, partition: typing.Optional[str], timeout: typing.Optional[float], n_values: int
         ) -> list[typing.Any]: ...
 
-    _get_blocking: ___get_blocking_spec[typing_extensions.Self]
+    _get_blocking: ___get_blocking_spec
 
-    class __clear_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __clear_spec(typing_extensions.Protocol):
         def __call__(self, /, *, partition: typing.Optional[str] = None, all: bool = False) -> None:
             """Clear the contents of a single partition or all partitions."""
             ...
@@ -811,9 +847,9 @@ class Queue(modal.object.Object):
             """Clear the contents of a single partition or all partitions."""
             ...
 
-    clear: __clear_spec[typing_extensions.Self]
+    clear: __clear_spec
 
-    class __get_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __get_spec(typing_extensions.Protocol):
         def __call__(
             self,
             /,
@@ -852,9 +888,9 @@ class Queue(modal.object.Object):
             """
             ...
 
-    get: __get_spec[typing_extensions.Self]
+    get: __get_spec
 
-    class __get_many_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __get_many_spec(typing_extensions.Protocol):
         def __call__(
             self,
             /,
@@ -899,9 +935,9 @@ class Queue(modal.object.Object):
             """
             ...
 
-    get_many: __get_many_spec[typing_extensions.Self]
+    get_many: __get_many_spec
 
-    class __put_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __put_spec(typing_extensions.Protocol):
         def __call__(
             self,
             /,
@@ -944,9 +980,9 @@ class Queue(modal.object.Object):
             """
             ...
 
-    put: __put_spec[typing_extensions.Self]
+    put: __put_spec
 
-    class __put_many_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __put_many_spec(typing_extensions.Protocol):
         def __call__(
             self,
             /,
@@ -989,9 +1025,9 @@ class Queue(modal.object.Object):
             """
             ...
 
-    put_many: __put_many_spec[typing_extensions.Self]
+    put_many: __put_many_spec
 
-    class ___put_many_blocking_spec(typing_extensions.Protocol[SUPERSELF]):
+    class ___put_many_blocking_spec(typing_extensions.Protocol):
         def __call__(
             self,
             /,
@@ -1009,15 +1045,15 @@ class Queue(modal.object.Object):
             timeout: typing.Optional[float] = None,
         ): ...
 
-    _put_many_blocking: ___put_many_blocking_spec[typing_extensions.Self]
+    _put_many_blocking: ___put_many_blocking_spec
 
-    class ___put_many_nonblocking_spec(typing_extensions.Protocol[SUPERSELF]):
+    class ___put_many_nonblocking_spec(typing_extensions.Protocol):
         def __call__(self, /, partition: typing.Optional[str], partition_ttl: int, vs: list[typing.Any]): ...
         async def aio(self, /, partition: typing.Optional[str], partition_ttl: int, vs: list[typing.Any]): ...
 
-    _put_many_nonblocking: ___put_many_nonblocking_spec[typing_extensions.Self]
+    _put_many_nonblocking: ___put_many_nonblocking_spec
 
-    class __len_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __len_spec(typing_extensions.Protocol):
         def __call__(self, /, *, partition: typing.Optional[str] = None, total: bool = False) -> int:
             """Return the number of objects in the queue partition."""
             ...
@@ -1026,9 +1062,9 @@ class Queue(modal.object.Object):
             """Return the number of objects in the queue partition."""
             ...
 
-    len: __len_spec[typing_extensions.Self]
+    len: __len_spec
 
-    class __iterate_spec(typing_extensions.Protocol[SUPERSELF]):
+    class __iterate_spec(typing_extensions.Protocol):
         def __call__(
             self, /, *, partition: typing.Optional[str] = None, item_poll_timeout: float = 0.0
         ) -> typing.Generator[typing.Any, None, None]:
@@ -1047,4 +1083,4 @@ class Queue(modal.object.Object):
             """
             ...
 
-    iterate: __iterate_spec[typing_extensions.Self]
+    iterate: __iterate_spec