modal 1.4.1.dev5__tar.gz → 1.4.2.dev0__tar.gz

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.1.dev5
+Version: 1.4.2.dev0
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -23,7 +23,7 @@ Requires-Dist: grpclib<0.4.10,>=0.4.7; python_version < "3.14"
 Requires-Dist: grpclib<0.4.10,>=0.4.9; python_version >= "3.14"
 Requires-Dist: protobuf!=4.24.0,<7.0,>=3.19
 Requires-Dist: rich>=12.0.0
-Requires-Dist: synchronicity~=0.12.0
+Requires-Dist: synchronicity~=0.12.1
 Requires-Dist: toml
 Requires-Dist: typer>=0.9
 Requires-Dist: types-certifi

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/_utils/sandbox_fs_utils.py

@@ -12,6 +12,7 @@ from ..exception import (
     Error as ModalError,
     InvalidError,
     NotFoundError,
+    SandboxFilesystemDirectoryNotEmptyError,
     SandboxFilesystemError,
     SandboxFilesystemFileTooLargeError,
     SandboxFilesystemIsADirectoryError,
@@ -153,6 +154,40 @@ def make_read_file_command(remote_path: str) -> str:
     return json.dumps({"ReadFile": {"path": remote_path}})
 
 
+def make_remove_command(remote_path: str, recursive: bool) -> str:
+    """Build the JSON command string for a Remove operation.
+
+    The returned JSON must match the `Command` enum in the modal-sandbox-fs-tools
+    Rust crate (crates/modal-sandbox-fs-tools/src/lib.rs). Treat changes to
+    this schema like protobuf changes: fields must not be removed or renamed,
+    only added with backwards-compatible defaults.
+    """
+    return json.dumps({"Remove": {"path": remote_path, "recursive": recursive}})
+
+
+def raise_remove_error(returncode: int, stderr: Union[str, bytes], remote_path: str) -> NoReturn:
+    if payload := try_parse_error_payload(stderr):
+        logger.debug(
+            f"sandbox-fs-tools remove error: path={remote_path}, "
+            f"error_kind={payload.error_kind}, message={payload.message}, detail={payload.detail}"
+        )
+        if payload.error_kind == "NotFound":
+            raise SandboxFilesystemNotFoundError(f"{payload.message}: {remote_path}")
+        if payload.error_kind == "DirectoryNotEmpty":
+            raise SandboxFilesystemDirectoryNotEmptyError(f"{payload.message}: {remote_path}")
+        if payload.error_kind == "NotSupported":
+            raise InvalidError(
+                f"{payload.message}: {remote_path} - this operation is not supported for CloudBucketMounts"
+            )
+        if payload.error_kind == "PermissionDenied":
+            raise SandboxFilesystemPermissionError(f"{payload.message}: {remote_path}")
+        raise SandboxFilesystemError(payload.message)
+
+    if stderr_text := _stderr_to_text(stderr):
+        logger.debug(f"Unstructured modal-sandbox-fs-tools stderr: {stderr_text}")
+    raise SandboxFilesystemError(f"Operation on '{remote_path}' failed with exit code {returncode}")
+
+
 def validate_absolute_remote_path(remote_path: str, operation: str) -> None:
     if not PurePosixPath(remote_path).is_absolute():
         raise InvalidError(f"Sandbox.filesystem.{operation}() currently only supports absolute remote_path values")

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/_utils/time_utils.py

@@ -164,6 +164,61 @@ def parse_date_range(s: str, tz: Optional[tzinfo] = None) -> tuple[datetime, dat
     raise ValueError(f"Unrecognized range: '{s}'. Accepted values: {accepted}")
 
 
+def relative_timestamp(dt: datetime) -> str:
+    """Convert a tz-aware datetime to a human-readable relative time string.
+
+    Examples: "just now", "30 seconds ago", "5 minutes ago", "2 hours ago",
+    "yesterday", "3 days ago", "2 weeks ago", "3 months ago", "1 year ago".
+
+    Raises ValueError if the datetime is naive (no tzinfo).
+    """
+    if dt.tzinfo is None:
+        raise ValueError("datetime must be timezone-aware")
+
+    now = datetime.now(timezone.utc)
+    delta = now - dt
+    total_seconds = int(delta.total_seconds())
+
+    if total_seconds < 0:
+        return "just now"
+
+    if total_seconds < 10:
+        return "just now"
+    if total_seconds < 60:
+        return f"{total_seconds} seconds ago"
+    if total_seconds < 120:
+        return "1 minute ago"
+
+    minutes = total_seconds // 60
+    if minutes < 60:
+        return f"{minutes} minutes ago"
+    if minutes < 120:
+        return "1 hour ago"
+
+    hours = minutes // 60
+    if hours < 24:
+        return f"{hours} hours ago"
+    if hours < 48:
+        return "yesterday"
+
+    days = hours // 24
+    if days < 14:
+        return f"{days} days ago"
+
+    weeks = days // 7
+    if days < 60:
+        return f"{weeks} weeks ago"
+
+    months = days // 30
+    if days < 365:
+        return f"{months} months ago"
+
+    years = days // 365
+    if years == 1:
+        return "1 year ago"
+    return f"{years} years ago"
+
+
 def locale_tz() -> tzinfo:
     return datetime.now().astimezone().tzinfo
 

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/client.pyi

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

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/exception.py

@@ -351,6 +351,12 @@ class SandboxFilesystemNotFoundError(SandboxFilesystemError):
     pass
 
 
+class SandboxFilesystemDirectoryNotEmptyError(SandboxFilesystemError):
+    """Raised when a directory is not empty."""
+
+    pass
+
+
 class SandboxFilesystemIsADirectoryError(SandboxFilesystemError):
     """Raised when a file operation in the sandbox targets a directory when it should target a non-directory file."""
 

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/sandbox.py

@@ -123,24 +123,25 @@ class SandboxConnectCredentials:
 class Probe:
     """Probe configuration for the Sandbox Readiness Probe.
 
-    Usage:
-        ```py notest
-        # Wait until a file exists.
-        readiness_probe = modal.Probe.with_exec(
-            "sh", "-c", "test -f /tmp/ready",
-        )
-
-        # Wait until a TCP port is accepting connections.
-        readiness_probe = modal.Probe.with_tcp(8080)
-
-        app = modal.App.lookup('sandbox-readiness-probe', create_if_missing=True)
-        sandbox = modal.Sandbox.create(
-            "python3", "-m", "http.server", "8080",
-            readiness_probe=readiness_probe,
-            app=app,
-        )
-        sandbox.wait_until_ready()
-        ```
+    **Usage**
+
+    ```python notest
+    # Wait until a file exists.
+    readiness_probe = modal.Probe.with_exec(
+        "sh", "-c", "test -f /tmp/ready",
+    )
+
+    # Wait until a TCP port is accepting connections.
+    readiness_probe = modal.Probe.with_tcp(8080)
+
+    app = modal.App.lookup('sandbox-readiness-probe', create_if_missing=True)
+    sandbox = modal.Sandbox.create(
+        "python3", "-m", "http.server", "8080",
+        readiness_probe=readiness_probe,
+        app=app,
+    )
+    sandbox.wait_until_ready()
+    ```
     """
 
     tcp_port: Optional[int] = None

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/sandbox.pyi

@@ -74,24 +74,25 @@ class SandboxConnectCredentials:
 class Probe:
     """Probe configuration for the Sandbox Readiness Probe.
 
-    Usage:
-        ```py notest
-        # Wait until a file exists.
-        readiness_probe = modal.Probe.with_exec(
-            "sh", "-c", "test -f /tmp/ready",
-        )
-
-        # Wait until a TCP port is accepting connections.
-        readiness_probe = modal.Probe.with_tcp(8080)
-
-        app = modal.App.lookup('sandbox-readiness-probe', create_if_missing=True)
-        sandbox = modal.Sandbox.create(
-            "python3", "-m", "http.server", "8080",
-            readiness_probe=readiness_probe,
-            app=app,
-        )
-        sandbox.wait_until_ready()
-        ```
+    **Usage**
+
+    ```python notest
+    # Wait until a file exists.
+    readiness_probe = modal.Probe.with_exec(
+        "sh", "-c", "test -f /tmp/ready",
+    )
+
+    # Wait until a TCP port is accepting connections.
+    readiness_probe = modal.Probe.with_tcp(8080)
+
+    app = modal.App.lookup('sandbox-readiness-probe', create_if_missing=True)
+    sandbox = modal.Sandbox.create(
+        "python3", "-m", "http.server", "8080",
+        readiness_probe=readiness_probe,
+        app=app,
+    )
+    sandbox.wait_until_ready()
+    ```
     """
 
     tcp_port: typing.Optional[int]

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/sandbox_fs.py

@@ -12,8 +12,10 @@ from ._utils.async_utils import synchronize_api
 from ._utils.logger import logger
 from ._utils.sandbox_fs_utils import (
     make_read_file_command,
+    make_remove_command,
     make_write_file_command,
     raise_read_file_error,
+    raise_remove_error,
     raise_write_file_error,
     translate_exec_errors,
     validate_absolute_remote_path,
@@ -303,5 +305,51 @@ class _SandboxFilesystem:
         dur_s = max(time.monotonic() - t0, 0.001)
         _log_throughput(f"copy_from_local {local_path} -> {remote_path}", total_bytes, dur_s)
 
+    async def remove(self, remote_path: str, *, recursive: bool = False) -> None:
+        """Remove a file or directory in the Sandbox.
+
+        `remote_path` must be an absolute path in the Sandbox.
+
+        When `remote_path` is a directory and `recursive` is `False` (the
+        default), removes it only if it is empty. When `recursive` is `True`,
+        removes the directory and all its contents.
+
+        Recursive directory removal is not supported on all mounts.
+        In particular, `CloudBucketMount` does not support it. An
+        `InvalidError` is raised in that case.
+
+        **Raises**
+
+        - `SandboxFilesystemNotFoundError`: the path does not exist.
+        - `SandboxFilesystemDirectoryNotEmptyError`: `recursive` is `False` and the directory is not empty.
+        - `SandboxFilesystemPermissionError`: removal is not permitted.
+        - `InvalidError`: the operation is not supported by the mount.
+        - `SandboxFilesystemError`: the command fails for any other reason.
+
+        **Usage**
+
+        To remove a file:
+
+        ```python fixture:sandbox
+        sandbox.filesystem.write_bytes(b"Hello, world!\\n", "/tmp/hello.bin")
+        sandbox.filesystem.remove("/tmp/hello.bin")
+        ```
+
+        To remove a directory and all its contents:
+
+        ```python fixture:sandbox
+        sandbox.exec("mkdir", "-p", "/tmp/mydir/subdir").wait()
+        sandbox.filesystem.remove("/tmp/mydir", recursive=True)
+        ```
+        """
+        validate_absolute_remote_path(remote_path, "remove")
+
+        with translate_exec_errors("remove", remote_path):
+            process = await self._sandbox.exec(_SANDBOX_FS_TOOLS_PATH, make_remove_command(remote_path, recursive))
+            stderr, returncode = await asyncio.gather(process.stderr.read(), process.wait())
+
+        if returncode != 0:
+            raise_remove_error(returncode, stderr, remote_path)
+
 
 SandboxFilesystem = synchronize_api(_SandboxFilesystem)

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal/sandbox_fs.pyi

@@ -168,6 +168,45 @@ class _SandboxFilesystem:
         """
         ...
 
+    async def remove(self, remote_path: str, *, recursive: bool = False) -> None:
+        """Remove a file or directory in the Sandbox.
+
+        `remote_path` must be an absolute path in the Sandbox.
+
+        When `remote_path` is a directory and `recursive` is `False` (the
+        default), removes it only if it is empty. When `recursive` is `True`,
+        removes the directory and all its contents.
+
+        Recursive directory removal is not supported on all mounts.
+        In particular, `CloudBucketMount` does not support it. An
+        `InvalidError` is raised in that case.
+
+        **Raises**
+
+        - `SandboxFilesystemNotFoundError`: the path does not exist.
+        - `SandboxFilesystemDirectoryNotEmptyError`: `recursive` is `False` and the directory is not empty.
+        - `SandboxFilesystemPermissionError`: removal is not permitted.
+        - `InvalidError`: the operation is not supported by the mount.
+        - `SandboxFilesystemError`: the command fails for any other reason.
+
+        **Usage**
+
+        To remove a file:
+
+        ```python fixture:sandbox
+        sandbox.filesystem.write_bytes(b"Hello, world!\n", "/tmp/hello.bin")
+        sandbox.filesystem.remove("/tmp/hello.bin")
+        ```
+
+        To remove a directory and all its contents:
+
+        ```python fixture:sandbox
+        sandbox.exec("mkdir", "-p", "/tmp/mydir/subdir").wait()
+        sandbox.filesystem.remove("/tmp/mydir", recursive=True)
+        ```
+        """
+        ...
+
 class SandboxFilesystem:
     """mdmd:namespace
     Namespace for Sandbox filesystem APIs.
@@ -505,3 +544,84 @@ class SandboxFilesystem:
             ...
 
     copy_from_local: __copy_from_local_spec
+
+    class __remove_spec(typing_extensions.Protocol):
+        def __call__(self, /, remote_path: str, *, recursive: bool = False) -> None:
+            """Remove a file or directory in the Sandbox.
+
+            `remote_path` must be an absolute path in the Sandbox.
+
+            When `remote_path` is a directory and `recursive` is `False` (the
+            default), removes it only if it is empty. When `recursive` is `True`,
+            removes the directory and all its contents.
+
+            Recursive directory removal is not supported on all mounts.
+            In particular, `CloudBucketMount` does not support it. An
+            `InvalidError` is raised in that case.
+
+            **Raises**
+
+            - `SandboxFilesystemNotFoundError`: the path does not exist.
+            - `SandboxFilesystemDirectoryNotEmptyError`: `recursive` is `False` and the directory is not empty.
+            - `SandboxFilesystemPermissionError`: removal is not permitted.
+            - `InvalidError`: the operation is not supported by the mount.
+            - `SandboxFilesystemError`: the command fails for any other reason.
+
+            **Usage**
+
+            To remove a file:
+
+            ```python fixture:sandbox
+            sandbox.filesystem.write_bytes(b"Hello, world!\n", "/tmp/hello.bin")
+            sandbox.filesystem.remove("/tmp/hello.bin")
+            ```
+
+            To remove a directory and all its contents:
+
+            ```python fixture:sandbox
+            sandbox.exec("mkdir", "-p", "/tmp/mydir/subdir").wait()
+            sandbox.filesystem.remove("/tmp/mydir", recursive=True)
+            ```
+            """
+            ...
+
+        async def aio(self, /, remote_path: str, *, recursive: bool = False) -> None:
+            """Remove a file or directory in the Sandbox.
+
+            `remote_path` must be an absolute path in the Sandbox.
+
+            When `remote_path` is a directory and `recursive` is `False` (the
+            default), removes it only if it is empty. When `recursive` is `True`,
+            removes the directory and all its contents.
+
+            Recursive directory removal is not supported on all mounts.
+            In particular, `CloudBucketMount` does not support it. An
+            `InvalidError` is raised in that case.
+
+            **Raises**
+
+            - `SandboxFilesystemNotFoundError`: the path does not exist.
+            - `SandboxFilesystemDirectoryNotEmptyError`: `recursive` is `False` and the directory is not empty.
+            - `SandboxFilesystemPermissionError`: removal is not permitted.
+            - `InvalidError`: the operation is not supported by the mount.
+            - `SandboxFilesystemError`: the command fails for any other reason.
+
+            **Usage**
+
+            To remove a file:
+
+            ```python fixture:sandbox
+            sandbox.filesystem.write_bytes(b"Hello, world!\n", "/tmp/hello.bin")
+            sandbox.filesystem.remove("/tmp/hello.bin")
+            ```
+
+            To remove a directory and all its contents:
+
+            ```python fixture:sandbox
+            sandbox.exec("mkdir", "-p", "/tmp/mydir/subdir").wait()
+            sandbox.filesystem.remove("/tmp/mydir", recursive=True)
+            ```
+            """
+            ...
+
+    remove: __remove_spec

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.1.dev5
+Version: 1.4.2.dev0
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -23,7 +23,7 @@ Requires-Dist: grpclib<0.4.10,>=0.4.7; python_version < "3.14"
 Requires-Dist: grpclib<0.4.10,>=0.4.9; python_version >= "3.14"
 Requires-Dist: protobuf!=4.24.0,<7.0,>=3.19
 Requires-Dist: rich>=12.0.0
-Requires-Dist: synchronicity~=0.12.0
+Requires-Dist: synchronicity~=0.12.1
 Requires-Dist: toml
 Requires-Dist: typer>=0.9
 Requires-Dist: types-certifi

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal.egg-info/requires.txt

@@ -4,7 +4,7 @@ certifi
 click~=8.1
 protobuf!=4.24.0,<7.0,>=3.19
 rich>=12.0.0
-synchronicity~=0.12.0
+synchronicity~=0.12.1
 toml
 typer>=0.9
 types-certifi

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.4.1.dev5"
+__version__ = "1.4.2.dev0"

{modal-1.4.1.dev5 → modal-1.4.2.dev0}/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
     "grpclib>=0.4.9,<0.4.10 ; python_version >= '3.14'",
     "protobuf>=3.19,<7.0,!=4.24.0",
     "rich>=12.0.0",
-    "synchronicity~=0.12.0",
+    "synchronicity~=0.12.1",
     "toml",
     "typer>=0.9",
     "types-certifi",
@@ -71,7 +71,7 @@ dev = [
     "pyright~=1.1.351",
     "console-ctrl~=0.1.0",
     "zstandard~=0.25.0",
-    "synchronicity[compile]~=0.12.0",
+    "synchronicity[compile]~=0.12.1",
     "python-json-logger==2.0.7",
     "build~=1.3.0",