modal 1.5.6.dev31__tar.gz → 1.6.0__tar.gz

{modal-1.5.6.dev31 → modal-1.6.0}/PKG-INFO

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

{modal-1.5.6.dev31 → modal-1.6.0}/modal/_functions.py

@@ -1749,14 +1749,14 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         return list(self._experimental_flash_urls) if self._experimental_flash_urls else None
 
     async def _fetch_flash_auth_token(self, retry: Retry) -> str:
-        resp = await self.client.stub.FunctionGetFlashAuthToken(
+        resp = await self.client._stub.FunctionGetFlashAuthToken(
             api_pb2.FunctionGetFlashAuthTokenRequest(function_id=self.object_id), retry=retry
         )
         return resp.token
 
     async def _get_flash_auth_token(self) -> str:
         if self._flash_token_manager is None:
-            self._flash_token_manager = _AuthTokenManager(self.client.stub, fetch=self._fetch_flash_auth_token)
+            self._flash_token_manager = _AuthTokenManager(self.client._stub, fetch=self._fetch_flash_auth_token)
         return await self._flash_token_manager.get_token()
 
     def _apply_dynamic_config(

{modal-1.5.6.dev31 → modal-1.6.0}/modal/_partial_function.py

@@ -732,7 +732,7 @@ def _sessioned() -> Callable[
     [Callable[P, ReturnType] | _PartialFunction[P, ReturnType, ReturnType]],
     _PartialFunction[P, ReturnType, ReturnType],
 ]:
-    """Decorator that enables sessions on a Server.
+    """Decorator that enables sticky sessions on a Server.
 
     Every request must carry a session token obtained from a session start request; requests with the same token are
     routed to the same container until the session is idle for `idle_timeout` seconds or explicitly terminated. A

{modal-1.5.6.dev31 → modal-1.6.0}/modal/_server.py

@@ -113,7 +113,7 @@ class _Server:
 
     @property
     def sessions(self) -> "_ServerSessionsManager":
-        """Start and terminate sessions on a Server decorated with `@modal.sessioned()`."""
+        """Start and terminate sticky sessions on a Server decorated with `@modal.sessioned()`."""
         return _ServerSessionsManager(self)
 
     async def info(self, *, refresh: bool = False) -> ServerInfo:
@@ -160,7 +160,7 @@ class _Server:
         This interface is experimental and may change or be removed without warning.
         """
         service_function = self._get_service_function()
-        response = await service_function.client.stub.FlashContainerList(
+        response = await service_function.client._stub.FlashContainerList(
             api_pb2.FlashContainerListRequest(function_id=service_function.object_id)
         )
         return [
@@ -473,13 +473,13 @@ class _Server:
         request.until.FromDatetime(until)
         if container:
             request.container_id = container
-        stats = await self._get_service_function().client.stub.ServerGetTimeRangeStats(request)
+        stats = await self._get_service_function().client._stub.ServerGetTimeRangeStats(request)
         return ServerStats._from_proto(stats)
 
 
 @retry(n_attempts=5, base_delay=0.5, attempt_timeout=65, total_timeout=200)
 async def _post_session_control(url: str, headers: dict[str, str]) -> tuple[int, str, str]:
-    """POST to a session control endpoint, retrying connection errors and 5xx. Returns (status, reason, body)."""
+    """POST to a sticky session control endpoint, retrying connection errors and 5xx. Returns (status, reason, body)."""
     async with ClientSessionRegistry.get_session().post(url, headers=headers) as resp:
         body = await resp.text()
         if resp.status >= 400:
@@ -501,11 +501,11 @@ class _ServerSessionsManager:
             raise InvalidError("`sessions` requires `@modal.sessioned()` on the Server.")
 
     async def start(self, idle_timeout: int = 600) -> ServerSessionCredentials:
-        """Start a session and return its ID and token.
+        """Start a sticky session and return its ID and token.
 
-        Requests to the server URL that carry the returned token are routed to the same container until the session
-        has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down for as long
-        as it holds a live session.
+        Requests to the server URL that carry the returned token are routed to the same container until the
+        session has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down
+        for as long as it holds a live session.
 
         Args:
             idle_timeout: Seconds without an in-flight request before the session ends.
@@ -550,7 +550,9 @@ class _ServerSessionsManager:
             raise ExecutionError("Failed to start session: unexpected response from server") from None
 
     async def terminate(self, token: str) -> None:
-        """Terminate a session. New requests to it will be rejected. Container will continue serving other sessions.
+        """Terminate a sticky session.
+
+        New requests to it will be rejected. The container continues serving other sessions.
 
         Args:
             token: The `token` of the `ServerSessionCredentials` to terminate.

{modal-1.5.6.dev31 → modal-1.6.0}/modal/_server.pyi

@@ -67,7 +67,7 @@ class _Server:
 
     @property
     def sessions(self) -> _ServerSessionsManager:
-        """Start and terminate sessions on a Server decorated with `@modal.sessioned()`."""
+        """Start and terminate sticky sessions on a Server decorated with `@modal.sessioned()`."""
         ...
 
     async def info(self, *, refresh: bool = False) -> modal.types.ServerInfo:
@@ -272,7 +272,7 @@ class _Server:
         ...
 
 async def _post_session_control(url: str, headers: dict[str, str]) -> tuple[int, str, str]:
-    """POST to a session control endpoint, retrying connection errors and 5xx. Returns (status, reason, body)."""
+    """POST to a sticky session control endpoint, retrying connection errors and 5xx. Returns (status, reason, body)."""
     ...
 
 class _ServerSessionsManager:
@@ -283,11 +283,11 @@ class _ServerSessionsManager:
 
     def _validate(self) -> None: ...
     async def start(self, idle_timeout: int = 600) -> modal.types.ServerSessionCredentials:
-        """Start a session and return its ID and token.
+        """Start a sticky session and return its ID and token.
 
-        Requests to the server URL that carry the returned token are routed to the same container until the session
-        has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down for as long
-        as it holds a live session.
+        Requests to the server URL that carry the returned token are routed to the same container until the
+        session has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down
+        for as long as it holds a live session.
 
         Args:
             idle_timeout: Seconds without an in-flight request before the session ends.
@@ -308,7 +308,9 @@ class _ServerSessionsManager:
         ...
 
     async def terminate(self, token: str) -> None:
-        """Terminate a session. New requests to it will be rejected. Container will continue serving other sessions.
+        """Terminate a sticky session.
+
+        New requests to it will be rejected. The container continues serving other sessions.
 
         Args:
             token: The `token` of the `ServerSessionCredentials` to terminate.
@@ -334,11 +336,11 @@ class ServerSessionsManager:
 
     class __start_spec(typing_extensions.Protocol):
         def __call__(self, /, idle_timeout: int = 600) -> modal.types.ServerSessionCredentials:
-            """Start a session and return its ID and token.
+            """Start a sticky session and return its ID and token.
 
-            Requests to the server URL that carry the returned token are routed to the same container until the session
-            has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down for as long
-            as it holds a live session.
+            Requests to the server URL that carry the returned token are routed to the same container until the
+            session has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down
+            for as long as it holds a live session.
 
             Args:
                 idle_timeout: Seconds without an in-flight request before the session ends.
@@ -359,11 +361,11 @@ class ServerSessionsManager:
             ...
 
         async def aio(self, /, idle_timeout: int = 600) -> modal.types.ServerSessionCredentials:
-            """Start a session and return its ID and token.
+            """Start a sticky session and return its ID and token.
 
-            Requests to the server URL that carry the returned token are routed to the same container until the session
-            has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down for as long
-            as it holds a live session.
+            Requests to the server URL that carry the returned token are routed to the same container until the
+            session has had no connections for `idle_timeout` seconds or is terminated. A container won't be scaled down
+            for as long as it holds a live session.
 
             Args:
                 idle_timeout: Seconds without an in-flight request before the session ends.
@@ -387,7 +389,9 @@ class ServerSessionsManager:
 
     class __terminate_spec(typing_extensions.Protocol):
         def __call__(self, /, token: str) -> None:
-            """Terminate a session. New requests to it will be rejected. Container will continue serving other sessions.
+            """Terminate a sticky session.
+
+            New requests to it will be rejected. The container continues serving other sessions.
 
             Args:
                 token: The `token` of the `ServerSessionCredentials` to terminate.
@@ -404,7 +408,9 @@ class ServerSessionsManager:
             ...
 
         async def aio(self, /, token: str) -> None:
-            """Terminate a session. New requests to it will be rejected. Container will continue serving other sessions.
+            """Terminate a sticky session.
+
+            New requests to it will be rejected. The container continues serving other sessions.
 
             Args:
                 token: The `token` of the `ServerSessionCredentials` to terminate.

{modal-1.5.6.dev31 → modal-1.6.0}/modal/client.pyi

@@ -80,7 +80,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.6.dev31",
+        version: str = "1.6.0",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):
@@ -290,7 +290,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.6.dev31",
+        version: str = "1.6.0",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):

{modal-1.5.6.dev31 → modal-1.6.0}/modal/functions.pyi

@@ -613,7 +613,7 @@ class Function(
 
     _call_generator: ___call_generator_spec
 
-    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         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.
 
@@ -638,7 +638,7 @@ class Function(
             """
             ...
 
-    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType]
+    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P]
 
     class __remote_gen_spec(typing_extensions.Protocol):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -688,7 +688,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         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.
 
