Files
cheatsheet-tldr/tldr/gum
2025-09-08 00:20:21 +00:00

35 lines
1.1 KiB
Plaintext

---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# gum
> Make glamorous shell scripts.
> See also: `whiptail`, `dialog`.
> More information: <https://github.com/charmbracelet/gum#tutorial>.
- Interactively pick a specific option to print to `stdout`:
`gum choose {{"option1" "option2" "..."}}`
- Open an interactive prompt for the user to input a string with a specific placeholder:
`gum input --placeholder "{{value}}"`
- Open an interactive confirmation prompt and exit with either `<0>` or `<1>`:
`gum confirm "{{Continue?}}" --default=false --affirmative "{{Yes}}" --negative "{{No}}" {{&& echo "Yes selected" || echo "No selected"}}`
- Show a spinner while a command is taking place with text alongside:
`gum spin {{[-s|--spinner]}} {{dot|line|minidot|jump|pulse|points|globe|moon|monkey|meter|hamburger}} --title "{{loading...}}" {{command}}`
- Format text to include emojis:
`gum format {{[-t|--type]}} {{emoji}} "{{:smile: :heart: hello}}"`
- Interactively prompt for multi-line text and write the input to a file:
`gum write > {{path/to/file}}`