Add command groups

cmd/action.go

@@ -6,6 +6,7 @@ import (
 
 var actionCmd = &cobra.Command{
 	Use:     "action",
+	GroupID: sourceGroup.ID,
 	Short:   "Manage and run source actions",
 	Long: `Add, edit, delete, and run source actions on items.
 

cmd/channel.go

@@ -11,6 +11,7 @@ import (
 
 var channelCmd = &cobra.Command{
 	Use:     "channel --channel name {--add source | --remove source | --delete [-y]}",
+	GroupID: sourceGroup.ID,
 	Short:   "Manage channels",
 	Long: `A channel is a group of sources that can be viewed together. Adding a source
 to a channel creates it and removing all sources from a channel deletes it.

cmd/deactivate.go

@@ -12,6 +12,7 @@ import (
 
 var deactivateCmd = &cobra.Command{
 	Use:     "deactivate --source source [--item item]",
+	GroupID: feedGroup.ID,
 	Aliases: []string{"deac"},
 	Short:   "Deactivate items",
 	Long: `Deactivate items, hiding them from feeds and marking them for deletion.

cmd/edit.go

@@ -8,6 +8,7 @@ import (
 
 var editCmd = &cobra.Command{
 	Use:     "edit",
+	GroupID: feedGroup.ID,
 	Short:   "Edit an item",
 	Long: `
 `,

cmd/env.go

@@ -9,6 +9,7 @@ import (
 
 var envCmd = &cobra.Command{
 	Use:     "env",
+	GroupID: sourceGroup.ID,
 	Short:   "Manage source environment variables",
 	Long: `Add, edit, list, or delete environment variables.
 

cmd/feed.go

@@ -10,6 +10,7 @@ import (
 
 var feedCmd = &cobra.Command{
 	Use:     "feed",
+	GroupID: feedGroup.ID,
 	Short:   "Display the item feed",
 	Long: fmt.Sprintf(`Display the intake item feed in various formats.
 The default format is "headlines".

cmd/fetch.go

@@ -12,6 +12,7 @@ import (
 
 var fetchCmd = &cobra.Command{
 	Use:     "fetch [--source name] [-n|--dry-run] [--env NAME-VALUE [-- env NAME=VALUE ...]] [-- argv...]",
+	GroupID: feedGroup.ID,
 	Short:   "Fetch items for a source and update the feed",
 	Long: fmt.Sprintf(`Fetch items for a source and update the feed.
 

cmd/item.go

@@ -11,6 +11,7 @@ import (
 
 var itemCmd = &cobra.Command{
 	Use:     "item",
+	GroupID: feedGroup.ID,
 	Short:   "Add an item",
 	Long: `Create an ad-hoc item in a source.
 

cmd/list.go

@@ -12,6 +12,7 @@ import (
 
 var listCmd = &cobra.Command{
 	Use:     "list",
+	GroupID: sourceGroup.ID,
 	Aliases: []string{"ls"},
 	Short:   "List sources, channels, or actions",
 	Long: `List sources, channels, or actions.

cmd/monitor.go

@@ -10,6 +10,7 @@ import (
 
 var monitorCmd = &cobra.Command{
 	Use:     "monitor",
+	GroupID: webGroup.ID,
 	Short:   "Run continuously and update sources according to their fetch schedule",
 	Long: `Run continuously and update sources.
 

cmd/passwd.go

@@ -12,6 +12,7 @@ import (
 
 var passwdCmd = &cobra.Command{
 	Use:     "passwd",
+	GroupID: webGroup.ID,
 	Short:   "Set the password for the web interface",
 	Long: `Set the password for the web interface.
 

cmd/root.go

@@ -25,10 +25,18 @@ func Execute() {
 
 var dataPath string
 
+var sourceGroup = &cobra.Group{ID: "manage", Title: "Source management:"}
+var feedGroup = &cobra.Group{ID: "feed", Title: "Feed management:"}
+var webGroup = &cobra.Group{ID: "web", Title: "Service management:"}
+
 func init() {
 	// Disable the automatic help command
 	rootCmd.SetHelpCommand(&cobra.Command{Hidden: true})
 
+	rootCmd.AddGroup(sourceGroup)
+	rootCmd.AddGroup(feedGroup)
+	rootCmd.AddGroup(webGroup)
+
 	// All commands need to operate on a database
 	// Setting the env-derived path as the default allows the command line to override the env
 	dbPathFromEnv := core.ResolveEnvDataDir()

cmd/serve.go

@@ -12,6 +12,7 @@ import (
 
 var serveCmd = &cobra.Command{
 	Use:     "serve",
+	GroupID: webGroup.ID,
 	Short:   "Serve the web interface",
 	Long: `Serve the intake web interface.
 `,

cmd/source.go

@@ -9,6 +9,7 @@ import (
 
 var sourceCmd = &cobra.Command{
 	Use:     "source",
+	GroupID: sourceGroup.ID,
 	Short:   "Manage sources",
 	Long: `Manage sources.