lib/cmd/cmd.go

   1 // Copyright (C) The Arvados Authors. All rights reserved.
   2 //
   3 // SPDX-License-Identifier: Apache-2.0
   4
   5 // package cmd helps define reusable functions that can be exposed as
   6 // [subcommands of] command line programs.
   7 package cmd
   8
   9 import (
  10         "flag"
  11         "fmt"
  12         "io"
  13         "io/ioutil"
  14         "sort"
  15         "strings"
  16 )
  17
  18 type Handler interface {
  19         RunCommand(prog string, args []string, stdin io.Reader, stdout, stderr io.Writer) int
  20 }
  21
  22 type HandlerFunc func(prog string, args []string, stdin io.Reader, stdout, stderr io.Writer) int
  23
  24 func (f HandlerFunc) RunCommand(prog string, args []string, stdin io.Reader, stdout, stderr io.Writer) int {
  25         return f(prog, args, stdin, stdout, stderr)
  26 }
  27
  28 // Multi is a Handler that looks up its first argument in a map, and
  29 // invokes the resulting Handler with the remaining args.
  30 //
  31 // Example:
  32 //
  33 //     os.Exit(Multi(map[string]Handler{
  34 //             "foobar": HandlerFunc(func(prog string, args []string) int {
  35 //                     fmt.Println(args[0])
  36 //                     return 2
  37 //             }),
  38 //     })("/usr/bin/multi", []string{"foobar", "baz"}))
  39 //
  40 // ...prints "baz" and exits 2.
  41 type Multi map[string]Handler
  42
  43 func (m Multi) RunCommand(prog string, args []string, stdin io.Reader, stdout, stderr io.Writer) int {
  44         if len(args) < 1 {
  45                 fmt.Fprintf(stderr, "usage: %s command [args]\n", prog)
  46                 m.Usage(stderr)
  47                 return 2
  48         }
  49         if cmd, ok := m[args[0]]; !ok {
  50                 fmt.Fprintf(stderr, "unrecognized command %q\n", args[0])
  51                 m.Usage(stderr)
  52                 return 2
  53         } else {
  54                 return cmd.RunCommand(prog+" "+args[0], args[1:], stdin, stdout, stderr)
  55         }
  56 }
  57
  58 func (m Multi) Usage(stderr io.Writer) {
  59         var subcommands []string
  60         for sc := range m {
  61                 if strings.HasPrefix(sc, "-") {
  62                         // Some subcommands have alternate versions
  63                         // like "--version" for compatibility. Don't
  64                         // clutter the subcommand summary with those.
  65                         continue
  66                 }
  67                 subcommands = append(subcommands, sc)
  68         }
  69         sort.Strings(subcommands)
  70         fmt.Fprintf(stderr, "\nAvailable commands:\n")
  71         for _, sc := range subcommands {
  72                 fmt.Fprintf(stderr, "    %s\n", sc)
  73         }
  74 }
  75
  76 type FlagSet interface {
  77         Init(string, flag.ErrorHandling)
  78         Args() []string
  79         NArg() int
  80         Parse([]string) error
  81         SetOutput(io.Writer)
  82         PrintDefaults()
  83 }
  84
  85 // SubcommandToFront silently parses args using flagset, and returns a
  86 // copy of args with the first non-flag argument moved to the
  87 // front. If parsing fails or consumes all of args, args is returned
  88 // unchanged.
  89 //
  90 // SubcommandToFront invokes methods on flagset that have side
  91 // effects, including Parse. In typical usage, flagset will not used
  92 // for anything else after being passed to SubcommandToFront.
  93 func SubcommandToFront(args []string, flagset FlagSet) []string {
  94         flagset.Init("", flag.ContinueOnError)
  95         flagset.SetOutput(ioutil.Discard)
  96         if err := flagset.Parse(args); err != nil || flagset.NArg() == 0 {
  97                 // No subcommand found.
  98                 return args
  99         }
 100         // Move subcommand to the front.
 101         flagargs := len(args) - flagset.NArg()
 102         newargs := make([]string, len(args))
 103         newargs[0] = args[flagargs]
 104         copy(newargs[1:flagargs+1], args[:flagargs])
 105         copy(newargs[flagargs+1:], args[flagargs+1:])
 106         return newargs
 107 }