Command-Line Subcommands - 命令行子命令

命令行子命令 {.zh}

一些命令行工具,比如go工具或git有很多子命令,每个工具都有自己的set offlags。例如,go buildgo getgo工具的两个不同的子命令.flag包让我们可以轻松定义具有自己标志的simplesubcommands。

  1. package main
  2. import (
  3. "flag"
  4. "fmt"
  5. "os"
  6. )
  7. func main() {

我们使用NewFlagSet函数声明一个子命令,然后继续定义特定于该子命令的新标志。

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

对于不同的子命令,我们可以定义不同的支持标志。

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

子命令被期望作为程序的第一个参数。

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

检查调用哪个子命令。

  1. switch os.Args[1] {

对于每个子命令,我们解析自己的标志并可以访问尾随位置参数。

  1. case "foo":
  2. fooCmd.Parse(os.Args[2:])
  3. fmt.Println("subcommand 'foo'")
  4. fmt.Println(" enable:", *fooEnable)
  5. fmt.Println(" name:", *fooName)
  6. fmt.Println(" tail:", fooCmd.Args())
  7. case "bar":
  8. barCmd.Parse(os.Args[2:])
  9. fmt.Println("subcommand 'bar'")
  10. fmt.Println(" level:", *barLevel)
  11. fmt.Println(" tail:", barCmd.Args())
  12. default:
  13. fmt.Println("expected 'foo' or 'bar' subcommands")
  14. os.Exit(1)
  15. }
  16. }
  1. $ go build command-line-subcommands.go

首先调用foo子命令。

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

现在试试吧。

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

但 “bar” 不会接受foo 这个 flag。

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