modal 1.0.6.dev31__tar.gz → 1.0.6.dev32__tar.gz

{modal-1.0.6.dev31 → modal-1.0.6.dev32}/PKG-INFO

@@ -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 → modal-1.0.6.dev32}/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-1.0.6.dev31 → modal-1.0.6.dev32}/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-1.0.6.dev31 → modal-1.0.6.dev32}/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-1.0.6.dev31 → modal-1.0.6.dev32}/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-1.0.6.dev31 → modal-1.0.6.dev32}/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 → modal-1.0.6.dev32}/modal.egg-info/PKG-INFO

@@ -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 → modal-1.0.6.dev32}/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"