Go by Example: 커맨드라인 플래그

커맨드라인 플래그 (Command-line flags)는 커맨드라인 프로그램에 옵션을 지정하는 일반적인 방법입니다. 예를 들어, wc -l에서 -l은 커맨드라인 플래그입니다.

 
package main

Go는 기본적인 커맨드라인 플래그 파싱을 지원하는 flag 패키지를 제공합니다. 이 패키지를 사용하여 예제 커맨드라인 프로그램을 구현해보겠습니다.

 
import "flag"
import "fmt"

func main() {

기본적인 플래그 선언은 문자열, 정수, 그리고 불리언 옵션에서 사용 가능합니다. 다음은 "foo"를 기본값으로 하고 간단한 설명을 가진 word라는 문자열 플래그의 선언입니다. flag.String 함수는 문자열 포인터를 반환합니다 (문자열 값이 아님) 아래에서 이 포인터를 어떻게 사용하는지 살펴보겠습니다.

 
	wordPtr := flag.String("word", "foo", "a string")

다음은 word 플래그 선언과 유사한 방법을 사용해 선언한 numb와 fork 플래그입니다.

 
	numbPtr := flag.Int("numb", 42, "an int")
	boolPtr := flag.Bool("fork", false, "a bool")

프로그램의 기존에 다른 곳에서 선언된 변수를 사용해 옵션을 선언하는 것도 가능합니다. 참고로 플래그 선언 함수에 변수의 포인터를 전달해야합니다.

 
	var svar string
	flag.StringVar(&svar, "svar", "bar", "a string var")

모든 플래그가 선언되면, 커맨드라인 파싱을 실행하기 위해 flag.Parse()을 호출합니다.

 
	flag.Parse()

다음은 파싱된 옵션들과 후미에 위치하는 인자들을 덤프합니다. 참고로 실제 옵션값을 얻기 위해선 *wordPtr와 같이 포인터를 역참조 해야합니다.

 
	fmt.Println("word:", *wordPtr)
	fmt.Println("numb:", *numbPtr)
	fmt.Println("fork:", *boolPtr)
	fmt.Println("svar:", svar)
	fmt.Println("tail:", flag.Args())
}

커맨드라인 플래그 프로그램을 실험하려면 우선 이를 컴파일한 후 직접 결과 바이너리를 실행하는 것이 가장 좋습니다.

 
$ go build command-line-flags.go

처음엔 모든 플래그에 값을 주어 프로그램을 실행해 봅시다.

 
$ ./command-line-flags -word=opt -numb=7 -fork -svar=flag
word: opt
numb: 7
fork: true
svar: flag
tail: []

참고로 생략된 플래그들은 자동으로 기본값을 갖게 됩니다.

 
$ ./command-line-flags -word=opt
word: opt
numb: 42
fork: false
svar: bar
tail: []

후미에 위치한 인자들은 모든 플래그 뒤에 위치할 수 있습니다.

 
$ ./command-line-flags -word=opt a1 a2 a3
word: opt
...
tail: [a1 a2 a3]

참고로 flag 패키지에서 모든 플래그들은 위치 인자 전에 나타나야합니다. (그렇지 않으면 플래그들은 위치 인자로 해석됩니다)

 
$ ./command-line-flags -word=opt a1 a2 a3 -numb=7
word: opt
numb: 42
fork: false
svar: bar
tail: [a1 a2 a3 -numb=7]

-h 또는 --help 플래그를 사용하면 커맨드라인 프로그램에 대해 자동으로 생성된 도움말을 볼 수 있습니다.

 
$ ./command-line-flags -h
Usage of ./command-line-flags:
  -fork=false: a bool
  -numb=42: an int
  -svar="bar": a string var
  -word="foo": a string

flag 패키지로 지정되지 않은 플래그를 사용하면, 프로그램은 에러 메시지를 출력하며 도움말을 다시 보여줍니다.

 
$ ./command-line-flags -wat
flag provided but not defined: -wat
Usage of ./command-line-flags:
...

다음장에선 또 다른 프로그램을 매개변수화하는 일반적인 방법인 환경변수에 대해 살펴보겠습니다.

다음 예제: 환경변수.

원작자 @mmcgrana | 번역 @mingrammer | source | license