modal 1.1.2.dev43__py3-none-any.whl → 1.1.3.dev0__py3-none-any.whl

modal/_functions.py

@@ -9,7 +9,7 @@ import warnings
 from collections.abc import AsyncGenerator, Sequence, Sized
 from dataclasses import dataclass
 from pathlib import PurePosixPath
-from typing import TYPE_CHECKING, Any, Callable, Optional, Union
+from typing import TYPE_CHECKING, Any, AsyncIterator, Callable, Optional, Union
 
 import typing_extensions
 from google.protobuf.message import Message
@@ -360,6 +360,43 @@ class _Invocation:
                 if items_total is not None and items_received >= items_total:
                     break
 
+    async def enumerate(self, start_index: int, end_index: int):
+        """Iterate over the results of the function call in the range [start_index, end_index)."""
+        limit = 49
+        current_index = start_index
+        while current_index < end_index:
+            # batch_end_indx is inclusive, so we subtract 1 to get the last index in the batch.
+            batch_end_index = min(current_index + limit, end_index) - 1
+            request = api_pb2.FunctionGetOutputsRequest(
+                function_call_id=self.function_call_id,
+                timeout=0,
+                last_entry_id="0-0",
+                clear_on_success=False,
+                requested_at=time.time(),
+                start_idx=current_index,
+                end_idx=batch_end_index,
+            )
+            response: api_pb2.FunctionGetOutputsResponse = await retry_transient_errors(
+                self.stub.FunctionGetOutputs,
+                request,
+                attempt_timeout=ATTEMPT_TIMEOUT_GRACE_PERIOD,
+            )
+
+            outputs = list(response.outputs)
+            outputs.sort(key=lambda x: x.idx)
+            for output in outputs:
+                if output.idx != current_index:
+                    break
+                result = await _process_result(output.result, output.data_format, self.stub, self.client)
+                yield output.idx, result
+                current_index += 1
+
+            # We're missing current_index, so we need to poll the function for the next result
+            if len(outputs) < (batch_end_index - current_index + 1):
+                result = await self.poll_function(index=current_index)
+                yield current_index, result
+                current_index += 1
+
 
 class _InputPlaneInvocation:
     """Internal client representation of a single-input call to a Modal Function using the input
@@ -1865,6 +1902,36 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         """
         return await self._invocation().poll_function(timeout=timeout, index=index)
 
