KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #developer-tools #ai-agents #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

cobra

★ 44,442 Open GitHub ↗

모던 Go CLI 상호작용을 위한 커맨더 라이브러리

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Cobra는 강력하고 모던한 CLI 애플리케이션을 생성하기 위한 라이브러리입니다.

<a href="https://cobra.dev">상세한 문서는 Cobra.dev를 방문하세요</a>

Cobra는 [Kubernetes](https://kubernetes.io/), [Hugo](https://gohugo.io), [GitHub CLI](https://github.com/cli/cli) 등 수많은 Go 프로젝트에서 사용되고 있습니다. [이 목록](site/content/projects_using_cobra.md)에서 Cobra를 사용하는 더 방대한 프로젝트 목록을 확인할 수 있습니다.

[![](https://img.shields.io/github/actions/workflow/status/spf13/cobra/test.yml?branch=main&longCache=true&label=Test&logo=github%20actions&logoColor=fff)](https://github.com/spf13/cobra/actions?query=workflow%3ATest)
[![Go Reference](https://pkg.go.dev/badge/github.com/spf13/cobra.svg)](https://pkg.go.dev/github.com/spf13/cobra)
[![Go Report Card](https://goreportcard.com/badge/github.com/spf13/cobra)](https://goreportcard.com/report/github.com/spf13/cobra)
[![Slack](https://img.shields.io/badge/Slack-cobra-brightgreen)](https://gophers.slack.com/archives/CD3LP1199)
<hr>
<div align="center" markdown="1">
   <sup>지원:</sup>
   <br>
   <br>
   <a href="https://www.warp.dev/cobra">
      <img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/ab8dd143-b0fd-4904-bdc5-dd7ecac94eae">
   </a>

### [Warp, 개발자를 위한 AI 터미널](https://www.warp.dev/cobra)
[지금 Warp에서 Cobra를 체험해 보세요](https://www.warp.dev/cobra)<br>

</div>
<hr>

# 개요 (Overview)

Cobra는 git 및 go 도구와 유사한 강력하고 모던한 CLI 인터페이스를 생성할 수 있는 단순한 인터페이스를 제공하는 라이브러리입니다.

Cobra가 제공하는 기능:
* 간편한 서브커맨드 기반 CLI: `app server`, `app fetch` 등
* 완전한 POSIX 호환 플래그 (단축 및 장축 버전 포함)
* 중첩된 서브커맨드
* 전역, 로컬 및 캐스케이딩(상속) 플래그
* 지능형 추천 (`app srver`를 입력하셨나요? 혹시 `app server`를 의미하셨나요?)
* 커맨드 및 플래그에 대한 자동 도움말 생성
* 서브커맨드 도움말 그룹화
* `-h`, `--help` 등의 자동 도움말 플래그 인식
* 애플리케이션을 위한 자동 생성 쉘 자동 완성 (bash, zsh, fish, powershell)
* 애플리케이션을 위한 자동 생성 매뉴얼 페이지
* 기존 기능을 깨뜨리지 않고 변경할 수 있는 커맨드 별칭(Alias)
* 자신만의 도움말, 사용법 등을 정의할 수 있는 유연성
* 12-factor 앱을 위한 [viper](https://github.com/spf13/viper)와의 선택적이고 매끄러운 통합

# 개념 (Concepts)

Cobra는 커맨드(Commands), 인자(Arguments), 플래그(Flags) 구조를 기반으로 빌드되었습니다.

**커맨드**는 액션을 나타내고, **인자**는 대상이 되며, **플래그**는 해당 액션의 수정자(Modifiers) 역할을 합니다.

잘 만들어진 애플리케이션은 사용할 때 마치 문장처럼 읽히며, 그 결과 사용자는 직관적으로 상호작용하는 방법을 알 수 있습니다.

따라야 할 패턴은 다음과 같습니다:
`APPNAME VERB NOUN --ADJECTIVE`
    또는
`APPNAME COMMAND ARG --FLAG`.

실제 사례 몇 가지를 보면 이 점을 더 잘 이해할 수 있습니다.

다음 예시에서 'server'는 커맨드이고, 'port'는 플래그입니다:

hugo server --port=1313

이 커맨드에서 우리는 Git에게 url을 베어(bare) 모드로 클론하도록 지시하고 있습니다.

git clone URL --bare

## 커맨드 (Commands)

커맨드는 애플리케이션의 중심점입니다. 애플리케이션이 지원하는 각 상호작용은 커맨드에 포함됩니다. 커맨드는 하위 커맨드를 가질 수 있으며, 선택적으로 액션을 실행할 수 있습니다.

위의 예시에서 'server'가 커맨드입니다.

[cobra.Command에 대해 더 알아보기](https://pkg.go.dev/github.com/spf13/cobra#Command)

## 플래그 (Flags)

플래그는 커맨드의 동작을 수정하는 방법입니다. Cobra는 완전한 POSIX 호환 플래그와 Go [flag 패키지](https://golang.org/pkg/flag/)를 모두 지원합니다. Cobra 커맨드는 하위 커맨드에도 유지되는 플래그와 해당 커맨드에서만 사용할 수 있는 플래그를 정의할 수 있습니다.

위의 예시에서 'port'가 플래그입니다.

플래그 기능은 POSIX 호환성을 추가하면서도 동일한 인터페이스를 유지하는 표준 flag 라이브러리의 포크인 [pflag 라이브러리](https://github.com/spf13/pflag)를 통해 제공됩니다.

# 설치 (Installing)
Cobra를 사용하는 것은 간단합니다. 먼저 `go get`을 사용하여 최신 버전의 라이브러리를 설치합니다.

```
go get -u github.com/spf13/cobra@latest
```

다음으로, 애플리케이션에 Cobra를 포함합니다:

```go
import "github.com/spf13/cobra"
```

# 사용법 (Usage)
`cobra-cli`는 cobra 애플리케이션과 커맨드 파일을 생성하기 위한 명령행 프로그램입니다.
Cobra 기반 애플리케이션을 빠르게 개발할 수 있도록 애플리케이션 뼈대(Scaffolding)를 부트스트랩해 줍니다. 애플리케이션에 Cobra를 통합하는 가장 쉬운 방법입니다.

다음 명령을 실행하여 설치할 수 있습니다:

```
go install github.com/spf13/cobra-cli@latest
```

Cobra-CLI 제너레이터 사용에 대한 자세한 내용은 [The Cobra Generator README](https://github.com/spf13/cobra-cli/blob/main/README.md)를 읽어보세요.

Cobra 라이브러리 사용에 대한 자세한 내용은 [The Cobra User Guide](site/content/user_guide.md)를 읽어보세요.

# 라이선스 (License)

Cobra는 Apache 2.0 라이선스 하에 배포됩니다. [LICENSE.txt](LICENSE.txt)를 참조하세요.

cobra

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README