modal 1.0.6.dev31__py3-none-any.whl → 1.0.6.dev32__py3-none-any.whl

modal/client.pyi

@@ -31,7 +31,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.0.6.dev31",
+        version: str = "1.0.6.dev32",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -160,7 +160,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.0.6.dev31",
+        version: str = "1.0.6.dev32",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/file_io.py

@@ -117,10 +117,15 @@ class FileWatchEvent:
 # The FileIO class is designed to mimic Python's io.FileIO
 # See https://github.com/python/cpython/blob/main/Lib/_pyio.py#L1459
 class _FileIO(Generic[T]):
-    """FileIO handle, used in the Sandbox filesystem API.
+    """[Alpha] FileIO handle, used in the Sandbox filesystem API.
 
     The API is designed to mimic Python's io.FileIO.
 
+    Currently this API is in Alpha and is subject to change. File I/O operations
+    may be limited in size to 100 MiB, and the throughput of requests is
+    restricted in the current implementation. For our recommendations on large file transfers
+    see the Sandbox [filesystem access guide](https://modal.com/docs/guide/sandbox-files).
+
     **Usage**
 
     ```python
@@ -144,7 +149,7 @@ class _FileIO(Generic[T]):
     _task_id: str = ""
     _file_descriptor: str = ""
     _client: _Client
-    _watch_output_buffer: list[Union[Optional[bytes],Exception]] = []
+    _watch_output_buffer: list[Union[Optional[bytes], Exception]] = []
 
     def __init__(self, client: _Client, task_id: str) -> None:
         self._client = client

modal/file_io.pyi

@@ -51,10 +51,15 @@ class FileWatchEvent:
         ...
 
 class _FileIO(typing.Generic[T]):
-    """FileIO handle, used in the Sandbox filesystem API.
+    """[Alpha] FileIO handle, used in the Sandbox filesystem API.
 
     The API is designed to mimic Python's io.FileIO.
 
+    Currently this API is in Alpha and is subject to change. File I/O operations
+    may be limited in size to 100 MiB, and the throughput of requests is
+    restricted in the current implementation. For our recommendations on large file transfers
+    see the Sandbox [filesystem access guide](https://modal.com/docs/guide/sandbox-files).
+
     **Usage**
 
     ```python
@@ -216,10 +221,15 @@ SUPERSELF = typing.TypeVar("SUPERSELF", covariant=True)
 T_INNER = typing.TypeVar("T_INNER", covariant=True)
 
 class FileIO(typing.Generic[T]):
-    """FileIO handle, used in the Sandbox filesystem API.
+    """[Alpha] FileIO handle, used in the Sandbox filesystem API.
 
     The API is designed to mimic Python's io.FileIO.
 
+    Currently this API is in Alpha and is subject to change. File I/O operations
+    may be limited in size to 100 MiB, and the throughput of requests is
+    restricted in the current implementation. For our recommendations on large file transfers
+    see the Sandbox [filesystem access guide](https://modal.com/docs/guide/sandbox-files).
+
     **Usage**
 
     ```python

modal/sandbox.py

@@ -745,7 +745,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         path: str,
         mode: Union["_typeshed.OpenTextMode", "_typeshed.OpenBinaryMode"] = "r",
     ):
-        """Open a file in the Sandbox and return a FileIO handle.
+        """[Alpha] Open a file in the Sandbox and return a FileIO handle.
 
         See the [`FileIO`](https://modal.com/docs/reference/modal.file_io#modalfile_iofileio) docs for more information.
 
@@ -762,17 +762,17 @@ class _Sandbox(_Object, type_prefix="sb"):
         return await _FileIO.create(path, mode, self._client, task_id)
 
     async def ls(self, path: str) -> list[str]:
-        """List the contents of a directory in the Sandbox."""
+        """[Alpha] List the contents of a directory in the Sandbox."""
         task_id = await self._get_task_id()
         return await _FileIO.ls(path, self._client, task_id)
 
     async def mkdir(self, path: str, parents: bool = False) -> None:
-        """Create a new directory in the Sandbox."""
+        """[Alpha] Create a new directory in the Sandbox."""
         task_id = await self._get_task_id()
         return await _FileIO.mkdir(path, self._client, task_id, parents)
 
     async def rm(self, path: str, recursive: bool = False) -> None:
-        """Remove a file or directory in the Sandbox."""
+        """[Alpha] Remove a file or directory in the Sandbox."""
         task_id = await self._get_task_id()
         return await _FileIO.rm(path, self._client, task_id, recursive)
 
@@ -783,7 +783,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         recursive: Optional[bool] = None,
         timeout: Optional[int] = None,
     ) -> AsyncIterator[FileWatchEvent]:
-        """Watch a file or directory in the Sandbox for changes."""
+        """[Alpha] Watch a file or directory in the Sandbox for changes."""
         task_id = await self._get_task_id()
         async for event in _FileIO.watch(path, self._client, task_id, filter, recursive, timeout):
             yield event

modal/sandbox.pyi

@@ -245,15 +245,15 @@ class _Sandbox(modal._object._Object):
     @typing.overload
     async def open(self, path: str, mode: _typeshed.OpenBinaryMode) -> modal.file_io._FileIO[bytes]: ...
     async def ls(self, path: str) -> list[str]:
-        """List the contents of a directory in the Sandbox."""
+        """[Alpha] List the contents of a directory in the Sandbox."""
         ...
 
     async def mkdir(self, path: str, parents: bool = False) -> None:
-        """Create a new directory in the Sandbox."""
+        """[Alpha] Create a new directory in the Sandbox."""
         ...
 
     async def rm(self, path: str, recursive: bool = False) -> None:
-        """Remove a file or directory in the Sandbox."""
+        """[Alpha] Remove a file or directory in the Sandbox."""
         ...
 
     def watch(
@@ -263,7 +263,7 @@ class _Sandbox(modal._object._Object):
         recursive: typing.Optional[bool] = None,
         timeout: typing.Optional[int] = None,
     ) -> typing.AsyncIterator[modal.file_io.FileWatchEvent]:
-        """Watch a file or directory in the Sandbox for changes."""
+        """[Alpha] Watch a file or directory in the Sandbox for changes."""
         ...
 
     @property
@@ -761,33 +761,33 @@ class Sandbox(modal.object.Object):
 
     class __ls_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, path: str) -> list[str]:
-            """List the contents of a directory in the Sandbox."""
+            """[Alpha] List the contents of a directory in the Sandbox."""
             ...
 
         async def aio(self, /, path: str) -> list[str]:
-            """List the contents of a directory in the Sandbox."""
+            """[Alpha] List the contents of a directory in the Sandbox."""
             ...
 
     ls: __ls_spec[typing_extensions.Self]
 
     class __mkdir_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, path: str, parents: bool = False) -> None:
-            """Create a new directory in the Sandbox."""
+            """[Alpha] Create a new directory in the Sandbox."""
             ...
 
         async def aio(self, /, path: str, parents: bool = False) -> None:
-            """Create a new directory in the Sandbox."""
+            """[Alpha] Create a new directory in the Sandbox."""
             ...
 
     mkdir: __mkdir_spec[typing_extensions.Self]
 
     class __rm_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, path: str, recursive: bool = False) -> None:
-            """Remove a file or directory in the Sandbox."""
+            """[Alpha] Remove a file or directory in the Sandbox."""
             ...
 
         async def aio(self, /, path: str, recursive: bool = False) -> None:
-            """Remove a file or directory in the Sandbox."""
+            """[Alpha] Remove a file or directory in the Sandbox."""
             ...
 
     rm: __rm_spec[typing_extensions.Self]
@@ -801,7 +801,7 @@ class Sandbox(modal.object.Object):
             recursive: typing.Optional[bool] = None,
             timeout: typing.Optional[int] = None,
         ) -> typing.Iterator[modal.file_io.FileWatchEvent]:
-            """Watch a file or directory in the Sandbox for changes."""
+            """[Alpha] Watch a file or directory in the Sandbox for changes."""
             ...
 
         def aio(
@@ -812,7 +812,7 @@ class Sandbox(modal.object.Object):
             recursive: typing.Optional[bool] = None,
             timeout: typing.Optional[int] = None,
         ) -> typing.AsyncIterator[modal.file_io.FileWatchEvent]:
-            """Watch a file or directory in the Sandbox for changes."""
+            """[Alpha] Watch a file or directory in the Sandbox for changes."""
             ...
 
     watch: __watch_spec[typing_extensions.Self]

{modal-1.0.6.dev31.dist-info → modal-1.0.6.dev32.dist-info}/METADATA

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

{modal-1.0.6.dev31.dist-info → modal-1.0.6.dev32.dist-info}/RECORD

@@ -22,7 +22,7 @@ modal/app.py,sha256=aH4PWc0TBTq9r5RLHVlNuh7szaob2AhTSXMweIrMfBo,46750
 modal/app.pyi,sha256=yBMZpnPxhDkPJPNtAiepkZU6XEe2uyhOBt0wa0HRrsg,42331
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=OwISJvkgMb-rHm9Gc4i-7YcDgGiZgwJ7F_PzwZH7a6Q,16847
-modal/client.pyi,sha256=ZxMDrhEq7DzlY8KVLOf9Z2hHvjtJKuqNUmFq2ncreCM,15081
+modal/client.pyi,sha256=fmRqwS95v2V_R5sCH7_dh0qrxaJiZP3sXZuGgmZ7ik4,15081
 modal/cloud_bucket_mount.py,sha256=YOe9nnvSr4ZbeCn587d7_VhE9IioZYRvF9VYQTQux08,5914
 modal/cloud_bucket_mount.pyi,sha256=-qSfYAQvIoO_l2wsCCGTG5ZUwQieNKXdAO00yP1-LYU,7394
 modal/cls.py,sha256=EFrM949jNXJpmwB2G_1d28b8IpHShfKIEIaiPkZqeOU,39881
@@ -35,8 +35,8 @@ modal/dict.pyi,sha256=gs3J7X5yG3J1L6rW0s3_7yRn8qAfY0f4n5-sqaDZY2g,20853
 modal/environments.py,sha256=gHFNLG78bqgizpQ4w_elz27QOqmcgAonFsmLs7NjUJ4,6804
 modal/environments.pyi,sha256=9-KtrzAcUe55cCP4020lSUD7-fWS7OPakAHssq4-bro,4219
 modal/exception.py,sha256=RjfKTJH7-Gcf_33BGkvDch-ry1Zx9u6-0QLViNxNTaU,5520
-modal/file_io.py,sha256=SCBfLk5gRieqdTVlA_f-2YHHtRp7Iy_sA6iR1zPsO3c,21100
-modal/file_io.pyi,sha256=_Hm-59MrppfuBYxtzdJkA2Jf9zI5LlbPh_0gURk0_7s,15222
+modal/file_io.py,sha256=BVqAJ0sgPUfN8QsYztWiGB4j56he60TncM02KsylnCw,21449
+modal/file_io.pyi,sha256=cPT_hsplE5iLCXhYOLn1Sp9eDdk7DxdFmicQHanJZyg,15918
 modal/file_pattern_matcher.py,sha256=urAue8es8jxqX94k9EYoZxxhtfgOlsEES8lbFHOorzc,7734
 modal/functions.py,sha256=kcNHvqeGBxPI7Cgd57NIBBghkfbeFJzXO44WW0jSmao,325
 modal/functions.pyi,sha256=FJe_91dSrMCRNVT-YV1UhtxFKzIvL_C5q8xdk08-wT8,34840
@@ -65,8 +65,8 @@ modal/retries.py,sha256=IvNLDM0f_GLUDD5VgEDoN09C88yoxSrCquinAuxT1Sc,5205
 modal/runner.py,sha256=ostdzYpQb-20tlD6dIq7bpWTkZkOhjJBNuMNektqnJA,24068
 modal/runner.pyi,sha256=lbwLljm1cC8d6PcNvmYQhkE8501V9fg0bYqqKX6G4r4,8489
 modal/running_app.py,sha256=v61mapYNV1-O-Uaho5EfJlryMLvIT9We0amUOSvSGx8,1188
-modal/sandbox.py,sha256=NS2ShX-JxsRYczCe-hz7Iu6TKxJq8OXLMWGx04FJHls,37489
-modal/sandbox.pyi,sha256=AiZlmZdYHrlqnT8Ba8K5BxNWI1W_oIIkNMhQHF2zqIU,38469
+modal/sandbox.py,sha256=d94JFs2amX2nj0UAGQh8t5_UtiAejXgyxV6LvXpMS_0,37529
+modal/sandbox.pyi,sha256=AyROza8ZUUxs6MO1f3l8zDjTkp6O46H132xUwBUixIc,38565
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
 modal/secret.py,sha256=bpgtv0urwaBOmmJpMTZIwVWUraQlpeu4hW8pbJiGcOA,10546
@@ -148,7 +148,7 @@ modal/requirements/2025.06.txt,sha256=KxDaVTOwatHvboDo4lorlgJ7-n-MfAwbPwxJ0zcJqr
 modal/requirements/PREVIEW.txt,sha256=KxDaVTOwatHvboDo4lorlgJ7-n-MfAwbPwxJ0zcJqrs,312
 modal/requirements/README.md,sha256=9tK76KP0Uph7O0M5oUgsSwEZDj5y-dcUPsnpR0Sc-Ik,854
 modal/requirements/base-images.json,sha256=JYSDAgHTl-WrV_TZW5icY-IJEnbe2eQ4CZ_KN6EOZKU,1304
-modal-1.0.6.dev31.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.0.6.dev32.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
@@ -171,10 +171,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=Ycv08h4fVUHXZ_mWaE5vVe7IACFP7lb25l9LqYkoCLg,121
+modal_version/__init__.py,sha256=QOffRororbAXe9dHCjHWd8KwauuzHS4paZdXfYh8RjE,121
 modal_version/__main__.py,sha256=2FO0yYQQwDTh6udt1h-cBnGd1c4ZyHnHSI4BksxzVac,105
-modal-1.0.6.dev31.dist-info/METADATA,sha256=FXoHmDms-M3zW7wuZymWRF4Va4TArQm4NTX21gA45aY,2462
-modal-1.0.6.dev31.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.0.6.dev31.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.0.6.dev31.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.0.6.dev31.dist-info/RECORD,,
+modal-1.0.6.dev32.dist-info/METADATA,sha256=6MQ_vCC7h99HGM_YXJI7gEZX7HydFG8ucEcOmp-GQ-U,2462
+modal-1.0.6.dev32.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.0.6.dev32.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.0.6.dev32.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.0.6.dev32.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.0.6.dev31"
+__version__ = "1.0.6.dev32"