+    @live_method_gen
+    async def iter(self, *, start: int = 0, end: Optional[int] = None) -> AsyncIterator[ReturnType]:
+        """Iterate in-order over the results of the function call.
+
+        Optionally, specify a range [start, end) to iterate over.
+
+        Example:
+        ```python
+        @app.function()
+        def my_func(a):
+            return a ** 2
+
+
+        @app.local_entrypoint()
+        def main():
+            fc = my_func.spawn_map([1, 2, 3, 4])
+            assert list(fc.iter()) == [1, 4, 9, 16]
+            assert list(fc.iter(start=1, end=3)) == [4, 9]
+        ```
+
+        If `end` is not provided, it will iterate over all results.
+        """
+        num_inputs = await self.num_inputs()
+        if end is None:
+            end = num_inputs
+        if start < 0 or end > num_inputs:
+            raise ValueError(f"Invalid index range: {start} to {end} for {num_inputs} inputs")
+        async for _, item in self._invocation().enumerate(start_index=start, end_index=end):
+            yield item
+
     async def get_call_graph(self) -> list[InputInfo]:
         """Returns a structure representing the call graph from a given root
         call ID, along with the status of execution for each node.

modal/app.py

@@ -641,7 +641,7 @@ class _App:
         scaledown_window: Optional[int] = None,  # Max time (in seconds) a container can remain idle while scaling down.
         proxy: Optional[_Proxy] = None,  # Reference to a Modal Proxy to use in front of this function.
         retries: Optional[Union[int, Retries]] = None,  # Number of times to retry each input in case of failure.
-        timeout: int = 300,  # Maximum execution time of the function in seconds.
+        timeout: int = 300,  # Maximum execution time in seconds.
         name: Optional[str] = None,  # Sets the Modal name of the function within the app
         is_generator: Optional[
             bool
@@ -869,7 +869,7 @@ class _App:
         scaledown_window: Optional[int] = None,  # Max time (in seconds) a container can remain idle while scaling down.
         proxy: Optional[_Proxy] = None,  # Reference to a Modal Proxy to use in front of this function.
         retries: Optional[Union[int, Retries]] = None,  # Number of times to retry each input in case of failure.
-        timeout: int = 300,  # Maximum execution time of the function in seconds.
+        timeout: int = 300,  # Maximum execution time in seconds; applies independently to startup and each input.
         cloud: Optional[str] = None,  # Cloud provider to run the function on. Possible values are aws, gcp, oci, auto.
         region: Optional[Union[str, Sequence[str]]] = None,  # Region or regions to run the function on.
         enable_memory_snapshot: bool = False,  # Enable memory checkpointing for faster cold starts.

modal/client.pyi

@@ -33,7 +33,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.1.2.dev43",
+        version: str = "1.1.3.dev0",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -164,7 +164,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.1.2.dev43",
+        version: str = "1.1.3.dev0",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/dict.py

@@ -81,6 +81,8 @@ class _DictManager:
         Note that this method does not return a local instance of the Dict. You can use
         `modal.Dict.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Dict")
         client = await _Client.from_env() if client is None else client
@@ -132,6 +134,8 @@ class _DictManager:
         dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -192,6 +196,9 @@ class _DictManager:
         ```python notest
         await modal.Dict.objects.delete("my-dict", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Dict.from_name(name, environment_name=environment_name).hydrate(client)

modal/dict.pyi

@@ -66,6 +66,8 @@ class _DictManager:
 
         Note that this method does not return a local instance of the Dict. You can use
         `modal.Dict.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -98,6 +100,8 @@ class _DictManager:
         ```python
         dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -125,6 +129,8 @@ class _DictManager:
         ```python notest
         await modal.Dict.objects.delete("my-dict", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -167,6 +173,8 @@ class DictManager:
 
             Note that this method does not return a local instance of the Dict. You can use
             `modal.Dict.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -202,6 +210,8 @@ class DictManager:
 
             Note that this method does not return a local instance of the Dict. You can use
             `modal.Dict.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -238,6 +248,8 @@ class DictManager:
             ```python
             dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -271,6 +283,8 @@ class DictManager:
             ```python
             dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -302,6 +316,8 @@ class DictManager:
             ```python notest
             await modal.Dict.objects.delete("my-dict", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -330,6 +346,8 @@ class DictManager:
             ```python notest
             await modal.Dict.objects.delete("my-dict", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 

modal/functions.pyi

@@ -433,7 +433,7 @@ class Function(
 
     _call_generator: ___call_generator_spec[typing_extensions.Self]
 
-    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER, SUPERSELF]):
+    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER, SUPERSELF]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> ReturnType_INNER:
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
@@ -442,7 +442,7 @@ class Function(
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
 
-    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P, typing_extensions.Self]
+    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType, typing_extensions.Self]
 
     class __remote_gen_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -469,7 +469,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER, SUPERSELF]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER, SUPERSELF]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """[Experimental] Calls the function with the given arguments, without waiting for the results.
 
@@ -493,7 +493,7 @@ class Function(
             ...
 
     _experimental_spawn: ___experimental_spawn_spec[
-        modal._functions.ReturnType, modal._functions.P, typing_extensions.Self
+        modal._functions.P, modal._functions.ReturnType, typing_extensions.Self
     ]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER, SUPERSELF]):
@@ -502,7 +502,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P, typing_extensions.Self]
 
-    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER, SUPERSELF]):
+    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER, SUPERSELF]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """Calls the function with the given arguments, without waiting for the results.
 
@@ -523,7 +523,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P, typing_extensions.Self]
+    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType, typing_extensions.Self]
 
     def get_raw_f(self) -> collections.abc.Callable[..., typing.Any]:
         """Return the inner Python object wrapped by this Modal Function."""
@@ -701,24 +701,25 @@ class Function(
 
     class __experimental_spawn_map_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, *input_iterators, kwargs={}) -> modal._functions._FunctionCall:
-            """Spawn parallel execution over a set of inputs, exiting as soon as the inputs are created (without waiting
-            for the map to complete).
+            """mdmd:hidden
+            Spawn parallel execution over a set of inputs, returning as soon as the inputs are created.
+
+            Unlike `modal.Function.map`, this method does not block on completion of the remote execution but
+            returns a `modal.FunctionCall` object that can be used to poll status and retrieve results later.
 
             Takes one iterator argument per argument in the function being mapped over.
 
             Example:
             ```python
             @app.function()
-            def my_func(a):
-                return a ** 2
+            def my_func(a, b):
+                return a ** b
 
 
             @app.local_entrypoint()
             def main():
-                fc = my_func.spawn_map([1, 2, 3, 4])
+                fc = my_func.spawn_map([1, 2], [3, 4])
             ```
-
-            Returns a FunctionCall object that can be used to retrieve results
             """
             ...
 
