UqueryContext

The context for performing uquery operations in bxl. The functions offered on this ctx are the same behaviour as the query functions available within uquery command.

UqueryContext.allpaths

def UqueryContext.allpaths(
from: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
to: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
filter: None | str = None,
) -> target_set

The allpaths query for computing all dependency paths.

---

UqueryContext.attrfilter

def UqueryContext.attrfilter(
attr: str,
value: str,
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> target_set

The attrfilter query for rule attribute filtering.

---

UqueryContext.attrregexfilter

def UqueryContext.attrregexfilter(
attribute: str,
value: str,
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> target_set

The attrregexfilter query for rule attribute filtering with regex.

Sample usage:

def _impl_attrregexfilter(ctx):
    filtered = ctx.uquery().attrregexfilter("foo", "he.lo", "bin/kind/...")
    ctx.output.print(filtered)

---

UqueryContext.buildfile

def UqueryContext.buildfile(
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> file_set

Find the build file(s) that defines a target or a target set.

Sample usage:

def _buildfile_impl(ctx):
    owner = ctx.uquery().owner(["bin/TARGET", "bin/kind"])
    result = ctx.uquery().buildfile(owner)
    ctx.output.print(result)

---

UqueryContext.deps

def UqueryContext.deps(
universe: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
depth: None | int = None,
filter: None | str = None,
) -> target_set

The deps query for finding the transitive closure of dependencies.

Sample usage:

def _impl_deps(ctx):
    result = ctx.uquery().deps("root//bin:the_binary", 1)
    ctx.output.print(result)

---

UqueryContext.eval

def UqueryContext.eval(
query: str,
query_args: None | target_set | list[str] = None,
)

Evaluates some general query string, query_args can be a target_set of unconfigured nodes, or a list of strings. Returns a dict of target labels mapped to their target_set results if query_args was passed in, otherwise returns a single target_set.

Sample usage:

def _impl_eval(ctx):
    result1 = ctx.uquery().eval("inputs(cell//path/to/file:target)")
    ctx.output.print(result1)

    result2 = ctx.uquery().eval("inputs(%s)", query_args = ["cell//path/to/file:target"])
    ctx.output.print(result2)

---

UqueryContext.filter

def UqueryContext.filter(
regex: str,
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> target_set

The filter query for filtering targets by name.

Sample usage:

def _impl_filter(ctx):
    result = ctx.uquery().filter(".*the_binary", "root//...")
    ctx.output.print(result)

---

UqueryContext.inputs

def UqueryContext.inputs(
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> file_set

The inputs query for finding input files.

Sample usage:

def _impl_inputs(ctx):
    result = ctx.uquery().inputs("root//bin:the_binary")
    ctx.output.print(result)

---

UqueryContext.kind

def UqueryContext.kind(
regex: str,
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> target_set

The kind query for filtering targets by rule type.

Sample usage:

def _impl_kind(ctx):
    kind = ctx.uquery().kind(".*1", "bin/kind/...")
    ctx.output.print(kind)

---

UqueryContext.owner

def UqueryContext.owner(
files: file_set | str | list[str] | tuple[str, ...],
) -> target_set

The owner query for finding targets that own specified files. Note that if you do not pass in a cell path (where the format is <cell>//path/to/file), the path is resolved against the cell that the BXL script lives in. If you need to evaluate a file path that lives in a different cell, you must pass in the fully qualified cell path.

Sample usage:

def _owner_impl(ctx):
    owner = ctx.uquery().owner("bin/TARGETS.fixture")
    ctx.output.print(owner)

---

UqueryContext.rdeps

def UqueryContext.rdeps(
universe: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
from: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
depth: None | int = None,
filter: None | str = None,
) -> target_set

The rdeps query for finding the transitive closure of reverse dependencies.

Sample usage:

def _impl_rdeps(ctx):
    result = ctx.uquery().rdeps("root//bin:the_binary", "//lib:file1", 100)
    ctx.output.print(result)

---

UqueryContext.somepath

def UqueryContext.somepath(
from: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
to: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
filter: None | str = None,
) -> target_set

The somepaths query, which returns the graph of nodes on some arbitrary path from a start to destination target.

---

UqueryContext.targets_in_buildfile

def UqueryContext.targets_in_buildfile(
files: file_set | str | list[str] | tuple[str, ...],
) -> target_set

Given a set of buildfiles, return all targets within those buildfiles.

Usage:

def _targets_in_buildfile_impl(ctx):
    targets = ctx.uquery().targets_in_buildfile("bin/TARGETS.fixture")
    ctx.output.print(targets)

This is subject to be removed in future in favor of a more general targets_in_packages.

---

UqueryContext.testsof

def UqueryContext.testsof(
targets: bxl.UnconfiguredTargetNode | str | target_label | target_set | list[bxl.UnconfiguredTargetNode | str | target_label],
) -> target_set

The testsof query for listing the tests of the specified targets.

Sample usage:

def _testsof_impl(ctx):
    result = ctx.uquery().testsof("//:foo_lib")
    ctx.output.print(result)