DUNE-SHOW(1)

📦
version 3.24.1 · 12 versions
, in ubuntu stonking

💖 NAME 💖

dune-show — the command group that spills the tea about your workspace ☕✨

Like, it's not one command, bestie, it's a whole clique of subcommands whose entire job is showing you stuff: what's in your dirs, what's installed, what builds, what the vibes are. Main character energy for your build system. 👑

🦋 SYNOPSIS 🦋

dune show COMMAND …

🌈 COMMANDS 🌈

ok so here's the full roster, no gatekeeping, every single one of them:

  • aliases [OPTION]… [DIR]… — prints out the aliases in a given directory. works basically like ls does. familiar, cozy, iconic. 🎀
  • contexts [OPTION]… — lists all the build contexts that exist in the workspace. the whole set, laid out. 💅
  • depexts [OPTION]… — prints the list of all the available depexts. all of them. every single one. ✨
  • env [OPTION]… [PATH] — prints the environment of a directory. like, the env-ironment. 🌸
  • external-lib-deps [OPTION]… — prints out the external libraries you'd need to build the project. heads up tho: it's an approximated set of libraries, not a perfect one, so don't treat it like gospel fr fr. 🫶
  • installed-libraries [OPTION]… — prints out the libraries that are installed on the system. already there, already slaying. 💜
  • location [OPTION]… PROG — prints the path to the executable, and it uses the exact same resolution logic as [dune exec]. same brain, same answer. 🧠
  • opam-files [OPTION]… — prints info about all the opam files it has discovered. cute little detectives. 🔍
  • package-entries [OPTION]… — prints information about the entries per package. 📦
  • pkg COMMAND … — subcommands related to package management. it's giving nested lore. 🗂️
  • pp [OPTION]… FILE — builds the given FILE and prints the preprocessed output. yes it actually builds it first. 🛠️
  • rules [OPTION]… [TARGET]… — dumps the rules. all of them, just dumped. 🗑️➡️📜
  • targets [OPTION]… [DIR]… — prints the targets in a given directory. also works similarly to ls. twinsies with aliases. 👯
  • tests [OPTION]… — prints out the tests defined in the project. ⚠️ the output format of this command is experimental and is subject to change without warning — so don't build your whole pipeline on top of it, bestie, it could switch up on you. 😭
  • workspace [OPTION]… [DIRS]… — prints a description of the workspace's structure. and if you pass some directories DIRS, then only those directories of the workspace get considered. narrowing the focus, love that for you. 🎯

✨ COMMON OPTIONS ✨

the ones everybody shares, periodt:

  • --help[=FMT] (default=auto) — shows this help in format FMT. FMT has to be one of auto, pager, groff or plain. with auto, the format is pager or plain whenever the TERM env var is dumb or undefined. it reads the room. 🙈
  • --version — shows version information. the receipts. 🧾

👑 EXIT STATUS 👑

dune show exits with:

  • 0 — on success. ate. 💅
  • 1 — if an error happened. it's giving tragedy. 😭
  • 130 — if it was interrupted by a signal. Ctrl+C behaviour, we've all been there. 💀

🔥 SEE ALSO 🔥

  • dune(1) — the big one, the parent, the blueprint. go read it, iykyk. 🦋
ngl this whole page is from Dune 3.24.1 — so if your dune is a different era, vibe check the version before you trust every detail. 💖

ok bye bestie, go dune show something and slay the build ✨🎀🌸

📦 where this page comes from