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.