tree 59f9c4b33a0dec694ffd8f84010c4ab862f933f7
parent ec8c12da43e80eaad81bc4b3ba4e173a1e34c9c0
author Xùdōng Yáng <wyverald@gmail.com> 1695163473 -0400
committer GitHub <noreply@github.com> 1695163473 +0200
gpgsig -----BEGIN PGP SIGNATURE-----
 
 wsBcBAABCAAQBQJlCiRRCRBK7hj4Ov3rIwAAThcIAJDxYEQDmppNPrsH4u2xXPJz
 l4XSgPmgBkb7CPKmVNCsMGMDspDjvmCMZpes4xMqDB/BMiQRh8OAg7fopnyoWMyx
 dSSy4GB53r7RpeuteMfWPM9oY9GucJXTKUSya4Yy/BvpOBlaRgBYObfzS3bgJ/Ry
 GoFSGkCQj9fLyI9uWGipzeNbU61+st0QtR9nSE56GjmdV9v4y68ehw23M5nIuJIY
 6aVFbUjKdQ+Qx4R57n85wGmXi8LnUkb06DfraxMpx408Nct/nKthxgF+l6R7Mx6u
 1VHoTCugzKh0hWZZIC5bsJzslXJZU5hWZ3wxbiaK2V5Bc+VCcgP8MSXQeEg/AN4=
 =YES8
 -----END PGP SIGNATURE-----
 

[6.4.0] Add `--consistent_labels` flag to all query commands (#19567)

If enabled, labels are emitted as if by the Starlark `str` function
applied to a `Label` instance. This is useful for tools that need to
match the output of different query commands and/or labels emitted by
rules. If not enabled, output formatters are free to emit apparent
repository names (relative to the main repository) instead to make the
output more readable.

This is implemented by replacing all `Label#toString()` calls in query
code with an indirection through a `LabelPrinter` object constructed in
a central place. There are currently three types of instances:
* `canonical` behaves just like `str(Label(...))`;
* `apparent` matches the current behavior, which renders main repo
labels in repo-relative form and attempts to use the apparent names for
external repos if possible;
* `legacy` is used in all non-query callsites and uses
`Label#toString()`.

Fixes #17864

RELNOTES: The new `--consistent_labels` option on `query`, `cquery`, and
`aquery` can be used to force consistent label formatting across all
output modes that is also compatible with `str(Label(...))` in Starlark.

Closes #19508.

PiperOrigin-RevId: 566723654
Change-Id: Ifa08a82e281f423faa971c46bf7277cb307698b5

---------

Co-authored-by: Fabian Meumertzheim <fabian@meumertzhe.im>