modal 1.4.4.dev13__tar.gz → 1.4.4.dev14__tar.gz

{modal-1.4.4.dev13 → modal-1.4.4.dev14}/PKG-INFO

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

{modal-1.4.4.dev13 → modal-1.4.4.dev14}/modal/_container_entrypoint.py

@@ -401,9 +401,8 @@ def main(container_args: api_pb2.ContainerArguments, client: Client):
                 function_def._experimental_group_size,
             )
 
-        with service.execution_context(
+        with service.function_execution_context(
             event_loop=event_loop,
-            snapshot=container_io_manager.memory_snapshot,
             container_io_manager=container_io_manager,
         ) as finalized_functions:
             # This context managers handles pre/post snapshot lifecycle of the user code,

{modal-1.4.4.dev13 → modal-1.4.4.dev14}/modal/_functions.py

@@ -1165,21 +1165,26 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         Subsequent deployments of the App containing this Function will reset the autoscaler back to
         its static configuration.
 
-        Examples:
+        Args:
+            min_containers: Minimum number of containers to keep running, or `None` to leave unchanged.
+            max_containers: Maximum concurrent containers, or `None` to leave unchanged.
+            buffer_containers: Extra containers to keep warm beyond demand, or `None` to leave unchanged.
+            scaledown_window: Seconds idle containers wait before scaling down, or `None` to leave unchanged.
 
-        ```python notest
-        f = modal.Function.from_name("my-app", "function")
+        Examples:
+            ```python notest
+            f = modal.Function.from_name("my-app", "function")
 
-        # Always have at least 2 containers running, with an extra buffer when the Function is active
-        f.update_autoscaler(min_containers=2, buffer_containers=1)
+            # Always have at least 2 containers running, with an extra buffer when the Function is active
+            f.update_autoscaler(min_containers=2, buffer_containers=1)
 
-        # Limit this Function to avoid spinning up more than 5 containers
-        f.update_autoscaler(max_containers=5)
+            # Limit this Function to avoid spinning up more than 5 containers
+            f.update_autoscaler(max_containers=5)
 
-        # Extend the scaledown window to increase the amount of time that idle containers stay alive
-        f.update_autoscaler(scaledown_window=300)
+            # Extend the scaledown window to increase the amount of time that idle containers stay alive
+            f.update_autoscaler(scaledown_window=300)
 
-        ```
+            ```
 
         """
         if self._is_method:
@@ -1255,9 +1260,19 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         object with metadata from Modal servers until the first
         time it is actually used.
 
-        ```python
-        f = modal.Function.from_name("other-app", "function")
-        ```
+        Args:
+            app_name: Name of the deployed App.
+            name: Name of the Function within that App. For class methods, use `Cls.from_name` instead.
+            environment_name: Environment to look up the App in; defaults to the active environment.
+            client: Modal client to use; defaults to `Client.from_env()` when omitted.
+
+        Returns:
+            A lazy `Function` handle.
+
+        Examples:
+            ```python
+            f = modal.Function.from_name("other-app", "function")
+            ```
         """
         if "." in name:
             raise InvalidError(
@@ -1388,13 +1403,18 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     async def get_web_url(self) -> str | None:
         """URL for addressing a Web Function via HTTP.
 
-        Returns None when this is not a Web Function.
+        Returns:
+            The HTTPS URL for the web endpoint, or `None` if this Function is not a web endpoint.
         """
         return self._web_url
 
     @live_method
     async def _experimental_get_flash_urls(self) -> list[str] | None:
-        """URL of the flash service for the function."""
+        """URL of the flash service for the function.
+
+        Returns:
+            Flash service URLs when configured, or `None`.
+        """
         return list(self._experimental_flash_urls) if self._experimental_flash_urls else None
 
     def _apply_dynamic_config(
@@ -1681,8 +1701,14 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     @synchronizer.no_io_translation
     @live_method
     async def remote(self, *args: P.args, **kwargs: P.kwargs) -> ReturnType:
-        """
-        Calls the function remotely, executing it with the given arguments and returning the execution's result.
+        """Calls the function remotely, executing it with the given arguments and returning the execution's result.
+
+        Args:
+            *args: Positional arguments forwarded to the deployed function.
+            **kwargs: Keyword arguments forwarded to the deployed function.
+
+        Returns:
+            The value returned by the remote function.
         """
         # TODO: Generics/TypeVars
         self._check_no_web_url("remote")
@@ -1696,8 +1722,14 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     @synchronizer.no_io_translation
     @live_method_gen
     async def remote_gen(self, *args, **kwargs) -> AsyncGenerator[Any, None]:
-        """
-        Calls the generator remotely, executing it with the given arguments and returning the execution's result.
+        """Calls the generator remotely, executing it with the given arguments.
+
+        Args:
+            *args: Positional arguments forwarded to the deployed generator function.
+            **kwargs: Keyword arguments forwarded to the deployed generator function.
+
+        Yields:
+            Values produced by the remote generator.
         """
         # TODO: Generics/TypeVars
         self._check_no_web_url("remote_gen")
@@ -1727,12 +1759,18 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
 
     @synchronizer.nowrap
     def local(self, *args: P.args, **kwargs: P.kwargs) -> OriginalReturnType:
-        """
-        Calls the function locally, executing it with the given arguments and returning the execution's result.
+        """Calls the function locally, executing it with the given arguments and returning the execution's result.
 
         The function will execute in the same environment as the caller, just like calling the underlying function
         directly in Python. In particular, only secrets available in the caller environment will be available
         through environment variables.
+
+        Args:
+            *args: Positional arguments passed to the underlying Python callable.
+            **kwargs: Keyword arguments passed to the underlying Python callable.
+
+        Returns:
+            The return value of the local call (or a coroutine for async functions).
         """
         # TODO(erikbern): it would be nice to remove the nowrap thing, but right now that would cause
         # "user code" to run on the synchronicity thread, which seems bad
@@ -1785,9 +1823,14 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
 
         This experimental version of the spawn method allows up to 1 million inputs to be spawned.
 
-        Returns a `modal.FunctionCall` object, that can later be polled or
-        waited for using `.get(timeout=...)`.
         Conceptually similar to `multiprocessing.pool.apply_async`, or a Future/Promise in other contexts.
+
+        Args:
+            *args: Positional arguments forwarded to the remote function.
+            **kwargs: Keyword arguments forwarded to the remote function.
+
+        Returns:
+            A `modal.FunctionCall` handle; poll or await results with `.get(timeout=...)`.
         """
         self._check_no_web_url("_experimental_spawn")
         if self._is_generator:
@@ -1817,10 +1860,16 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     async def spawn(self, *args: P.args, **kwargs: P.kwargs) -> "_FunctionCall[ReturnType]":
         """Calls the function with the given arguments, without waiting for the results.
 
-        Returns a [`modal.FunctionCall`](https://modal.com/docs/reference/modal.FunctionCall) object
-        that can later be polled or waited for using
-        [`.get(timeout=...)`](https://modal.com/docs/reference/modal.FunctionCall#get).
         Conceptually similar to `multiprocessing.pool.apply_async`, or a Future/Promise in other contexts.
+
+        Args:
+            *args: Positional arguments forwarded to the remote function.
+            **kwargs: Keyword arguments forwarded to the remote function.
+
+        Returns:
+            A [`modal.FunctionCall`](https://modal.com/docs/reference/modal.FunctionCall) object
+            that can later be polled or waited for using
+            [`.get(timeout=...)`](https://modal.com/docs/reference/modal.FunctionCall#get).
         """
         self._check_no_web_url("spawn")
         if self._is_generator:
@@ -1834,13 +1883,21 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         return fc
 
     def get_raw_f(self) -> Callable[..., Any]:
-        """Return the inner Python object wrapped by this Modal Function."""
+        """Return the inner Python object wrapped by this Modal Function.
+
+        Returns:
+            The original function object registered with Modal.
+        """
         assert self._raw_f is not None
         return self._raw_f
 
     @live_method
     async def get_current_stats(self) -> FunctionStats:
-        """Return a `FunctionStats` object describing the current function's queue and runner counts."""
+        """Return a `FunctionStats` object describing the current function's queue and runner counts.
+
+        Returns:
+            Snapshot counts for backlog, runners, and running inputs.
+        """
         resp = await self.client.stub.FunctionGetCurrentStats(
             api_pb2.FunctionGetCurrentStatsRequest(function_id=self.object_id),
             retry=Retry(total_timeout=10.0),
@@ -1888,7 +1945,11 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
     @live_method
     async def num_inputs(self) -> int:
-        """Get the number of inputs in the function call."""
+        """Get the number of inputs in the function call.
+
+        Returns:
+            How many inputs this function call includes (e.g. `1` for `.spawn()`, more for `.spawn_map()`).
+        """
         if self._num_inputs is None:
             request = api_pb2.FunctionCallFromIdRequest(function_call_id=self.object_id)
             resp = await self.client.stub.FunctionCallFromId(request)
@@ -1898,6 +1959,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
     @live_method
     async def get(self, timeout: float | None = None, *, index: int = 0) -> ReturnType:
         """Get the result of the index-th input of the function call.
+
         `.spawn()` calls have a single output, so only specifying `index=0` is valid.
         A non-zero index is useful when your function has multiple outputs, like via `.spawn_map()`.
 
@@ -1906,6 +1968,13 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         which can be set to `0` to poll for an output immediately.
 
         The returned coroutine is not cancellation-safe.
+
+        Args:
+            timeout: Maximum seconds to wait for a result, or `None` to wait indefinitely.
+            index: Which input's result to retrieve (typically `0` for `.spawn()`).
+
+        Returns:
+            The deserialized return value from that input.
         """
         return await self._invocation().poll_function(timeout=timeout, index=index)
 
@@ -1915,21 +1984,28 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
         Optionally, specify a range [start, end) to iterate over.
 
-        Example:
-        ```python
-        @app.function()
-        def my_func(a):
-            return a ** 2
+        If `end` is not provided, it will iterate over all results.
 
+        Args:
+            start: First input index to include (inclusive).
+            end: One past the last index to include, or `None` for all remaining inputs.
 
-        @app.local_entrypoint()
-        def main():
-            fc = my_func.spawn_map([1, 2, 3, 4])
-            assert list(fc.iter()) == [1, 4, 9, 16]
-            assert list(fc.iter(start=1, end=3)) == [4, 9]
-        ```
+        Yields:
+            Each result value in index order.
 
-        If `end` is not provided, it will iterate over all results.
+        Examples:
+            ```python
+            @app.function()
+            def my_func(a):
+                return a ** 2
+
+
+            @app.local_entrypoint()
+            def main():
+                fc = my_func.spawn_map([1, 2, 3, 4])
+                assert list(fc.iter()) == [1, 4, 9, 16]
+                assert list(fc.iter(start=1, end=3)) == [4, 9]
+            ```
         """
         num_inputs = await self.num_inputs()
         if end is None:
@@ -1946,6 +2022,9 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
         See [`modal.call_graph`](https://modal.com/docs/reference/modal.call_graph) reference page
         for documentation on the structure of the returned `InputInfo` items.
+
+        Returns:
+            A list of `InputInfo` nodes describing the call graph.
         """
         assert self._client and self._client.stub
         request = api_pb2.FunctionGetCallGraphRequest(function_call_id=self.object_id)
@@ -1963,6 +2042,9 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
         If `terminate_containers=True` - the containers running the cancelled inputs are all terminated
         causing any non-cancelled inputs on those containers to be rescheduled in new containers.
+
+        Args:
+            terminate_containers: If True, forcibly terminate workers running cancelled inputs.
         """
         request = api_pb2.FunctionCallCancelRequest(
             function_call_id=self.object_id, terminate_containers=terminate_containers
@@ -1977,20 +2059,26 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
     ) -> "modal.functions.FunctionCall[Any]":
         """Instantiate a FunctionCall object from an existing ID.
 
-        Examples:
+        Note that it's only necessary to re-instantiate the `FunctionCall` with this method
+        if you no longer have access to the original object returned from `Function.spawn`.
 
-        ```python notest
-        # Spawn a FunctionCall and keep track of its object ID
-        fc = my_func.spawn()
-        fc_id = fc.object_id
+        Args:
+            function_call_id: Object ID of an existing function call (e.g. from `FunctionCall.object_id`).
+            client: Modal client to use; defaults to `Client.from_env()` when omitted.
 
-        # Later, use the ID to re-instantiate the FunctionCall object
-        fc = FunctionCall.from_id(fc_id)
-        result = fc.get()
-        ```
+        Returns:
+            A `FunctionCall` handle for the given ID.
 
-        Note that it's only necessary to re-instantiate the `FunctionCall` with this method
-        if you no longer have access to the original object returned from `Function.spawn`.
+        Examples:
+            ```python notest
+            # Spawn a FunctionCall and keep track of its object ID
+            fc = my_func.spawn()
+            fc_id = fc.object_id
+
+            # Later, use the ID to re-instantiate the FunctionCall object
+            fc = FunctionCall.from_id(fc_id)
+            result = fc.get()
+            ```
 
         """
         _client = typing.cast(_Client, synchronizer._translate_in(client))
@@ -2013,17 +2101,21 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
         Accepts a variable number of `FunctionCall` objects, as returned by `Function.spawn()`.
 
-        Returns a list of results from each FunctionCall, or raises an exception
-        from the first failing function call.
+        Raises an exception from the first failing function call.
 
-        Examples:
+        Args:
+            *function_calls: `FunctionCall` instances to wait on (same order as the returned sequence).
 
-        ```python notest
-        fc1 = slow_func_1.spawn()
-        fc2 = slow_func_2.spawn()
+        Returns:
+            Results in the same order as `function_calls` (like `asyncio.gather`).
 
-        result_1, result_2 = modal.FunctionCall.gather(fc1, fc2)
-        ```
+        Examples:
+            ```python notest
+            fc1 = slow_func_1.spawn()
+            fc2 = slow_func_2.spawn()
+
+            result_1, result_2 = modal.FunctionCall.gather(fc1, fc2)
+            ```
 
         *Added in v0.73.69*: This method replaces the deprecated `modal.functions.gather` function.
         """

{modal-1.4.4.dev13 → modal-1.4.4.dev14}/modal/_partial_function.py

@@ -288,16 +288,15 @@ def _method(
 ) -> _MethodDecoratorType:
     """Decorator for methods that should be transformed into a Modal Function registered against this class's App.
 
-    **Usage:**
-
-    ```python
-    @app.cls(cpu=8)
-    class MyCls:
-
-        @modal.method()
-        def f(self):
-            ...
-    ```
+    Examples:
+        ```python
+        @app.cls(cpu=8)
+        class MyCls:
+
+            @modal.method()
+            def f(self):
+                ...
+        ```
     """
     if _warn_parentheses_missing is not None:
         raise InvalidError(
@@ -423,16 +422,15 @@ def _asgi_app(
     Asynchronous Server Gateway Interface (ASGI) is a standard for Python
     web apps, supported by all popular Python web libraries.
 
-    **Usage:**
-
-    ```python
-    from typing import Callable
+    Examples:
+        ```python
+        from typing import Callable
 
-    @app.function()
-    @modal.asgi_app()
-    def create_asgi() -> Callable:
-        ...
-    ```
+        @app.function()
+        @modal.asgi_app()
+        def create_asgi() -> Callable:
+            ...
+        ```
 
     To learn how to use Modal with popular web frameworks, see the
     [guide on Web Functions](https://modal.com/docs/guide/webhooks).
@@ -481,16 +479,15 @@ def _wsgi_app(
     which is compatible with ASGI and supports additional functionality such as web sockets.
     Modal supports ASGI via [`asgi_app`](https://modal.com/docs/reference/modal.asgi_app).
 
-    **Usage:**
-
-    ```python
-    from typing import Callable
+    Examples:
+        ```python
+        from typing import Callable
 
-    @app.function()
-    @modal.wsgi_app()
-    def create_wsgi() -> Callable:
-        ...
-    ```
+        @app.function()
+        @modal.wsgi_app()
+        def create_wsgi() -> Callable:
+            ...
+        ```
 
     To learn how to use this decorator with popular web frameworks, see the
     [guide on Web Functions](https://modal.com/docs/guide/webhooks).
@@ -539,16 +536,15 @@ def _web_server(
     HTTP server listening on a container port. This is useful for servers written in other languages
     like Rust, as well as integrating with non-ASGI frameworks like aiohttp and Tornado.
 
-    **Usage:**
+    Examples:
+        ```python
+        import subprocess
 
-    ```python
-    import subprocess
-
-    @app.function()
-    @modal.web_server(8000)
-    def my_file_server():
-        subprocess.Popen("python -m http.server -d / 8000", shell=True)
-    ```
+        @app.function()
+        @modal.web_server(8000)
+        def my_file_server():
+            subprocess.Popen("python -m http.server -d / 8000", shell=True)
+        ```
 
     The above example starts a simple file server, displaying the contents of the root directory.
     Here, requests to the URL will go to external port 8000 on the container. The
@@ -651,25 +647,24 @@ def _batched(
 ]:
     """Decorator for functions or class methods that should be batched.
 
-    **Usage**
-
-    ```python
-    # Stack the decorator under `@app.function()` to enable dynamic batching
-    @app.function()
-    @modal.batched(max_batch_size=4, wait_ms=1000)
-    async def batched_multiply(xs: list[int], ys: list[int]) -> list[int]:
-        return [x * y for x, y in zip(xs, ys)]
-
-    # call batched_multiply with individual inputs
-    # batched_multiply.remote.aio(2, 100)
-
-    # With `@app.cls()`, apply the decorator to a method (this may change in the future)
-    @app.cls()
-    class BatchedClass:
+    Examples:
+        ```python
+        # Stack the decorator under `@app.function()` to enable dynamic batching
+        @app.function()
         @modal.batched(max_batch_size=4, wait_ms=1000)
-        def batched_multiply(self, xs: list[int], ys: list[int]) -> list[int]:
+        async def batched_multiply(xs: list[int], ys: list[int]) -> list[int]:
             return [x * y for x, y in zip(xs, ys)]
-    ```
+
+        # call batched_multiply with individual inputs
+        # batched_multiply.remote.aio(2, 100)
+
+        # With `@app.cls()`, apply the decorator to a method (this may change in the future)
+        @app.cls()
+        class BatchedClass:
+            @modal.batched(max_batch_size=4, wait_ms=1000)
+            def batched_multiply(self, xs: list[int], ys: list[int]) -> list[int]:
+                return [x * y for x, y in zip(xs, ys)]
+        ```
 
     See the [dynamic batching guide](https://modal.com/docs/guide/dynamic-batching) for more information.
     """
@@ -728,25 +723,25 @@ def _concurrent(
     arrival rate of inputs increases. This can trade-off a small increase in average
     latency to avoid larger tail latencies from input queuing.
 
-    **Examples:**
-    ```python
-    # Stack the decorator under `@app.function()` to enable input concurrency
-    @app.function()
-    @modal.concurrent(max_inputs=100)
-    async def f(data):
-        # Async function; will be scheduled as asyncio task
-        ...
-
-    # With `@app.cls()`, apply the decorator at the class level, not on individual methods
-    @app.cls()
-    @modal.concurrent(max_inputs=100, target_inputs=80)
-    class C:
-        @modal.method()
-        def f(self, data):
-            # Sync function; must be thread-safe
+    Examples:
+        ```python
+        # Stack the decorator under `@app.function()` to enable input concurrency
+        @app.function()
+        @modal.concurrent(max_inputs=100)
+        async def f(data):
+            # Async function; will be scheduled as asyncio task
             ...
 
-    ```
+        # With `@app.cls()`, apply the decorator at the class level, not on individual methods
+        @app.cls()
+        @modal.concurrent(max_inputs=100, target_inputs=80)
+        class C:
+            @modal.method()
+            def f(self, data):
+                # Sync function; must be thread-safe
+                ...
+
+        ```
 
     *Added in v0.73.148:* This decorator replaces the `allow_concurrent_inputs` parameter
     in `@app.function()` and `@app.cls()`.

{modal-1.4.4.dev13 → modal-1.4.4.dev14}/modal/_runtime/container_io_manager.py

@@ -956,42 +956,25 @@ class _ContainerIOManager:
         outputs = await io_context.output_items(started_at, output_data)
         await self._send_outputs(started_at, outputs)
 
-    async def memory_snapshot(self) -> None:
-        """Message server indicating that function is ready to be checkpointed."""
-        if self.checkpoint_id:
-            logger.debug(f"Checkpoint ID: {self.checkpoint_id} (Memory Snapshot ID)")
-        else:
-            raise ValueError("No checkpoint ID provided for memory snapshot")
-
+    @asynccontextmanager
+    async def snapshot_context_manager(self) -> AsyncGenerator[None, None]:
         # Pause heartbeats since they keep the client connection open which causes the snapshotter to crash
         async with self.heartbeat_condition:
-            # Snapshot GPU memory.
-            if self.function_def._experimental_enable_gpu_snapshot and self.function_def.resources.gpu_config.gpu_type:
-                logger.debug("GPU memory snapshot enabled. Attempting to snapshot GPU memory.")
-
-                self._task_lifecycle_manager.create_cuda_checkpoint()
-
             # Notify the heartbeat loop that the snapshot phase has begun in order to
             # prevent it from sending heartbeat RPCs
             self._waiting_for_memory_snapshot = True
             self.heartbeat_condition.notify_all()
-
-            await self._client.stub.ContainerCheckpoint(
-                api_pb2.ContainerCheckpointRequest(checkpoint_id=self.checkpoint_id)
-            )
-
-            await self._client._close(prep_for_restore=True)
-
-            logger.debug("Memory snapshot request sent. Connection closed.")
-            await self._task_lifecycle_manager.memory_restore()
+            try:
+                yield
+            finally:
+                # Turn heartbeats back on. This is safe since the snapshot RPC
+                # and the restore phase has finished.
+                self._waiting_for_memory_snapshot = False
+                self.heartbeat_condition.notify_all()
             # Reset current input state
             self.current_input_id = None
             self.current_inputs = {}
             self.current_input_started_at = None
-            # Turn heartbeats back on. This is safe since the snapshot RPC
-            # and the restore phase has finished.
-            self._waiting_for_memory_snapshot = False
-            self.heartbeat_condition.notify_all()
 
     async def interact(self, from_breakpoint: bool = False):
         if self._is_interactivity_enabled:
@@ -1009,6 +992,25 @@ class _ContainerIOManager:
             logger.error("Failed to start PTY shell.")
             raise e
 
+    def _install_breakpoint_hook(self) -> None:
+        # sys.breakpointhook is synchronous, so call the blocking wrapper for async interact().
+        container_io_manager: Any = synchronizer._translate_out(self)
+
+        # Install hooks for interactive functions.
+        def breakpoint_wrapper(*args: Any, **kwargs: Any) -> None:
+            # note: it would be nice to not have breakpoint_wrapper() included in the backtrace
+            container_io_manager.interact(from_breakpoint=True)
+            import pdb  # noqa: T100
+
+            current_frame = inspect.currentframe()
+            if current_frame is not None:
+                frame = current_frame.f_back
+                pdb.Pdb().set_trace(frame)
+            else:
+                raise RuntimeError("No current frame found")
+
+        sys.breakpointhook = breakpoint_wrapper
+
     @property
     def target_concurrency(self) -> int:
         return self._target_concurrency