modal 1.1.5.dev78__tar.gz → 1.1.5.dev82__tar.gz

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/PKG-INFO

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

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal/app.py

@@ -227,7 +227,12 @@ class _App:
 
     @property
     def is_interactive(self) -> bool:
-        """Whether the current app for the app is running in interactive mode."""
+        """mdmd:hidden
+        Whether the current app for the app is running in interactive mode.
+
+        Note: this method will likely be deprecated in the future.
+
+        """
         # return self._name
         if self._running_app:
             return self._running_app.interactive
@@ -285,6 +290,11 @@ class _App:
         return app
 
     def set_description(self, description: str):
+        """mdmd:hidden
+        Set the description of the App before it starts running.
+
+        Note: we don't recommend using the method and may deprecate it in the future.
+        """
         self._description = description
 
     def _validate_blueprint_value(self, key: str, value: Any):
@@ -293,10 +303,18 @@ class _App:
 
     @property
     def image(self) -> _Image:
+        """mdmd:hidden
+        Retrieve the Image that will be used as the default for any Functions registered to the App.
+
+        Note: This property is only relevant in the build phase and won't be populated on a deployed
+        App that is retrieved via `modal.App.lookup`. It is likely to be deprecated in the future.
+
+        """
         return self._image
 
     @image.setter
     def image(self, value):
+        """mdmd:hidden"""
         self._image = value
 
     def _uncreate_all_objects(self):
@@ -515,37 +533,48 @@ class _App:
 
     @property
     def registered_functions(self) -> dict[str, _Function]:
-        """All modal.Function objects registered on the app.
+        """mdmd:hidden
+        All modal.Function objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         return self._functions
 
     @property
     def registered_classes(self) -> dict[str, _Cls]:
-        """All modal.Cls objects registered on the app.
+        """mdmd:hidden
+        All modal.Cls objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         return self._classes
 
     @property
     def registered_entrypoints(self) -> dict[str, _LocalEntrypoint]:
-        """All local CLI entrypoints registered on the app.
+        """mdmd:hidden
+        All local CLI entrypoints registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future.
         """
         return self._local_entrypoints
 
     @property
     def registered_web_endpoints(self) -> list[str]:
-        """Names of web endpoint (ie. webhook) functions registered on the app.
+        """mdmd:hidden
+        Names of web endpoint (ie. webhook) functions registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         return self._web_endpoints
 

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal/app.pyi

@@ -151,7 +151,11 @@ class _App:
 
     @property
     def is_interactive(self) -> bool:
-        """Whether the current app for the app is running in interactive mode."""
+        """mdmd:hidden
+        Whether the current app for the app is running in interactive mode.
+
+        Note: this method will likely be deprecated in the future.
+        """
         ...
 
     @property
@@ -185,12 +189,30 @@ class _App:
         """
         ...
 
-    def set_description(self, description: str): ...
+    def set_description(self, description: str):
+        """mdmd:hidden
+        Set the description of the App before it starts running.
+
+        Note: we don't recommend using the method and may deprecate it in the future.
+        """
+        ...
+
     def _validate_blueprint_value(self, key: str, value: typing.Any): ...
     @property
-    def image(self) -> modal.image._Image: ...
+    def image(self) -> modal.image._Image:
+        """mdmd:hidden
+        Retrieve the Image that will be used as the default for any Functions registered to the App.
+
+        Note: This property is only relevant in the build phase and won't be populated on a deployed
+        App that is retrieved via `modal.App.lookup`. It is likely to be deprecated in the future.
+        """
+        ...
+
     @image.setter
