명령줄 하위 명령 (Command Line Subcommands)

소개

이 랩은 Golang 에서 자체 플래그 집합을 가진 하위 명령 (subcommand) 을 정의하고 사용하는 능력을 테스트하는 것을 목표로 합니다.

명령줄 하위 명령 (Command Line Subcommands)

두 개의 하위 명령 foo와 bar를 지원하는 프로그램을 생성해야 합니다. 각 하위 명령은 자체 플래그 집합을 갖습니다. foo 하위 명령은 enable과 name 두 개의 플래그를 가져야 하며, bar 하위 명령은 level 플래그 하나를 가져야 합니다.

• 프로그램은 flag 패키지를 사용하여 플래그를 정의하고 구문 분석해야 합니다.
• foo 하위 명령은 enable과 name 두 개의 플래그를 가져야 하며, 둘 다 문자열 (string) 타입이어야 합니다.
• bar 하위 명령은 level 플래그 하나를 가져야 하며, 정수 (int) 타입이어야 합니다.
• 잘못된 하위 명령이 제공되면 프로그램은 오류 메시지를 출력해야 합니다.
• 프로그램은 호출된 하위 명령의 플래그 값을 출력해야 합니다.

$ go build command-line-subcommands.go

## First invoke the foo subcommand.
$ ./command-line-subcommands foo -enable -name=joe a1 a2
subcommand 'foo'
enable: true
name: joe
tail: [a1 a2]

## Now try bar.
$ ./command-line-subcommands bar -level 8 a1
subcommand 'bar'
level: 8
tail: [a1]

## But bar won't accept foo's flags.
$ ./command-line-subcommands bar -enable a1
flag provided but not defined: -enable
Usage of bar:
-level int
level

## Next we'll look at environment variables, another common
## way to parameterize programs.

전체 코드는 다음과 같습니다.

// Some command-line tools, like the `go` tool or `git`
// have many *subcommands*, each with its own set of
// flags. For example, `go build` and `go get` are two
// different subcommands of the `go` tool.
// The `flag` package lets us easily define simple
// subcommands that have their own flags.

package main

import (
    "flag"
    "fmt"
    "os"
)

func main() {

    // We declare a subcommand using the `NewFlagSet`
    // function, and proceed to define new flags specific
    // for this subcommand.
    fooCmd := flag.NewFlagSet("foo", flag.ExitOnError)
    fooEnable := fooCmd.Bool("enable", false, "enable")
    fooName := fooCmd.String("name", "", "name")

    // For a different subcommand we can define different
    // supported flags.
    barCmd := flag.NewFlagSet("bar", flag.ExitOnError)
    barLevel := barCmd.Int("level", 0, "level")

    // The subcommand is expected as the first argument
    // to the program.
    if len(os.Args) < 2 {
        fmt.Println("expected 'foo' or 'bar' subcommands")
        os.Exit(1)
    }

    // Check which subcommand is invoked.
    switch os.Args[1] {

    // For every subcommand, we parse its own flags and
    // have access to trailing positional arguments.
    case "foo":
        fooCmd.Parse(os.Args[2:])
        fmt.Println("subcommand 'foo'")
        fmt.Println("  enable:", *fooEnable)
        fmt.Println("  name:", *fooName)
        fmt.Println("  tail:", fooCmd.Args())
    case "bar":
        barCmd.Parse(os.Args[2:])
        fmt.Println("subcommand 'bar'")
        fmt.Println("  level:", *barLevel)
        fmt.Println("  tail:", barCmd.Args())
    default:
        fmt.Println("expected 'foo' or 'bar' subcommands")
        os.Exit(1)
    }
}

요약

이 랩에서는 flag 패키지를 사용하여 Golang 에서 자체 플래그 집합을 가진 하위 명령 (subcommand) 을 정의하고 사용하는 방법을 배웠습니다. 또한 각 하위 명령에 대한 플래그를 구문 분석하고 후행 위치 인수에 액세스하는 방법도 배웠습니다.