> ## Documentation Index
> Fetch the complete documentation index at: https://aspect.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs

`function` **Runs.get**

<pre language="python">
  `def Runs.get(
  label: str,
  /
  ) -> Future[bazel.run.Runnable]`
</pre>

The `Future[Runnable]` for one of the targets, by label, however it was spelled. Blocks on `block()` until that target settles.

`function` **Runs.try\_pop**

<pre language="python">
  `def Runs.try_pop() -> None | (str, Future[bazel.run.Runnable])`
</pre>

The next target to finish building, as `(label, Future[Runnable])` in completion order, or `None` when none is ready yet. The future is already settled: `block()` returns at once, with the `Runnable` or one of `bazel.run.BuildError`, `NotBuilt`, `NotRunnable`.

`function` **Runs.wait**

<pre language="python">
  `def Runs.wait() -> bazel.build.BuildStatus`
</pre>

Block until the build finishes and return its `BuildStatus`.

`property` **Runs.cancellation**

<pre language="python">
  `Runs.cancellation: cancellation.Token`
</pre>

The build's cancellation token: cancelling it interrupts Bazel.

`property` **Runs.done**

<pre language="python">
  `Runs.done: bool`
</pre>

Every target has settled and been popped.

`property` **Runs.sink\_invocation\_id**

<pre language="python">
  `Runs.sink_invocation_id: str`
</pre>

The invocation id every gRPC BES sink filed this build under, or `""` without sinks. As on `bazel.build.Build`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.