BST-SHOW(1)

💖 BST-SHOW(1) — like, the bst show manual, bestie 💖

okay so you wanna see what's actually in your pipeline? that's bst show, and she is so iconic for it. welcome to the manual page, group chat edition, no cap. 🦋

---

✨ NAME ✨

bst-show — show elements in the pipeline. that's it. that's the whole job. 💅

---

✨ SYNOPSIS ✨

bst show [OPTIONS] [ELEMENTS]...

---

🌸 DESCRIPTION 🌸

Show elements in the pipeline. periodt.

okay so here's the tea ☕ — if you don't name any elements at all, you get the default targets of the project. and if the project has, like, no default targets configured?? then you're getting all the project elements. every single one. the whole squad. 👑

and when you run this command from a workspace directory, the default is to show the workspace element. she knows where she is, she's self-aware like that. 🫶

by default this shows all of the dependencies of the target element you specified. all of them. the whole tree. it's giving family reunion.

wanna control which elements actually show up? specify --deps:

• none: no dependencies, just the element itself. solo era. 🙈
• run: runtime dependencies, including the element itself
• build: build time dependencies, excluding the element itself
• all: all dependencies. everyone. 🔥

💫 FORMAT 💫

the --format option controls what actually gets printed for each element, and bestie, the following symbols can be used in the format string:

• %{name} — the element name
• %{description} — the element description, on a single line (Since: 2.3)
• %{key} — the abbreviated cache key (if all sources are consistent)
• %{full-key} — the full cache key (if all sources are consistent)
• %{state} — cached, buildable, waiting, inconsistent or junction
• %{config} — the element configuration
• %{vars} — variable configuration
• %{env} — environment settings
• %{public} — public domain data
• %{workspaced} — if the element is workspaced
• %{workspace-dirs} — a list of workspace directories
• %{deps} — a list of all dependencies
• %{build-deps} — a list of build dependencies
• %{runtime-deps} — a list of runtime dependencies
• %{source-info} — source provenance information
• %{artifact-cas-digest} — the CAS digest of the built artifact

ngl this next part is lowkey the coolest bit: the value of the %{symbol} without the leading % character is understood as a pythonic formatting string, so python formatting features apply. yes fr fr. example time:

bst show target.bst --format 'Name: %{name: ^20} Key: %{key: ^8} State: %{state}'

and if you wanna use a newline in a format string in bash, use the '$' modifier:

bst show target.bst --format $'---------- %{name} ----------2{vars}'

slay. 💅

---

🎀 OPTIONS 🎀

• --except PATH — except certain dependencies. like, not these ones, bye 👋
• -d, --deps [none|run|build|all] — the dependencies to show. [default: all]
• --order [stage|alpha] — staging or alphabetic ordering of dependencies. [default: stage]
• -f, --format FORMAT — format string for each element ✨

---

🫶 quick vibe check: this whole page is bst show's manual, from the bst show Manual fam. go show some elements, main character. you got this. 💖

---

and that's the whole page, bestie!! this was version 2.5, dated 2025-05-09 — write it down, remember it, tattoo it idk. mwah. 💋🌸