gum

KO | EN

gitlite — search

#php #javascript #python #game #c-sharp #ios #hacktoberfest #c-plus-plus #theme #ruby #golang #slack

★ 24,238 Open GitHub ↗

글래머러스한 셸 스크립트를 위한 도구 🎀

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gum

[![Gum Image](https://stuff.charm.sh/gum/gum.png)](https://stuff.charm.sh/gum/nutritional-information.png)
  
  
[![Latest Release](https://img.shields.io/github/release/charmbracelet/gum.svg)](https://github.com/charmbracelet/gum/releases)
[![Go Docs](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/charmbracelet/gum?tab=doc)
[![Build Status](https://github.com/charmbracelet/gum/workflows/build/badge.svg)](https://github.com/charmbracelet/gum/actions)

매력적인 셸 스크립트를 위한 도구입니다. Go 코드를 전혀 작성하지 않고도 
[Bubbles](https://github.com/charmbracelet/bubbles)와 [Lip
Gloss](https://github.com/charmbracelet/lipgloss)의 강력한 기능을 스크립트와 별칭(alias)에서 활용해 보세요!
![Shell running the ./demo.sh script](https://vhs.charm.sh/vhs-1qY57RrQlXCuydsEgDp68G.gif)
위 예시는 단일 셸 스크립트([source](./examples/demo.sh))로 실행 중인 모습입니다.

## 튜토리얼
Gum은 단 몇 줄의 코드로 유용한 셸 스크립트와 닷파일(dotfile) 별칭을 작성하는 데 도움이 되는, 고도로 설정 가능하고 바로 사용할 수 있는 유틸리티를 제공합니다.
닷파일용 [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/#summary) 작성을 돕는 간단한 스크립트를 만들어 봅시다.

gum choose로 커밋 유형을 물어봅니다:
```bash
gum choose "fix" "feat" "docs" "style" "refactor" "test" "chore" "revert"
```
> [!NOTE]
> 이 명령어 자체는 표준 출력(stdout)으로 출력만 하므로 그 자체로는 아주 유용하지는 않습니다. 나중에 이 명령어를 활용하려면 표준 출력을 `$VARIABLE`이나 `file.txt`에 저장하면 됩니다.

변경 사항의 범주(scope)를 입력받습니다:
```bash
gum input --placeholder "scope"
```

변경 사항의 요약 및 설명을 입력받습니다:
```bash
gum input --value "$TYPE$SCOPE: " --placeholder "Summary of this change"
gum write --placeholder "Details of this change"
```

커밋하기 전에 확인을 받습니다:
```bash
gum confirm "Commit changes?" && git commit -m "$SUMMARY" -m "$DESCRIPTION"
```

이 명령어들을 단일 스크립트로 결합하는 [완전한 예시](https://github.com/charmbracelet/gum/blob/main/examples/commit.sh)를 확인해 보세요.
![Running the ./examples/commit.sh script to commit to git](https://vhs.charm.sh/vhs-7rRq3LsEuJVwhwr0xf6Er7.gif)

## 설치
패키지 매니저를 사용하세요:
```bash
# macOS or Linux
brew install gum
# Arch Linux (btw)
pacman -S gum
# Fedora or EPEL 10
dnf install gum
# Nix
nix-env -iA nixpkgs.gum
# Flox
flox install gum
# Windows (via WinGet or Scoop)
winget install charmbracelet.gum
scoop install charm-gum
```

Debian/Ubuntu
```bash
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ \* \*" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install gum
```

Fedora/RHEL/OpenSuse
```bash
echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
sudo rpm --import https://repo.charm.sh/yum/gpg.key
# yum
sudo yum install gum
# zypper
sudo zypper refresh
sudo zypper install gum
```

FreeBSD
```bash
# packages
sudo pkg install gum
# ports
cd /usr/ports/devel/gum && sudo make install clean
```
또는 다운로드하기:
- [Packages][releases]는 Debian, RPM, Alpine 형식으로 제공됩니다.
- [Binaries][releases]는 Linux, macOS, Windows, FreeBSD, OpenBSD, NetBSD용으로 제공됩니다.
또는 `go`를 사용하여 간단히 설치하세요:
```bash
go install github.com/charmbracelet/gum@latest
```
[releases]: https://github.com/charmbracelet/gum/releases
## Commands
- [`choose`](#choose): 목록에서 옵션 선택하기
- [`confirm`](#confirm): 사용자에게 작업 확인 요청하기
- [`file`](#file): 폴더에서 파일 선택하기
- [`filter`](#filter): 목록에서 항목 필터링하기
- [`format`](#format): 템플릿을 사용하여 문자열 서식 지정하기
- [`input`](#input): 입력 프롬프트 표시하기
- [`join`](#join): 텍스트를 수직 또는 수평으로 결합하기
- [`pager`](#pager): 파일 스크롤하기
- [`spin`](#spin): 명령 실행 중 스피너 표시하기
- [`style`](#style): 텍스트에 색상, 테두리, 간격 적용하기
- [`table`](#table): 데이터 테이블 렌더링하기
- [`write`](#write): 여러 줄의 텍스트 입력 요청하기
- [`log`](#log): 출력에 로그 메시지 남기기
## Customization
`--flags` 및 `$ENVIRONMENT\_VARIABLES`를 사용하여 `gum` 옵션과 스타일을 사용자 지정할 수 있습니다.
각 명령어의 사용자 지정 및 설정 옵션에 대한 전체 내용은 `gum --help`를 참조하세요.
`--flags`로 사용자 지정하기:
```bash
gum input --cursor.foreground "#FF0" \
--prompt.foreground "#0FF" \
--placeholder "What's up?" \
--prompt "\* " \
--width 80 \
--value "Not much, hby?"
```
`ENVIRONMENT\_VARIABLES`로 사용자 지정하기:
```bash
export GUM\_INPUT\_CURSOR\_FOREGROUND="#FF0"
export GUM\_INPUT\_PROMPT\_FOREGROUND="#0FF"
export GUM\_INPUT\_PLACEHOLDER="What's up?"
export GUM\_INPUT\_PROMPT="\* "
export GUM\_INPUT\_WIDTH=80
# --flags는 환경 변수로 설정된 값을 재정의할 수 있습니다.
gum input
```
![Gum input displaying most customization options](https://vhs.charm.sh/vhs-5zb9DlQYA70aL9ZpYLTwKv.gif)
## Input
간단한 명령어로 입력을 요청합니다.
```bash
gum input > answer.txt
gum input --password > password.txt
```
![Shell running gum input typing Not much, you?](https://vhs.charm.sh/vhs-1nScrStFI3BMlCp5yrLtyg.gif)
## Write
여러 줄의 텍스트 입력을 요청합니다(텍스트 입력을 완료하려면 `ctrl+d` 입력).
```bash
gum write > story.txt
```
![Shell running gum write typing a story](https://vhs.charm.sh/vhs-7abdKKrUEukgx9aJj8O5GX.gif)
## Filter
퍼지 매칭을 사용하여 값 목록을 필터링합니다:
```bash
echo Strawberry >> flavors.txt
echo Banana >> flavors.txt
echo Cherry >> flavors.txt
gum filter < flavors.txt > selection.txt
```
![Shell running gum filter on different bubble gum flavors](https://vhs.charm.sh/vhs-61euOQtKPtQVD7nDpHQhzr.gif)
`--limit` 플래그 또는 `--no-limit` 플래그를 사용하여 여러 옵션을 선택할 수 있습니다. 선택하려면 `tab` 또는 `ctrl+space`를 사용하고, 확인하려면 `enter`를 누르세요.
```bash
cat flavors.txt | gum filter --limit 2
cat flavors.txt | gum filter --no-limit
```
## Choose
목록에서 옵션을 선택합니다.
```bash
echo "Pick a card, any card..."
CARD=$(gum choose --height 15 {{A,K,Q,J},{10..2}}" "{♠,♥,♣,♦})
echo "Was your card the $CARD?"
```
또한 선택할 수 있는 최대 항목 수를 결정하는 `--limit` 또는 `--no-limit` 플래그를 사용하여 여러 항목을 선택할 수도 있습니다.
```bash
cat songs.txt | gum choose --limit 5
cat foods.txt | gum choose --no-limit --header "Grocery Shopping"
```
![Shell running gum choose with numbers and gum flavors](https://vhs.charm.sh/vhs-3zV1LvofA6Cbn5vBu1NHHl.gif)
## Confirm
작업 수행 여부를 확인합니다. 선택에 따라 코드 `0`(긍정) 또는 `1`(부정)로 종료됩니다.
```bash
gum confirm && rm file.txt || echo "File not removed"
```
![Shell running gum confirm](https://vhs.charm.sh/vhs-3xRFvbeQ4lqGerbHY7y3q2.gif)
## File
사용자에게 파일 트리에서 파일을 선택하도록 요청합니다.
```bash
$EDITOR $(gum file $HOME)
```
![Shell running gum file](https://vhs.charm.sh/vhs-2RMRqmnOPneneIgVJJ3mI1.gif)
## Pager
줄 번호와 완전히 사용자 지정 가능한 뷰포트로 긴 문서를 스크롤합니다.
```bash
gum pager < README.md
```
![Shell

[running gum pager](https://vhs.charm.sh/vhs-3iMDpgOLmbYr0jrYEGbk7p.gif)

gum

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README