-    def image(self, value): ...
+    def image(self, value):
+        """mdmd:hidden"""
+        ...
+
     def _uncreate_all_objects(self): ...
     def _set_local_app(
         self, client: modal.client._Client, running_app: modal.running_app.RunningApp
@@ -301,37 +323,48 @@ class _App:
     def _init_container(self, client: modal.client._Client, running_app: modal.running_app.RunningApp): ...
     @property
     def registered_functions(self) -> dict[str, modal._functions._Function]:
-        """All modal.Function objects registered on the app.
+        """mdmd:hidden
+        All modal.Function objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 
     @property
     def registered_classes(self) -> dict[str, modal.cls._Cls]:
-        """All modal.Cls objects registered on the app.
+        """mdmd:hidden
+        All modal.Cls objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 
     @property
     def registered_entrypoints(self) -> dict[str, _LocalEntrypoint]:
-        """All local CLI entrypoints registered on the app.
+        """mdmd:hidden
+        All local CLI entrypoints registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future.
         """
         ...
 
     @property
     def registered_web_endpoints(self) -> list[str]:
-        """Names of web endpoint (ie. webhook) functions registered on the app.
+        """mdmd:hidden
+        Names of web endpoint (ie. webhook) functions registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 
@@ -638,7 +671,11 @@ class App:
 
     @property
     def is_interactive(self) -> bool:
-        """Whether the current app for the app is running in interactive mode."""
+        """mdmd:hidden
+        Whether the current app for the app is running in interactive mode.
+
+        Note: this method will likely be deprecated in the future.
+        """
         ...
 
     @property
@@ -698,12 +735,30 @@ class App:
 
     lookup: __lookup_spec
 
-    def set_description(self, description: str): ...
+    def set_description(self, description: str):
+        """mdmd:hidden
+        Set the description of the App before it starts running.
+
+        Note: we don't recommend using the method and may deprecate it in the future.
+        """
+        ...
+
     def _validate_blueprint_value(self, key: str, value: typing.Any): ...
     @property
-    def image(self) -> modal.image.Image: ...
+    def image(self) -> modal.image.Image:
+        """mdmd:hidden
+        Retrieve the Image that will be used as the default for any Functions registered to the App.
+
+        Note: This property is only relevant in the build phase and won't be populated on a deployed
+        App that is retrieved via `modal.App.lookup`. It is likely to be deprecated in the future.
+        """
+        ...
+
     @image.setter
-    def image(self, value): ...
+    def image(self, value):
+        """mdmd:hidden"""
+        ...
+
     def _uncreate_all_objects(self): ...
 
     class ___set_local_app_spec(typing_extensions.Protocol[SUPERSELF]):
@@ -931,37 +986,48 @@ class App:
     def _init_container(self, client: modal.client.Client, running_app: modal.running_app.RunningApp): ...
     @property
     def registered_functions(self) -> dict[str, modal.functions.Function]:
-        """All modal.Function objects registered on the app.
+        """mdmd:hidden
+        All modal.Function objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 
     @property
     def registered_classes(self) -> dict[str, modal.cls.Cls]:
-        """All modal.Cls objects registered on the app.
+        """mdmd:hidden
+        All modal.Cls objects registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 
     @property
     def registered_entrypoints(self) -> dict[str, LocalEntrypoint]:
-        """All local CLI entrypoints registered on the app.
+        """mdmd:hidden
+        All local CLI entrypoints registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future.
         """
         ...
 
     @property
     def registered_web_endpoints(self) -> list[str]:
-        """Names of web endpoint (ie. webhook) functions registered on the app.
+        """mdmd:hidden
+        Names of web endpoint (ie. webhook) functions registered on the app.
 
         Note: this property is populated only during the build phase, and it is not
         expected to work when a deplyoed App has been retrieved via `modal.App.lookup`.
+        This method is likely to be deprecated in the future in favor of a different
+        approach for retrieving the layout of a deployed App.
         """
         ...
 

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/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.dev78",
+        version: str = "1.1.5.dev82",
     ):
         """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.dev78",
+        version: str = "1.1.5.dev82",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal.egg-info/PKG-INFO

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

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router.proto

@@ -28,6 +28,26 @@ enum SandboxExecStdoutConfig {
   SANDBOX_EXEC_STDOUT_CONFIG_PIPE = 1;
 }
 
+message SandboxExecPollRequest {
+  // The task ID of the sandbox running the exec'd command.
+  string task_id = 1;
+  // The execution ID of the command to wait on.
+  string exec_id = 2;
+}
+
+// The response to a SandboxExecPollRequest. If the exec'd command has not
+// completed, exit_status will be unset.
+message SandboxExecPollResponse {
+  oneof exit_status {
+    // The exit code of the command.
+    int32 code = 1;
+    // The signal that terminated the command.
+    int32 signal = 2;
+  }
+  // TODO(saltzm): Give a way for the user to distinguish between normal exit
+  // and termination by Modal (due to sandbox timeout, exec exceeded deadline, etc.)
+}
+
 message SandboxExecStartRequest {
   // The task ID of the sandbox to execute the command in.
   string task_id = 1;
@@ -105,15 +125,17 @@ message SandboxExecWaitRequest {
 message SandboxExecWaitResponse {
   oneof exit_status {
     // The exit code of the command.
-    int32 code = 3;
+    int32 code = 1;
     // The signal that terminated the command.
-    int32 signal = 4;
+    int32 signal = 2;
   }
   // TODO(saltzm): Give a way for the user to distinguish between normal exit
   // and termination by Modal (due to sandbox timeout, exec exceeded deadline, etc.)
 }
 
 service SandboxRouter {
+  // Poll for the exit status of an exec'd command.
+  rpc SandboxExecPoll(SandboxExecPollRequest) returns (SandboxExecPollResponse);
   // Execute a command in the sandbox.
   rpc SandboxExecStart(SandboxExecStartRequest) returns (SandboxExecStartResponse);
  // Write to the stdin stream of an exec'd command.

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router_grpc.py

@@ -15,6 +15,10 @@ import modal_proto.sandbox_router_pb2
 
 class SandboxRouterBase(abc.ABC):
 
+    @abc.abstractmethod
+    async def SandboxExecPoll(self, stream: 'grpclib.server.Stream[modal_proto.sandbox_router_pb2.SandboxExecPollRequest, modal_proto.sandbox_router_pb2.SandboxExecPollResponse]') -> None:
+        pass
+
     @abc.abstractmethod
     async def SandboxExecStart(self, stream: 'grpclib.server.Stream[modal_proto.sandbox_router_pb2.SandboxExecStartRequest, modal_proto.sandbox_router_pb2.SandboxExecStartResponse]') -> None:
         pass
@@ -33,6 +37,12 @@ class SandboxRouterBase(abc.ABC):
 
     def __mapping__(self) -> typing.Dict[str, grpclib.const.Handler]:
         return {
+            '/modal.sandbox_router.SandboxRouter/SandboxExecPoll': grpclib.const.Handler(
+                self.SandboxExecPoll,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                modal_proto.sandbox_router_pb2.SandboxExecPollRequest,
+                modal_proto.sandbox_router_pb2.SandboxExecPollResponse,
+            ),
             '/modal.sandbox_router.SandboxRouter/SandboxExecStart': grpclib.const.Handler(
                 self.SandboxExecStart,
                 grpclib.const.Cardinality.UNARY_UNARY,
@@ -63,6 +73,12 @@ class SandboxRouterBase(abc.ABC):
 class SandboxRouterStub:
 
     def __init__(self, channel: grpclib.client.Channel) -> None:
+        self.SandboxExecPoll = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.sandbox_router.SandboxRouter/SandboxExecPoll',
+            modal_proto.sandbox_router_pb2.SandboxExecPollRequest,
+            modal_proto.sandbox_router_pb2.SandboxExecPollResponse,
+        )
         self.SandboxExecStart = grpclib.client.UnaryUnaryMethod(
             channel,
             '/modal.sandbox_router.SandboxRouter/SandboxExecStart',

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router_pb2.py

@@ -16,7 +16,7 @@ _sym_db = _symbol_database.Default()
 from modal_proto import api_pb2 as modal__proto_dot_api__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n modal_proto/sandbox_router.proto\x12\x14modal.sandbox_router\x1a\x15modal_proto/api.proto\"\x91\x03\n\x17SandboxExecStartRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x14\n\x0c\x63ommand_args\x18\x03 \x03(\t\x12\x44\n\rstdout_config\x18\x04 \x01(\x0e\x32-.modal.sandbox_router.SandboxExecStdoutConfig\x12\x44\n\rstderr_config\x18\x05 \x01(\x0e\x32-.modal.sandbox_router.SandboxExecStderrConfig\x12\x19\n\x0ctimeout_secs\x18\x06 \x01(\rH\x00\x88\x01\x01\x12\x14\n\x07workdir\x18\x07 \x01(\tH\x01\x88\x01\x01\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x12,\n\x08pty_info\x18\t \x01(\x0b\x32\x15.modal.client.PTYInfoH\x02\x88\x01\x01\x12\x15\n\rruntime_debug\x18\n \x01(\x08\x42\x0f\n\r_timeout_secsB\n\n\x08_workdirB\x0b\n\t_pty_info\"\x1a\n\x18SandboxExecStartResponse\"k\n\x1cSandboxExecStdinWriteRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x04 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x05 \x01(\x08\"\x1f\n\x1dSandboxExecStdinWriteResponse\"\x9e\x01\n\x1bSandboxExecStdioReadRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12M\n\x0f\x66ile_descriptor\x18\x04 \x01(\x0e\x32\x34.modal.sandbox_router.SandboxExecStdioFileDescriptor\",\n\x1cSandboxExecStdioReadResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\":\n\x16SandboxExecWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"J\n\x17SandboxExecWaitResponse\x12\x0e\n\x04\x63ode\x18\x03 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x04 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status*\x8d\x01\n\x17SandboxExecStderrConfig\x12&\n\"SANDBOX_EXEC_STDERR_CONFIG_DEVNULL\x10\x00\x12#\n\x1fSANDBOX_EXEC_STDERR_CONFIG_PIPE\x10\x01\x12%\n!SANDBOX_EXEC_STDERR_CONFIG_STDOUT\x10\x02*~\n\x1eSandboxExecStdioFileDescriptor\x12-\n)SANDBOX_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12-\n)SANDBOX_EXEC_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*f\n\x17SandboxExecStdoutConfig\x12&\n\"SANDBOX_EXEC_STDOUT_CONFIG_DEVNULL\x10\x00\x12#\n\x1fSANDBOX_EXEC_STDOUT_CONFIG_PIPE\x10\x01\x32\xf6\x03\n\rSandboxRouter\x12q\n\x10SandboxExecStart\x12-.modal.sandbox_router.SandboxExecStartRequest\x1a..modal.sandbox_router.SandboxExecStartResponse\x12\x80\x01\n\x15SandboxExecStdinWrite\x12\x32.modal.sandbox_router.SandboxExecStdinWriteRequest\x1a\x33.modal.sandbox_router.SandboxExecStdinWriteResponse\x12\x7f\n\x14SandboxExecStdioRead\x12\x31.modal.sandbox_router.SandboxExecStdioReadRequest\x1a\x32.modal.sandbox_router.SandboxExecStdioReadResponse0\x01\x12n\n\x0fSandboxExecWait\x12,.modal.sandbox_router.SandboxExecWaitRequest\x1a-.modal.sandbox_router.SandboxExecWaitResponseb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n modal_proto/sandbox_router.proto\x12\x14modal.sandbox_router\x1a\x15modal_proto/api.proto\":\n\x16SandboxExecPollRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"J\n\x17SandboxExecPollResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status\"\x91\x03\n\x17SandboxExecStartRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x14\n\x0c\x63ommand_args\x18\x03 \x03(\t\x12\x44\n\rstdout_config\x18\x04 \x01(\x0e\x32-.modal.sandbox_router.SandboxExecStdoutConfig\x12\x44\n\rstderr_config\x18\x05 \x01(\x0e\x32-.modal.sandbox_router.SandboxExecStderrConfig\x12\x19\n\x0ctimeout_secs\x18\x06 \x01(\rH\x00\x88\x01\x01\x12\x14\n\x07workdir\x18\x07 \x01(\tH\x01\x88\x01\x01\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x12,\n\x08pty_info\x18\t \x01(\x0b\x32\x15.modal.client.PTYInfoH\x02\x88\x01\x01\x12\x15\n\rruntime_debug\x18\n \x01(\x08\x42\x0f\n\r_timeout_secsB\n\n\x08_workdirB\x0b\n\t_pty_info\"\x1a\n\x18SandboxExecStartResponse\"k\n\x1cSandboxExecStdinWriteRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x04 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x05 \x01(\x08\"\x1f\n\x1dSandboxExecStdinWriteResponse\"\x9e\x01\n\x1bSandboxExecStdioReadRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12M\n\x0f\x66ile_descriptor\x18\x04 \x01(\x0e\x32\x34.modal.sandbox_router.SandboxExecStdioFileDescriptor\",\n\x1cSandboxExecStdioReadResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\":\n\x16SandboxExecWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"J\n\x17SandboxExecWaitResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status*\x8d\x01\n\x17SandboxExecStderrConfig\x12&\n\"SANDBOX_EXEC_STDERR_CONFIG_DEVNULL\x10\x00\x12#\n\x1fSANDBOX_EXEC_STDERR_CONFIG_PIPE\x10\x01\x12%\n!SANDBOX_EXEC_STDERR_CONFIG_STDOUT\x10\x02*~\n\x1eSandboxExecStdioFileDescriptor\x12-\n)SANDBOX_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12-\n)SANDBOX_EXEC_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*f\n\x17SandboxExecStdoutConfig\x12&\n\"SANDBOX_EXEC_STDOUT_CONFIG_DEVNULL\x10\x00\x12#\n\x1fSANDBOX_EXEC_STDOUT_CONFIG_PIPE\x10\x01\x32\xe6\x04\n\rSandboxRouter\x12n\n\x0fSandboxExecPoll\x12,.modal.sandbox_router.SandboxExecPollRequest\x1a-.modal.sandbox_router.SandboxExecPollResponse\x12q\n\x10SandboxExecStart\x12-.modal.sandbox_router.SandboxExecStartRequest\x1a..modal.sandbox_router.SandboxExecStartResponse\x12\x80\x01\n\x15SandboxExecStdinWrite\x12\x32.modal.sandbox_router.SandboxExecStdinWriteRequest\x1a\x33.modal.sandbox_router.SandboxExecStdinWriteResponse\x12\x7f\n\x14SandboxExecStdioRead\x12\x31.modal.sandbox_router.SandboxExecStdioReadRequest\x1a\x32.modal.sandbox_router.SandboxExecStdioReadResponse0\x01\x12n\n\x0fSandboxExecWait\x12,.modal.sandbox_router.SandboxExecWaitRequest\x1a-.modal.sandbox_router.SandboxExecWaitResponseb\x06proto3')
 
 _SANDBOXEXECSTDERRCONFIG = DESCRIPTOR.enum_types_by_name['SandboxExecStderrConfig']
 SandboxExecStderrConfig = enum_type_wrapper.EnumTypeWrapper(_SANDBOXEXECSTDERRCONFIG)
@@ -33,6 +33,8 @@ SANDBOX_EXEC_STDOUT_CONFIG_DEVNULL = 0
 SANDBOX_EXEC_STDOUT_CONFIG_PIPE = 1
 
 
+_SANDBOXEXECPOLLREQUEST = DESCRIPTOR.message_types_by_name['SandboxExecPollRequest']
+_SANDBOXEXECPOLLRESPONSE = DESCRIPTOR.message_types_by_name['SandboxExecPollResponse']
 _SANDBOXEXECSTARTREQUEST = DESCRIPTOR.message_types_by_name['SandboxExecStartRequest']
 _SANDBOXEXECSTARTRESPONSE = DESCRIPTOR.message_types_by_name['SandboxExecStartResponse']
 _SANDBOXEXECSTDINWRITEREQUEST = DESCRIPTOR.message_types_by_name['SandboxExecStdinWriteRequest']
@@ -41,6 +43,20 @@ _SANDBOXEXECSTDIOREADREQUEST = DESCRIPTOR.message_types_by_name['SandboxExecStdi
 _SANDBOXEXECSTDIOREADRESPONSE = DESCRIPTOR.message_types_by_name['SandboxExecStdioReadResponse']
 _SANDBOXEXECWAITREQUEST = DESCRIPTOR.message_types_by_name['SandboxExecWaitRequest']
 _SANDBOXEXECWAITRESPONSE = DESCRIPTOR.message_types_by_name['SandboxExecWaitResponse']
+SandboxExecPollRequest = _reflection.GeneratedProtocolMessageType('SandboxExecPollRequest', (_message.Message,), {
+  'DESCRIPTOR' : _SANDBOXEXECPOLLREQUEST,
+  '__module__' : 'modal_proto.sandbox_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.sandbox_router.SandboxExecPollRequest)
+  })
+_sym_db.RegisterMessage(SandboxExecPollRequest)
+
+SandboxExecPollResponse = _reflection.GeneratedProtocolMessageType('SandboxExecPollResponse', (_message.Message,), {
+  'DESCRIPTOR' : _SANDBOXEXECPOLLRESPONSE,
+  '__module__' : 'modal_proto.sandbox_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.sandbox_router.SandboxExecPollResponse)
+  })
+_sym_db.RegisterMessage(SandboxExecPollResponse)
+
 SandboxExecStartRequest = _reflection.GeneratedProtocolMessageType('SandboxExecStartRequest', (_message.Message,), {
   'DESCRIPTOR' : _SANDBOXEXECSTARTREQUEST,
   '__module__' : 'modal_proto.sandbox_router_pb2'
@@ -101,28 +117,32 @@ _SANDBOXROUTER = DESCRIPTOR.services_by_name['SandboxRouter']
 if _descriptor._USE_C_DESCRIPTORS == False:
 
   DESCRIPTOR._options = None
-  _SANDBOXEXECSTDERRCONFIG._serialized_start=999
-  _SANDBOXEXECSTDERRCONFIG._serialized_end=1140
-  _SANDBOXEXECSTDIOFILEDESCRIPTOR._serialized_start=1142
-  _SANDBOXEXECSTDIOFILEDESCRIPTOR._serialized_end=1268
-  _SANDBOXEXECSTDOUTCONFIG._serialized_start=1270
-  _SANDBOXEXECSTDOUTCONFIG._serialized_end=1372
-  _SANDBOXEXECSTARTREQUEST._serialized_start=82
-  _SANDBOXEXECSTARTREQUEST._serialized_end=483
-  _SANDBOXEXECSTARTRESPONSE._serialized_start=485
-  _SANDBOXEXECSTARTRESPONSE._serialized_end=511
-  _SANDBOXEXECSTDINWRITEREQUEST._serialized_start=513
-  _SANDBOXEXECSTDINWRITEREQUEST._serialized_end=620
-  _SANDBOXEXECSTDINWRITERESPONSE._serialized_start=622
-  _SANDBOXEXECSTDINWRITERESPONSE._serialized_end=653
-  _SANDBOXEXECSTDIOREADREQUEST._serialized_start=656
-  _SANDBOXEXECSTDIOREADREQUEST._serialized_end=814
-  _SANDBOXEXECSTDIOREADRESPONSE._serialized_start=816
-  _SANDBOXEXECSTDIOREADRESPONSE._serialized_end=860
-  _SANDBOXEXECWAITREQUEST._serialized_start=862
-  _SANDBOXEXECWAITREQUEST._serialized_end=920
-  _SANDBOXEXECWAITRESPONSE._serialized_start=922
-  _SANDBOXEXECWAITRESPONSE._serialized_end=996
-  _SANDBOXROUTER._serialized_start=1375
-  _SANDBOXROUTER._serialized_end=1877
+  _SANDBOXEXECSTDERRCONFIG._serialized_start=1135
+  _SANDBOXEXECSTDERRCONFIG._serialized_end=1276
+  _SANDBOXEXECSTDIOFILEDESCRIPTOR._serialized_start=1278
+  _SANDBOXEXECSTDIOFILEDESCRIPTOR._serialized_end=1404
+  _SANDBOXEXECSTDOUTCONFIG._serialized_start=1406
+  _SANDBOXEXECSTDOUTCONFIG._serialized_end=1508
+  _SANDBOXEXECPOLLREQUEST._serialized_start=81
+  _SANDBOXEXECPOLLREQUEST._serialized_end=139
+  _SANDBOXEXECPOLLRESPONSE._serialized_start=141
+  _SANDBOXEXECPOLLRESPONSE._serialized_end=215
+  _SANDBOXEXECSTARTREQUEST._serialized_start=218
+  _SANDBOXEXECSTARTREQUEST._serialized_end=619
+  _SANDBOXEXECSTARTRESPONSE._serialized_start=621
+  _SANDBOXEXECSTARTRESPONSE._serialized_end=647
+  _SANDBOXEXECSTDINWRITEREQUEST._serialized_start=649
+  _SANDBOXEXECSTDINWRITEREQUEST._serialized_end=756
+  _SANDBOXEXECSTDINWRITERESPONSE._serialized_start=758
+  _SANDBOXEXECSTDINWRITERESPONSE._serialized_end=789
+  _SANDBOXEXECSTDIOREADREQUEST._serialized_start=792
+  _SANDBOXEXECSTDIOREADREQUEST._serialized_end=950
+  _SANDBOXEXECSTDIOREADRESPONSE._serialized_start=952
+  _SANDBOXEXECSTDIOREADRESPONSE._serialized_end=996
+  _SANDBOXEXECWAITREQUEST._serialized_start=998
+  _SANDBOXEXECWAITREQUEST._serialized_end=1056
+  _SANDBOXEXECWAITRESPONSE._serialized_start=1058
+  _SANDBOXEXECWAITRESPONSE._serialized_end=1132
+  _SANDBOXROUTER._serialized_start=1511
+  _SANDBOXROUTER._serialized_end=2125
 # @@protoc_insertion_point(module_scope)

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router_pb2.pyi

@@ -84,6 +84,50 @@ SANDBOX_EXEC_STDOUT_CONFIG_PIPE: SandboxExecStdoutConfig.ValueType  # 1
 """The output will be streamed to the client."""
 global___SandboxExecStdoutConfig = SandboxExecStdoutConfig
 
+class SandboxExecPollRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The task ID of the sandbox running the exec'd command."""
+    exec_id: builtins.str
+    """The execution ID of the command to wait on."""
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["exec_id", b"exec_id", "task_id", b"task_id"]) -> None: ...
+
+global___SandboxExecPollRequest = SandboxExecPollRequest
+
+class SandboxExecPollResponse(google.protobuf.message.Message):
+    """The response to a SandboxExecPollRequest. If the exec'd command has not
+    completed, exit_status will be unset.
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CODE_FIELD_NUMBER: builtins.int
+    SIGNAL_FIELD_NUMBER: builtins.int
+    code: builtins.int
+    """The exit code of the command."""
+    signal: builtins.int
+    """The signal that terminated the command."""
+    def __init__(
+        self,
+        *,
+        code: builtins.int = ...,
+        signal: builtins.int = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["exit_status", b"exit_status"]) -> typing_extensions.Literal["code", "signal"] | None: ...
+
+global___SandboxExecPollResponse = SandboxExecPollResponse
+
 class SandboxExecStartRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router_pb2_grpc.py

@@ -14,6 +14,11 @@ class SandboxRouterStub(object):
         Args:
             channel: A grpc.Channel.
         """
+        self.SandboxExecPoll = channel.unary_unary(
+                '/modal.sandbox_router.SandboxRouter/SandboxExecPoll',
+                request_serializer=modal__proto_dot_sandbox__router__pb2.SandboxExecPollRequest.SerializeToString,
+                response_deserializer=modal__proto_dot_sandbox__router__pb2.SandboxExecPollResponse.FromString,
+                )
         self.SandboxExecStart = channel.unary_unary(
                 '/modal.sandbox_router.SandboxRouter/SandboxExecStart',
                 request_serializer=modal__proto_dot_sandbox__router__pb2.SandboxExecStartRequest.SerializeToString,
@@ -39,6 +44,13 @@ class SandboxRouterStub(object):
 class SandboxRouterServicer(object):
     """Missing associated documentation comment in .proto file."""
 
+    def SandboxExecPoll(self, request, context):
+        """Poll for the exit status of an exec'd command.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def SandboxExecStart(self, request, context):
         """Execute a command in the sandbox.
         """
@@ -70,6 +82,11 @@ class SandboxRouterServicer(object):
 
 def add_SandboxRouterServicer_to_server(servicer, server):
     rpc_method_handlers = {
+            'SandboxExecPoll': grpc.unary_unary_rpc_method_handler(
+                    servicer.SandboxExecPoll,
+                    request_deserializer=modal__proto_dot_sandbox__router__pb2.SandboxExecPollRequest.FromString,
+                    response_serializer=modal__proto_dot_sandbox__router__pb2.SandboxExecPollResponse.SerializeToString,
+            ),
             'SandboxExecStart': grpc.unary_unary_rpc_method_handler(
                     servicer.SandboxExecStart,
                     request_deserializer=modal__proto_dot_sandbox__router__pb2.SandboxExecStartRequest.FromString,
@@ -100,6 +117,23 @@ def add_SandboxRouterServicer_to_server(servicer, server):
 class SandboxRouter(object):
     """Missing associated documentation comment in .proto file."""
 
+    @staticmethod
+    def SandboxExecPoll(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/modal.sandbox_router.SandboxRouter/SandboxExecPoll',
+            modal__proto_dot_sandbox__router__pb2.SandboxExecPollRequest.SerializeToString,
+            modal__proto_dot_sandbox__router__pb2.SandboxExecPollResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
     @staticmethod
     def SandboxExecStart(request,
             target,

{modal-1.1.5.dev78 → modal-1.1.5.dev82}/modal_proto/sandbox_router_pb2_grpc.pyi

@@ -9,6 +9,11 @@ import modal_proto.sandbox_router_pb2
 
 class SandboxRouterStub:
     def __init__(self, channel: grpc.Channel) -> None: ...
+    SandboxExecPoll: grpc.UnaryUnaryMultiCallable[
+        modal_proto.sandbox_router_pb2.SandboxExecPollRequest,
+        modal_proto.sandbox_router_pb2.SandboxExecPollResponse,
+    ]
+    """Poll for the exit status of an exec'd command."""
     SandboxExecStart: grpc.UnaryUnaryMultiCallable[
         modal_proto.sandbox_router_pb2.SandboxExecStartRequest,
         modal_proto.sandbox_router_pb2.SandboxExecStartResponse,
@@ -32,6 +37,13 @@ class SandboxRouterStub:
 
 class SandboxRouterServicer(metaclass=abc.ABCMeta):
     @abc.abstractmethod
+    def SandboxExecPoll(
+        self,
+        request: modal_proto.sandbox_router_pb2.SandboxExecPollRequest,
+        context: grpc.ServicerContext,
+    ) -> modal_proto.sandbox_router_pb2.SandboxExecPollResponse:
+        """Poll for the exit status of an exec'd command."""
+    @abc.abstractmethod
     def SandboxExecStart(
         self,
         request: modal_proto.sandbox_router_pb2.SandboxExecStartRequest,