@@ -721,7 +721,7 @@ class Function(
             """
             ...
 
-    _experimental_spawn: ___experimental_spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    _experimental_spawn: ___experimental_spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> None: ...
@@ -729,7 +729,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P]
 
-    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         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.
 
@@ -762,7 +762,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     @property
     def _raw_f_(self) -> collections.abc.Callable[..., typing.Any]: ...

{modal-1.5.6.dev31 → modal-1.6.0}/modal/partial_function.pyi

@@ -384,7 +384,7 @@ def sessioned() -> collections.abc.Callable[
     ],
     PartialFunction[modal._partial_function.P, modal._partial_function.ReturnType, modal._partial_function.ReturnType],
 ]:
-    """Decorator that enables sessions on a Server.
+    """Decorator that enables sticky sessions on a Server.
 
     Every request must carry a session token obtained from a session start request; requests with the same token are
     routed to the same container until the session is idle for `idle_timeout` seconds or explicitly terminated. A

{modal-1.5.6.dev31 → modal-1.6.0}/modal/server.pyi

@@ -68,7 +68,7 @@ class Server:
 
     @property
     def sessions(self) -> modal._server.ServerSessionsManager:
-        """Start and terminate sessions on a Server decorated with `@modal.sessioned()`."""
+        """Start and terminate sticky sessions on a Server decorated with `@modal.sessioned()`."""
         ...
 
     class __info_spec(typing_extensions.Protocol):

{modal-1.5.6.dev31 → modal-1.6.0}/modal/types.py

@@ -947,7 +947,10 @@ class ServerInfo:
 
 @dataclass(frozen=True)
 class ServerSessionCredentials:
-    """Credentials for a session on a Server. Requests carrying `token` are routed to the same container."""
+    """Credentials for a sticky session on a Server.
+
+    Requests carrying `token` are routed to the same container.
+    """
 
     session_id: str  # Identifier of this session, for display and logging
     token: str  # Session token to send with every request

{modal-1.5.6.dev31 → modal-1.6.0}/modal.egg-info/PKG-INFO

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

{modal-1.5.6.dev31 → modal-1.6.0}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.5.6.dev31"
+__version__ = "1.6.0"