Merge pull request #20 from codegangsta/JMS-5

Improved help by allowing help topics for subcommands

help.go

@@ -7,35 +7,81 @@ import (
 	"text/template"
 )
 
-var helpCommand = Command{
+// The text template for the Default help topic.
-	Name:      "help",
+// cli.go uses text/template to render templates. You can
-	ShortName: "h",
+// render custom help text by setting this variable.
-	Usage:     "Shows a list of commands or help for one command",
+var AppHelpTemplate = `NAME:
-	Action: func(c *Context) {
+   {{.Name}} - {{.Usage}}
-		helpTemplate := `NAME:
-  {{.Name}} - {{.Usage}}
 
 USAGE:
-  {{.Name}} [global options] command [command options] [arguments...]
+   {{.Name}} [global options] command [command options] [arguments...]
 
 VERSION:
-  {{.Version}}
+   {{.Version}}
 
 COMMANDS:
-  {{range .Commands}}{{.Name}}{{with .ShortName}}, {{.}}{{end}}{{ "\t" }}{{.Usage}}
+   {{range .Commands}}{{.Name}}{{with .ShortName}}, {{.}}{{end}}{{ "\t" }}{{.Usage}}
-  {{end}}
+   {{end}}
 GLOBAL OPTIONS:
-  {{range .Flags}}{{.}}
+   {{range .Flags}}{{.}}
-  {{end}}
+   {{end}}
+`
+
+// The text template for the command help topic.
+// cli.go uses text/template to render templates. You can
+// render custom help text by setting this variable.
+var CommandHelpTemplate = `NAME:
+   {{.Name}} - {{.Usage}}
+
+USAGE:
+   command {{.Name}} [command options] [arguments...]
+
+DESCRIPTION:
+   {{.Description}}
+
+OPTIONS:
+   {{range .Flags}}{{.}}
+   {{end}}
 `
 
-		w := tabwriter.NewWriter(os.Stdout, 0, 8, 1, '\t', 0)
+var helpCommand = Command{
-		t := template.Must(template.New("help").Parse(helpTemplate))
+	Name:      "help",
-		t.Execute(w, c.App)
+	ShortName: "h",
-		w.Flush()
+	Usage:     "Shows a list of commands or help for one command",
+	Action: func(c *Context) {
+		args := c.Args()
+		if len(args) > 0 {
+			showCommandHelp(c)
+		} else {
+			showAppHelp(c)
+		}
 	},
 }
 
+func showAppHelp(c *Context) {
+	printHelp(AppHelpTemplate, c.App)
+}
+
+func showCommandHelp(c *Context) {
+	name := c.Args()[0]
+	for _, c := range c.App.Commands {
+		if c.HasName(name) {
+			printHelp(CommandHelpTemplate, c)
+			return
+		}
+	}
+
+	fmt.Printf("No help topic for '%v'\n", name)
+	os.Exit(1)
+}
+
+func printHelp(templ string, data interface{}) {
+	w := tabwriter.NewWriter(os.Stdout, 0, 8, 1, '\t', 0)
+	t := template.Must(template.New("help").Parse(templ))
+	t.Execute(w, data)
+	w.Flush()
+}
+
 func showVersion(c *Context) {
 	fmt.Printf("%v version %v\n", c.App.Name, c.App.Version)
 }