modal 1.1.5.dev15__py3-none-any.whl → 1.1.5.dev16__py3-none-any.whl

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.5.dev15",
+        version: str = "1.1.5.dev16",
     ):
         """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.5.dev15",
+        version: str = "1.1.5.dev16",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/sandbox.py

@@ -1,9 +1,11 @@
 # Copyright Modal Labs 2022
 import asyncio
+import json
 import os
 import time
 from collections.abc import AsyncGenerator, Sequence
-from typing import TYPE_CHECKING, AsyncIterator, Literal, Optional, Union, overload
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any, AsyncIterator, Literal, Optional, Union, overload
 
 from .config import config, logger
 
@@ -99,6 +101,14 @@ class DefaultSandboxNameOverride(str):
 _DEFAULT_SANDBOX_NAME_OVERRIDE = DefaultSandboxNameOverride()
 
 
+@dataclass(frozen=True)
+class SandboxConnectCredentials:
+    """Simple data structure storing credentials for making HTTP connections to a sandbox."""
+
+    url: str
+    token: str
+
+
 class _Sandbox(_Object, type_prefix="sb"):
     """A `Sandbox` object lets you interact with a running sandbox. This API is similar to Python's
     [asyncio.subprocess.Process](https://docs.python.org/3/library/asyncio-subprocess.html#asyncio.subprocess.Process).
@@ -626,6 +636,23 @@ class _Sandbox(_Object, type_prefix="sb"):
 
         return self._tunnels
 
+    async def create_connect_token(
+        self, metadata: Optional[Union[str, dict[str, Any]]] = None
+    ) -> SandboxConnectCredentials:
+        """Create a token for making HTTP connections to the sandbox.
+
+        Also accepts an optional metadata string or dict to associate with the token. This metadata
+        will be added to the headers by the proxy when forwarding requests to the sandbox."""
+        if metadata is not None and isinstance(metadata, dict):
+            try:
+                metadata = json.dumps(metadata)
+            except Exception as e:
+                raise InvalidError(f"Failed to serialize metadata: {e}")
+
+        req = api_pb2.SandboxCreateConnectTokenRequest(sandbox_id=self.object_id, metadata=metadata)
+        resp = await retry_transient_errors(self._client.stub.SandboxCreateConnectToken, req)
+        return SandboxConnectCredentials(resp.url, resp.token)
+
     async def reload_volumes(self) -> None:
         """Reload all Volumes mounted in the Sandbox.
 

modal/sandbox.pyi

@@ -39,6 +39,36 @@ class DefaultSandboxNameOverride(str):
 
 _DEFAULT_SANDBOX_NAME_OVERRIDE: DefaultSandboxNameOverride
 
+class SandboxConnectCredentials:
+    """Simple data structure storing credentials for making HTTP connections to a sandbox."""
+
+    url: str
+    token: str
+
+    def __init__(self, url: str, token: str) -> None:
+        """Initialize self.  See help(type(self)) for accurate signature."""
+        ...
+
+    def __repr__(self):
+        """Return repr(self)."""
+        ...
+
+    def __eq__(self, other):
+        """Return self==value."""
+        ...
+
+    def __setattr__(self, name, value):
+        """Implement setattr(self, name, value)."""
+        ...
+
+    def __delattr__(self, name):
+        """Implement delattr(self, name)."""
+        ...
+
+    def __hash__(self):
+        """Return hash(self)."""
+        ...
+
 class _Sandbox(modal._object._Object):
     """A `Sandbox` object lets you interact with a running sandbox. This API is similar to Python's
     [asyncio.subprocess.Process](https://docs.python.org/3/library/asyncio-subprocess.html#asyncio.subprocess.Process).
@@ -224,6 +254,16 @@ class _Sandbox(modal._object._Object):
         """
         ...
 
+    async def create_connect_token(
+        self, metadata: typing.Union[str, dict[str, typing.Any], None] = None
+    ) -> SandboxConnectCredentials:
+        """Create a token for making HTTP connections to the sandbox.
+
+        Also accepts an optional metadata string or dict to associate with the token. This metadata
+        will be added to the headers by the proxy when forwarding requests to the sandbox.
+        """
+        ...
+
     async def reload_volumes(self) -> None:
         """Reload all Volumes mounted in the Sandbox.
 
@@ -708,6 +748,29 @@ class Sandbox(modal.object.Object):
 
     tunnels: __tunnels_spec[typing_extensions.Self]
 
+    class __create_connect_token_spec(typing_extensions.Protocol[SUPERSELF]):
+        def __call__(
+            self, /, metadata: typing.Union[str, dict[str, typing.Any], None] = None
+        ) -> SandboxConnectCredentials:
+            """Create a token for making HTTP connections to the sandbox.
+
+            Also accepts an optional metadata string or dict to associate with the token. This metadata
+            will be added to the headers by the proxy when forwarding requests to the sandbox.
+            """
+            ...
+
+        async def aio(
+            self, /, metadata: typing.Union[str, dict[str, typing.Any], None] = None
+        ) -> SandboxConnectCredentials:
+            """Create a token for making HTTP connections to the sandbox.
+
+            Also accepts an optional metadata string or dict to associate with the token. This metadata
+            will be added to the headers by the proxy when forwarding requests to the sandbox.
+            """
+            ...
+
+    create_connect_token: __create_connect_token_spec[typing_extensions.Self]
+
     class __reload_volumes_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /) -> None:
             """Reload all Volumes mounted in the Sandbox.

{modal-1.1.5.dev15.dist-info → modal-1.1.5.dev16.dist-info}/METADATA

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

{modal-1.1.5.dev15.dist-info → modal-1.1.5.dev16.dist-info}/RECORD

@@ -22,7 +22,7 @@ modal/app.py,sha256=F4baVULljFq0CwC_7U-EKNRNx7CYeWBKudjjYUuWc4U,48416
 modal/app.pyi,sha256=AbXJCBkyt2rI_-M3VbTBYb32at0P6iRZuoC87xY_JrQ,43591
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=kyAIVB3Ay-XKJizQ_1ufUFB__EagV0MLmHJpyYyJ7J0,18636
-modal/client.pyi,sha256=EVR-5DQpNrl9KdLOS3BUBdjXBViBgiUWzVfOAsSyZpY,15831
+modal/client.pyi,sha256=ZTlMHTB-1zrkMR8-8C24M6SNrlKzbhQJ5k5nDwiIwhw,15831
 modal/cloud_bucket_mount.py,sha256=YOe9nnvSr4ZbeCn587d7_VhE9IioZYRvF9VYQTQux08,5914
 modal/cloud_bucket_mount.pyi,sha256=-qSfYAQvIoO_l2wsCCGTG5ZUwQieNKXdAO00yP1-LYU,7394
 modal/cls.py,sha256=pTEO7pHjlO7taMbIqs4oI9ZZgKDJpVKyGkO5ZT0w6tQ,40934
@@ -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=BDjFvr_rp67W5WGoGvV47uBPVsmp3yceoCqqHAGLFwg,42384
-modal/sandbox.pyi,sha256=mOyungHDDmUrg7jLmJpWuoUEbA4z6TUaVx291hndPmI,42049
+modal/sandbox.py,sha256=GYSF--CsWnm-uta5xEnhilMRhx4burLFJ2VsAJCl9l0,43519
+modal/sandbox.pyi,sha256=eu7ZcHRlrXAC54v0Q1pq3E--w0L9iHSLLW6gQsVS_Q0,44265
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
 modal/secret.py,sha256=jcNJKc4ZB2nvAn7HJFawInqE-_7sbB43IWLZwyLBQ28,19308
@@ -153,7 +153,7 @@ modal/experimental/__init__.py,sha256=fCqzo_f3vcY750vHtd7CtLs5dvdM_C0ZLLGb3zXuK9
 modal/experimental/flash.py,sha256=8HOHZ0XLSN8Znzsi6hGggS46CC6t_7IgGWyNoeSXS9o,28417
 modal/experimental/flash.pyi,sha256=R9VV0UDotiY9BRUjacB-xI4qhR3yBymAvEZFRFHztLs,15143
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.1.5.dev15.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.1.5.dev16.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=BfhHTlzVGwOKmBrMyLPzpnjxvFq16xQIkznYuN4k5Dc,121
+modal_version/__init__.py,sha256=cMKY8SDIJ0r3UzuMVrF4zlcfkTEjbjrpY7H7GBFCL8s,121
 modal_version/__main__.py,sha256=2FO0yYQQwDTh6udt1h-cBnGd1c4ZyHnHSI4BksxzVac,105
-modal-1.1.5.dev15.dist-info/METADATA,sha256=z6-yg2PdFZ3h2caVnZcdMoHj7Lr6M5QnZhoU_EToILE,2460
-modal-1.1.5.dev15.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.1.5.dev15.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.1.5.dev15.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.1.5.dev15.dist-info/RECORD,,
+modal-1.1.5.dev16.dist-info/METADATA,sha256=sI81kjsY50naAuY5QWX7TNoUDHXlsRPSOzUjM8dOQ8k,2460
+modal-1.1.5.dev16.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.1.5.dev16.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.1.5.dev16.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.1.5.dev16.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.5.dev15"
+__version__ = "1.1.5.dev16"