Go Em Exemplos: Command-Line Subcommands

Alguns programas de linha de comando, como o próprio go ou git possuem muitos subcomandos, cada um com seu próprio conjunto de flags. Por exemplo, go build e go get são dois subcomandos diferentes de go. O pacote flag permite definir subcomandos com seu próprio conjunto de flags.

package main
import (
    "flag"
    "fmt"
    "os"
)
func main() {

Um subcomando é declarado usando a função NewFlagSet e, em seguida, se prossegue com a definição das flags específicas para este subcomando.

    fooCmd := flag.NewFlagSet("foo", flag.ExitOnError)
    fooEnable := fooCmd.Bool("enable", false, "enable")
    fooName := fooCmd.String("name", "", "name")

Para diferentes subcomandos podem ser definidas diferentes flags suportadas.

    barCmd := flag.NewFlagSet("bar", flag.ExitOnError)
    barLevel := barCmd.Int("level", 0, "level")

O subcomando é esperado como primeiro argumento do programa.

    if len(os.Args) < 2 {
        fmt.Println("expected 'foo' or 'bar' subcommands")
        os.Exit(1)
    }

Verifica qual subcomando é utilizado.

    switch os.Args[1] {

Para cada subcomando, são parseadas suas próprias flags e tem acesso aos eventuais argumentos adicionais ao final.

    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)
    }
}
$ go build command-line-subcommands.go 

Utilização do primeiro subcomando

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

Agora o segundo.

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

O segundo com tentativa de utilizar flags do primeiro.

$ ./command-line-subcommands bar -enable a1
flag provided but not defined: -enable
Usage of bar:
  -level int
        level

Em seguida serão apresentadas as variáveis de ambiente, outra forma muito comum de parametrizar programas.

Próximo exemplo: Environment Variables.