@@ -787,6 +788,55 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
 
     get: __get_spec[modal._functions.ReturnType, typing_extensions.Self]
 
+    class __iter_spec(typing_extensions.Protocol[ReturnType_INNER, SUPERSELF]):
+        def __call__(self, /, *, start: int = 0, end: typing.Optional[int] = None) -> typing.Iterator[ReturnType_INNER]:
+            """Iterate in-order over the results of the function call.
+
+            Optionally, specify a range [start, end) to iterate over.
+
+            Example:
+            ```python
+            @app.function()
+            def my_func(a):
+                return a ** 2
+
+
+            @app.local_entrypoint()
+            def main():
+                fc = my_func.spawn_map([1, 2, 3, 4])
+                assert list(fc.iter()) == [1, 4, 9, 16]
+                assert list(fc.iter(start=1, end=3)) == [4, 9]
+            ```
+
+            If `end` is not provided, it will iterate over all results.
+            """
+            ...
+
+        def aio(self, /, *, start: int = 0, end: typing.Optional[int] = None) -> typing.AsyncIterator[ReturnType_INNER]:
+            """Iterate in-order over the results of the function call.
+
+            Optionally, specify a range [start, end) to iterate over.
+
+            Example:
+            ```python
+            @app.function()
+            def my_func(a):
+                return a ** 2
+
+
+            @app.local_entrypoint()
+            def main():
+                fc = my_func.spawn_map([1, 2, 3, 4])
+                assert list(fc.iter()) == [1, 4, 9, 16]
+                assert list(fc.iter(start=1, end=3)) == [4, 9]
+            ```
+
+            If `end` is not provided, it will iterate over all results.
+            """
+            ...
+
+    iter: __iter_spec[modal._functions.ReturnType, typing_extensions.Self]
+
     class __get_call_graph_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /) -> list[modal.call_graph.InputInfo]:
             """Returns a structure representing the call graph from a given root

modal/parallel_map.py

@@ -1179,24 +1179,26 @@ async def _spawn_map_helper(
 
 
 def _experimental_spawn_map_sync(self, *input_iterators, kwargs={}) -> "modal.functions._FunctionCall":
-    """Spawn parallel execution over a set of inputs, exiting as soon as the inputs are created (without waiting
-    for the map to complete).
+    """mdmd:hidden
+    Spawn parallel execution over a set of inputs, returning as soon as the inputs are created.
+
+    Unlike `modal.Function.map`, this method does not block on completion of the remote execution but
+    returns a `modal.FunctionCall` object that can be used to poll status and retrieve results later.
 
     Takes one iterator argument per argument in the function being mapped over.
 
     Example:
     ```python
     @app.function()
-    def my_func(a):
-        return a ** 2
+    def my_func(a, b):
+        return a ** b
 
 
     @app.local_entrypoint()
     def main():
-        fc = my_func.spawn_map([1, 2, 3, 4])
+        fc = my_func.spawn_map([1, 2], [3, 4])
     ```
 
-    Returns a FunctionCall object that can be used to retrieve results
     """
 
     return run_coroutine_in_temporary_event_loop(

modal/parallel_map.pyi

@@ -265,24 +265,25 @@ async def _spawn_map_helper(
     self: modal.functions.Function, async_input_gen, kwargs={}
 ) -> modal._functions._FunctionCall: ...
 def _experimental_spawn_map_sync(self, *input_iterators, kwargs={}) -> modal._functions._FunctionCall:
-    """Spawn parallel execution over a set of inputs, exiting as soon as the inputs are created (without waiting
-    for the map to complete).
+    """mdmd:hidden
+    Spawn parallel execution over a set of inputs, returning as soon as the inputs are created.
+
+    Unlike `modal.Function.map`, this method does not block on completion of the remote execution but
+    returns a `modal.FunctionCall` object that can be used to poll status and retrieve results later.
 
     Takes one iterator argument per argument in the function being mapped over.
 
     Example:
     ```python
     @app.function()
-    def my_func(a):
-        return a ** 2
+    def my_func(a, b):
+        return a ** b
 
 
     @app.local_entrypoint()
     def main():
-        fc = my_func.spawn_map([1, 2, 3, 4])
+        fc = my_func.spawn_map([1, 2], [3, 4])
     ```
-
-    Returns a FunctionCall object that can be used to retrieve results
     """
     ...
 

modal/queue.py

@@ -79,6 +79,8 @@ class _QueueManager:
         Note that this method does not return a local instance of the Queue. You can use
         `modal.Queue.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Queue")
         client = await _Client.from_env() if client is None else client
@@ -130,6 +132,8 @@ class _QueueManager:
         queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -190,6 +194,9 @@ class _QueueManager:
         ```python notest
         await modal.Queue.objects.delete("my-queue", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Queue.from_name(name, environment_name=environment_name).hydrate(client)

modal/queue.pyi

@@ -64,6 +64,8 @@ class _QueueManager:
 
         Note that this method does not return a local instance of the Queue. You can use
         `modal.Queue.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -96,6 +98,8 @@ class _QueueManager:
         ```python
         queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -123,6 +127,8 @@ class _QueueManager:
         ```python notest
         await modal.Queue.objects.delete("my-queue", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -165,6 +171,8 @@ class QueueManager:
 
             Note that this method does not return a local instance of the Queue. You can use
             `modal.Queue.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -200,6 +208,8 @@ class QueueManager:
 
             Note that this method does not return a local instance of the Queue. You can use
             `modal.Queue.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -236,6 +246,8 @@ class QueueManager:
             ```python
             queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -269,6 +281,8 @@ class QueueManager:
             ```python
             queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -300,6 +314,8 @@ class QueueManager:
             ```python notest
             await modal.Queue.objects.delete("my-queue", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -328,6 +344,8 @@ class QueueManager:
             ```python notest
             await modal.Queue.objects.delete("my-queue", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 

modal/secret.py

@@ -74,6 +74,8 @@ class _SecretManager:
         Note that this method does not return a local instance of the Secret. You can use
         `modal.Secret.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Secret")
         client = await _Client.from_env() if client is None else client
@@ -126,6 +128,8 @@ class _SecretManager:
         secrets = modal.Secret.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -185,6 +189,9 @@ class _SecretManager:
         ```python notest
         await modal.Secret.objects.delete("my-secret", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Secret.from_name(name, environment_name=environment_name).hydrate(client)

modal/secret.pyi

@@ -65,6 +65,8 @@ class _SecretManager:
 
         Note that this method does not return a local instance of the Secret. You can use
         `modal.Secret.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -97,6 +99,8 @@ class _SecretManager:
         ```python
         secrets = modal.Secret.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -123,6 +127,8 @@ class _SecretManager:
         ```python notest
         await modal.Secret.objects.delete("my-secret", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -168,6 +174,8 @@ class SecretManager:
 
             Note that this method does not return a local instance of the Secret. You can use
             `modal.Secret.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -206,6 +214,8 @@ class SecretManager:
 
             Note that this method does not return a local instance of the Secret. You can use
             `modal.Secret.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -242,6 +252,8 @@ class SecretManager:
             ```python
             secrets = modal.Secret.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -275,6 +287,8 @@ class SecretManager:
             ```python
             secrets = modal.Secret.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -305,6 +319,8 @@ class SecretManager:
             ```python notest
             await modal.Secret.objects.delete("my-secret", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -332,6 +348,8 @@ class SecretManager:
             ```python notest
             await modal.Secret.objects.delete("my-secret", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 

modal/volume.py

@@ -139,6 +139,7 @@ class _VolumeManager:
         modal.Volume.objects.create("my-volume", environment_name="dev")
         ```
 
+        By default, an error will be raised if the Volume already exists, but passing
         `allow_existing=True` will make the creation attempt a no-op in this case.
 
         ```python notest
@@ -148,6 +149,8 @@ class _VolumeManager:
         Note that this method does not return a local instance of the Volume. You can use
         `modal.Volume.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Volume")
         client = await _Client.from_env() if client is None else client
@@ -204,6 +207,8 @@ class _VolumeManager:
         volumes = modal.Volume.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -264,6 +269,9 @@ class _VolumeManager:
         ```python notest
         await modal.Volume.objects.delete("my-volume", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Volume.from_name(name, environment_name=environment_name).hydrate(client)
@@ -685,6 +693,7 @@ class _Volume(_Object, type_prefix="vo"):
         except modal.exception.NotFoundError as exc:
             raise FileNotFoundError(exc.args[0])
 
+        @retry(n_attempts=5, base_delay=0.1, timeout=None)
         async def read_block(block_url: str) -> bytes:
             async with ClientSessionRegistry.get_session().get(block_url) as get_response:
                 return await get_response.content.read()
@@ -724,6 +733,7 @@ class _Volume(_Object, type_prefix="vo"):
         write_lock = asyncio.Lock()
         start_pos = fileobj.tell()
 
+        @retry(n_attempts=5, base_delay=0.1, timeout=None)
         async def download_block(idx, url) -> int:
             block_start_pos = start_pos + idx * BLOCK_SIZE
             num_bytes_written = 0

modal/volume.pyi

@@ -105,6 +105,7 @@ class _VolumeManager:
         modal.Volume.objects.create("my-volume", environment_name="dev")
         ```
 
+        By default, an error will be raised if the Volume already exists, but passing
         `allow_existing=True` will make the creation attempt a no-op in this case.
 
         ```python notest
@@ -113,6 +114,8 @@ class _VolumeManager:
 
         Note that this method does not return a local instance of the Volume. You can use
         `modal.Volume.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -145,6 +148,8 @@ class _VolumeManager:
         ```python
         volumes = modal.Volume.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -172,6 +177,8 @@ class _VolumeManager:
         ```python notest
         await modal.Volume.objects.delete("my-volume", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -206,6 +213,7 @@ class VolumeManager:
             modal.Volume.objects.create("my-volume", environment_name="dev")
             ```
 
+            By default, an error will be raised if the Volume already exists, but passing
             `allow_existing=True` will make the creation attempt a no-op in this case.
 
             ```python notest
@@ -214,6 +222,8 @@ class VolumeManager:
 
             Note that this method does not return a local instance of the Volume. You can use
             `modal.Volume.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -241,6 +251,7 @@ class VolumeManager:
             modal.Volume.objects.create("my-volume", environment_name="dev")
             ```
 
+            By default, an error will be raised if the Volume already exists, but passing
             `allow_existing=True` will make the creation attempt a no-op in this case.
 
             ```python notest
@@ -249,6 +260,8 @@ class VolumeManager:
 
             Note that this method does not return a local instance of the Volume. You can use
             `modal.Volume.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -285,6 +298,8 @@ class VolumeManager:
             ```python
             volumes = modal.Volume.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -318,6 +333,8 @@ class VolumeManager:
             ```python
             volumes = modal.Volume.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -349,6 +366,8 @@ class VolumeManager:
             ```python notest
             await modal.Volume.objects.delete("my-volume", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -377,6 +396,8 @@ class VolumeManager:
             ```python notest
             await modal.Volume.objects.delete("my-volume", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 

{modal-1.1.2.dev43.dist-info → modal-1.1.3.dev0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.1.2.dev43
+Version: 1.1.3.dev0
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License: Apache-2.0

{modal-1.1.2.dev43.dist-info → modal-1.1.3.dev0.dist-info}/RECORD

@@ -3,7 +3,7 @@ modal/__main__.py,sha256=45H-GtwzaDfN-1nP4_HYvzN3s7AG_HXR4-ynrsjO_OI,2803
 modal/_clustered_functions.py,sha256=zmrKbptRbqp4euS3LWncKaLXb8Kjj4YreusOzpEpRMk,2856
 modal/_clustered_functions.pyi,sha256=_wtFjWocGf1WgI-qYBpbJPArNkg2H9JV7BVaGgMesEQ,1103
 modal/_container_entrypoint.py,sha256=a1HAQYh1gGpqHuhSw6AW7XDYHztbeYr5a8iNnfCnoks,29023
-modal/_functions.py,sha256=LHl1KJ8BSpFxPeG-iseC3l5N8N4MpbMXtdIyEocRD2E,85245
+modal/_functions.py,sha256=lPDk_KBKTS_FhOuLu15EXkvQndmoiNOnEe5A7BBd0ek,88003
 modal/_ipython.py,sha256=TW1fkVOmZL3YYqdS2YlM1hqpf654Yf8ZyybHdBnlhSw,301
 modal/_location.py,sha256=joiX-0ZeutEUDTrrqLF1GHXCdVLF-rHzstocbMcd_-k,366
 modal/_object.py,sha256=gwsLdXb-Ecd8nH8LVCo8oVZPzzdyo9BrN1DjgQmsSuM,11967
@@ -18,11 +18,11 @@ modal/_tunnel.py,sha256=zTBxBiuH1O22tS1OliAJdIsSmaZS8PlnifS_6S5z-mk,6320
 modal/_tunnel.pyi,sha256=rvC7USR2BcKkbZIeCJXwf7-UfGE-LPLjKsGNiK7Lxa4,13366
 modal/_type_manager.py,sha256=DWjgmjYJuOagw2erin506UUbG2H5UzZCFEekS-7hmfA,9087
 modal/_watcher.py,sha256=K6LYnlmSGQB4tWWI9JADv-tvSvQ1j522FwT71B51CX8,3584
-modal/app.py,sha256=RmoW5C7ZdJuv_BkV8waHPTbk7bROpWOynqkNyGrjEL0,48030
+modal/app.py,sha256=hJU3DGzP5GwYRmBj57XajljkQtLxkKftxXih2TYRcKo,48047
 modal/app.pyi,sha256=0U2xVKD3yfHe5l2bcihTDjPl__tzOvx1AIYOTebu-5o,43375
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=kyAIVB3Ay-XKJizQ_1ufUFB__EagV0MLmHJpyYyJ7J0,18636
-modal/client.pyi,sha256=Uj7GEIN3pTESbvS2BmQ_x-glr81bXyk8jMk4J8J99K4,15831
+modal/client.pyi,sha256=8fwIonzX4a3CeGzwFS_67LsvnmE9x_0nfLH_JaHgP-w,15829
 modal/cloud_bucket_mount.py,sha256=YOe9nnvSr4ZbeCn587d7_VhE9IioZYRvF9VYQTQux08,5914
 modal/cloud_bucket_mount.pyi,sha256=-qSfYAQvIoO_l2wsCCGTG5ZUwQieNKXdAO00yP1-LYU,7394
 modal/cls.py,sha256=1mBcExFrLDTZwkD3Dzu8F26_CL0CGktOV9pE60Y8g_E,40689
@@ -30,8 +30,8 @@ modal/cls.pyi,sha256=TevKBrBez2R0_4Epsx5GB5gyQX_kQV-uVHPxpqEokhQ,28357
 modal/config.py,sha256=tW-SEGjVvAt3D_MNi3LhxXnFKIA9fjLd3UIgbW8uSJE,12121
 modal/container_process.py,sha256=XkPwNIW-iD_GB9u9yqv9q8y-i5cQ8eBbLZZ_GvEw9t8,6858
 modal/container_process.pyi,sha256=9m-st3hCUlNN1GOTctfPPvIvoLtEl7FbuGWwif5-7YU,6037
-modal/dict.py,sha256=8zT0tCfpQiKFJWlG_Mm9vtLCklifcwCVwD8OnnESrtU,22597
-modal/dict.pyi,sha256=F9yxTgBjxLOy6boB3N4wc2BtnGIO1TARmyhpMBC8c80,33317
+modal/dict.py,sha256=azL6WHOAR49OsqB33Rqyd1j9ljbbW7blHZDuRV8xPrA,22676
+modal/dict.pyi,sha256=x0PxEqfC8wNGe5u4Y1GI5W1J0H51e3ZG9kHdYFRVLvQ,33575
 modal/environments.py,sha256=gHFNLG78bqgizpQ4w_elz27QOqmcgAonFsmLs7NjUJ4,6804
 modal/environments.pyi,sha256=9-KtrzAcUe55cCP4020lSUD7-fWS7OPakAHssq4-bro,4219
 modal/exception.py,sha256=o0V93PK8Hcg2YQ2aeOB1Y-qWBw4Gz5ATfyokR8GapuQ,5634
@@ -39,7 +39,7 @@ modal/file_io.py,sha256=OSKr77TujcXGJW1iikzYiHckLSmv07QBgBHcxxYEkoI,21456
 modal/file_io.pyi,sha256=xtO6Glf_BFwDE7QiQQo24QqcMf_Vv-iz7WojcGVlLBU,15932
 modal/file_pattern_matcher.py,sha256=A_Kdkej6q7YQyhM_2-BvpFmPqJ0oHb54B6yf9VqvPVE,8116
 modal/functions.py,sha256=kcNHvqeGBxPI7Cgd57NIBBghkfbeFJzXO44WW0jSmao,325
-modal/functions.pyi,sha256=JBl_Gr5wtxk38WMyb5EMNaq2AHRzOhZQkvWJDVFTIq4,37118
+modal/functions.pyi,sha256=h1oPAvbErW_i1Glzf_HsQenG-uH4KZk7X6razFbif6M,38890
 modal/gpu.py,sha256=Fe5ORvVPDIstSq1xjmM6OoNgLYFWvogP9r5BgmD3hYg,6769
 modal/image.py,sha256=9pSLEGMxwal55AY-hbL4eTf0lq3xMwuQ0mN-Gc3E99M,103134
 modal/image.pyi,sha256=zwCW80xe2BL7q4_kswfljKRrKjMkK5paTY26e5ITM1U,68507
@@ -52,15 +52,15 @@ modal/network_file_system.pyi,sha256=Td_IobHr84iLo_9LZKQ4tNdUB60yjX8QWBaFiUvhfi8
 modal/object.py,sha256=bTeskuY8JFrESjU4_UL_nTwYlBQdOLmVaOX3X6EMxsg,164
 modal/object.pyi,sha256=qlyVVMezW3XgJe_iqhtzWRSki3Nuk-KrpXc1g-r8ujA,6944
 modal/output.py,sha256=q4T9uHduunj4NwY-YSwkHGgjZlCXMuJbfQ5UFaAGRAc,1968
-modal/parallel_map.py,sha256=Q2srzzDcwE5uWSSzA80_Y3NBUoCHUFAP2Ekz-Zi7jn0,67397
-modal/parallel_map.pyi,sha256=PTNIX3_KXLpEIGiFmZ5R5_G3a2toUvFdiUZVdSHa060,15417
+modal/parallel_map.py,sha256=Pi6WrgVGmjUrz7hCGPbOCDeRKnKLGXxP3B0HuujIa9c,67508
+modal/parallel_map.pyi,sha256=dp_ip_JrbAf9qCkSyaKDdop8LjfRj5r_oc5LG26umOo,15527
 modal/partial_function.py,sha256=aIdlGfTjjgqY6Fpr-biCjvRU9W542_S5N2xkNN_rYGM,1127
 modal/partial_function.pyi,sha256=lqqOzZ9-QvHTDWKQ_oAYYOvsXgTOBKhO9u-RI98JbUk,13986
 modal/proxy.py,sha256=CQydu_NPDgApN2GLdd7rrcg8PM-pXyFdVYcTaGMBRCQ,1491
 modal/proxy.pyi,sha256=yWGWwADCRGrC2w81B7671UTH4Uv3HMZKy5vVqlJUZoA,1417
 modal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-modal/queue.py,sha256=D1ROYl6N6Al5O7X-mB6URuuuWFOtx4I2kFNR2kzlTas,27054
-modal/queue.pyi,sha256=BEbAa9Fb77Z6Th644FhMnf3BvfLuoBuUz6iUVCkbD1k,39251
+modal/queue.py,sha256=ooD_-z3gthje_kxBZQ_xDfwyTy_cxtyn5oM9wt2sXTo,27133
+modal/queue.pyi,sha256=EJ6extEFKclbEUBXk-PuRJ4bkUYRwWgAAUNofQBbBmo,39509
 modal/retries.py,sha256=IvNLDM0f_GLUDD5VgEDoN09C88yoxSrCquinAuxT1Sc,5205
 modal/runner.py,sha256=ostdzYpQb-20tlD6dIq7bpWTkZkOhjJBNuMNektqnJA,24068
 modal/runner.pyi,sha256=lbwLljm1cC8d6PcNvmYQhkE8501V9fg0bYqqKX6G4r4,8489
@@ -69,8 +69,8 @@ modal/sandbox.py,sha256=O_vB-VgJ2ZMw2yyT2-ATYIWHdeDXCPf4cFcc-3JSB5Q,40895
 modal/sandbox.pyi,sha256=HoHgwb167i83qiGhUE7UAy79l45wqfXKfOA9hZ5HiEo,41572
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
-modal/secret.py,sha256=syqkcgFtPUiMIv6m3aXjXeqzCyOaeovoDxHvkSRqVRA,19229
-modal/secret.pyi,sha256=JiWmFXu_YUjBdzVWctn7TQwVOj_qOSsQLRSUmQuaW34,21294
+modal/secret.py,sha256=jcNJKc4ZB2nvAn7HJFawInqE-_7sbB43IWLZwyLBQ28,19308
+modal/secret.pyi,sha256=7EzD7nZGSZHQR-Hf5aRi0ooZGxvy1-G8A4ul-M04Qs4,21552
 modal/serving.py,sha256=3I3WBeVbzZY258u9PXBCW_dZBgypq3OhwBuTVvlgubE,4423
 modal/serving.pyi,sha256=YfixTaWikyYpwhnNxCHMZnDDQiPmV1xJ87QF91U_WGU,1924
 modal/snapshot.py,sha256=E3oxYQkYVRB_LeFBfmUV1Y6vHz8-azXJfC4x7A1QKnI,1455
@@ -78,8 +78,8 @@ modal/snapshot.pyi,sha256=0q83hlmWxAhDu8xwZyL5VmYh0i8Tigf7S60or2k30L8,1682
 modal/stream_type.py,sha256=A6320qoAAWhEfwOCZfGtymQTu5AfLfJXXgARqooTPvY,417
 modal/token_flow.py,sha256=GWpar0gANs71vm9Bd_Cj87UG1K3ljTURbkEjG3JLsrY,7616
 modal/token_flow.pyi,sha256=eirYjyqbRiT3GCKMIPHJPpkvBTu8WxDKqSHehWaJI_4,2533
-modal/volume.py,sha256=CNzS7I8BI0x6uYUDdvNdMlXHljdFih3RrdgmEOhguIc,53020
-modal/volume.pyi,sha256=0_71AfI6pRUNPulA_yrz2UwFGxynHx3QNoyZ33Ie8bs,53919
+modal/volume.py,sha256=bPC8632-LyeLOjJu2fKOFyod0QG7Hd5bb-UIJ5syCjo,53303
+modal/volume.pyi,sha256=5VppIgoqoJqpivESYt5_oWgVTL__zlmpNZkOPk43JF8,54443
 modal/_runtime/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal/_runtime/asgi.py,sha256=yewQjvqPdXQ9SeEMMM53-h3Y22WlJNe28tFvPrrwguk,22607
 modal/_runtime/container_io_manager.py,sha256=iiFxPfnJjnZd_l2Aj5TCR_O1dQwBcrvHccq0LSIJGZY,45719
@@ -153,7 +153,7 @@ modal/experimental/__init__.py,sha256=dPBPpxsmjZMLF3YjRrXoTvT01pl65wxi4UdFZsOem3
 modal/experimental/flash.py,sha256=viXQumCIFp5VFsPFURdFTBTjP_QnsAi8nSWXAMmfjeQ,19744
 modal/experimental/flash.pyi,sha256=A8_qJGtGoXEzKDdHbvhmCw7oqfneFEvJQK3ZdTOvUdU,10830
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.1.2.dev43.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.1.3.dev0.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=c1yfBS_x--gL5bs0N4ihMwqwX8l3IBWSkBAKNNIi6bQ,3801
 modal_docs/gen_reference_docs.py,sha256=d_CQUGQ0rfw28u75I2mov9AlS773z9rG40-yq5o7g2U,6359
@@ -176,10 +176,10 @@ modal_proto/options_pb2.pyi,sha256=l7DBrbLO7q3Ir-XDkWsajm0d0TQqqrfuX54i4BMpdQg,1
 modal_proto/options_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCNMhZD2VXqocC9l_gk,159
 modal_proto/options_pb2_grpc.pyi,sha256=CImmhxHsYnF09iENPoe8S4J-n93jtgUYD2JPAc0yJSI,247
 modal_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-modal_version/__init__.py,sha256=kq3FWk25Kqf0MCAHGDyYKufuCu_-GkgUP-fQaNTRmGE,121
+modal_version/__init__.py,sha256=imKg3ytw59rZrAJQnW-XDHVW59eJBGzmAMJiNKN-Bdo,120
 modal_version/__main__.py,sha256=2FO0yYQQwDTh6udt1h-cBnGd1c4ZyHnHSI4BksxzVac,105
-modal-1.1.2.dev43.dist-info/METADATA,sha256=TYbh1FG98BWr58qrSTpJ9RtoIHqft1FBt_3hScvHEm4,2460
-modal-1.1.2.dev43.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.1.2.dev43.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.1.2.dev43.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.1.2.dev43.dist-info/RECORD,,
+modal-1.1.3.dev0.dist-info/METADATA,sha256=Nn6lynhxtjQ9qYAOfd2wvwYtqNSKjVBz96aBLshqEVc,2459
+modal-1.1.3.dev0.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.1.3.dev0.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.1.3.dev0.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.1.3.dev0.dist-info/RECORD,,

modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2025
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.1.2.dev43"
+__version__ = "1.1.3.dev0"