added groups for subcommands

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/App.java

@@ -152,15 +152,7 @@ public class App
 
     if ((args.length == 0) || (subcommand == null) || help)
     {
-      parser.printUsage(output, i18n.getBundle());
+      printHelp(parser, i18n);
-      output.println();
-      output.println(i18n.getMessage(I18n.SUBCOMMANDS_TITLE));
-
-      for (CommandDescriptor desc :
-              SubCommandHandler.getInstance().getDescriptors())
-      {
-        output.append("  ").println(desc.getName());
-      }
     }
     else
     {
@@ -199,6 +191,37 @@ public class App
     }
   }
 
+  /**
+   * Method description
+   *
+   *
+   * @param parser
+   * @param i18n
+   */
+  private void printHelp(CmdLineParser parser, I18n i18n)
+  {
+    parser.printUsage(output, i18n.getBundle());
+    output.println();
+    output.println(i18n.getMessage(I18n.SUBCOMMANDS_TITLE));
+    output.println();
+
+    String group = null;
+
+    for (CommandDescriptor desc :
+            SubCommandHandler.getInstance().getDescriptors())
+    {
+      if ((group == null) ||!group.equals(desc.getGroup()))
+      {
+        output.println();
+        group = desc.getGroup();
+        output.append(i18n.getMessage(group)).println(":");
+        output.println();
+      }
+
+      output.append("  ").println(desc.getName());
+    }
+  }
+
   //~--- fields ---------------------------------------------------------------
 
   /** Field description */

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/AddMembersSubCommand.java

@@ -45,7 +45,7 @@ import java.util.List;
  *
  * @author Sebastian Sdorra
  */
-@Command("add-members")
+@Command(name = "add-members", group = "group")
 public class AddMembersSubCommand extends MembersSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/AddPermissionSubCommand.java

@@ -48,7 +48,7 @@ import java.util.List;
  *
  * @author Sebastian Sdorra
  */
-@Command("add-permission")
+@Command(name="add-permission", group="repository")
 public class AddPermissionSubCommand extends PermissionSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/Command.java

@@ -47,6 +47,7 @@ import java.lang.annotation.RetentionPolicy;
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Command
 {
-  String value() default "";
+  String name() default "";
   String usage() default "";
+  String group() default "misc";
 }

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/CommandDescriptor.java

@@ -69,7 +69,8 @@ public class CommandDescriptor implements Comparable<CommandDescriptor>
 
     if (cmd != null)
     {
-      this.name = cmd.value();
+      this.name = cmd.name();
+      this.group = cmd.group();
       this.usage = cmd.usage();
     }
 
@@ -108,7 +109,14 @@ public class CommandDescriptor implements Comparable<CommandDescriptor>
   @Override
   public int compareTo(CommandDescriptor desc)
   {
-    return name.compareTo(desc.name);
+    int result = group.compareTo(desc.group);
+
+    if (result == 0)
+    {
+      result = name.compareTo(desc.name);
+    }
+
+    return result;
   }
 
   /**
@@ -147,6 +155,17 @@ public class CommandDescriptor implements Comparable<CommandDescriptor>
     return commandClass;
   }
 
+  /**
+   * Method description
+   *
+   *
+   * @return
+   */
+  public String getGroup()
+  {
+    return group;
+  }
+
   /**
    * Method description
    *
@@ -174,6 +193,9 @@ public class CommandDescriptor implements Comparable<CommandDescriptor>
   /** Field description */
   private Class<? extends SubCommand> commandClass;
 
+  /** Field description */
+  private String group = "misc";
+
   /** Field description */
   private String name;
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/CreateGroupSubCommand.java

@@ -50,7 +50,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("create-group")
+@Command(name="create-group", group="group")
 public class CreateGroupSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/CreateRepositorySubCommand.java

@@ -49,7 +49,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("create-repository")
+@Command(name="create-repository",group="repository")
 public class CreateRepositorySubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/CreateUserSubCommand.java

@@ -49,7 +49,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("create-user")
+@Command(name="create-user", group="user")
 public class CreateUserSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeleteConfigSubCommand.java

@@ -41,7 +41,7 @@ import sonia.scm.cli.config.ScmClientConfig;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-config")
+@Command(name="delete-config", group="config")
 public class DeleteConfigSubCommand extends SubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeleteGroupSubCommand.java

@@ -43,7 +43,7 @@ import sonia.scm.client.ScmClientSession;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-group")
+@Command(name="delete-group",group="group")
 public class DeleteGroupSubCommand extends SubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeleteMembersSubCommand.java

@@ -45,7 +45,7 @@ import java.util.List;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-members")
+@Command(name="delete-members",group="group")
 public class DeleteMembersSubCommand extends MembersSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeletePermissionSubCommand.java

@@ -48,7 +48,7 @@ import java.util.List;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-permission")
+@Command(name="delete-permission",group="repository")
 public class DeletePermissionSubCommand extends PermissionSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeleteRepositorySubCommand.java

@@ -43,7 +43,7 @@ import sonia.scm.client.ScmClientSession;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-repository")
+@Command(name="delete-repository",group="repository")
 public class DeleteRepositorySubCommand extends SubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/DeleteUserSubCommand.java

@@ -43,7 +43,7 @@ import sonia.scm.client.ScmClientSession;
  *
  * @author Sebastian Sdorra
  */
-@Command("delete-user")
+@Command(name="delete-user",group="user")
 public class DeleteUserSubCommand extends SubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/GetGroupSubCommand.java

@@ -50,7 +50,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("get-group")
+@Command(name="get-group",group="group")
 public class GetGroupSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/GetRepositorySubCommand.java

@@ -50,7 +50,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("get-repository")
+@Command(name="get-repository",group="repository")
 public class GetRepositorySubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/GetUserSubCommand.java

@@ -50,7 +50,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("get-user")
+@Command(name="get-user",group="user")
 public class GetUserSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ListGroupsSubCommand.java

@@ -48,7 +48,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("list-groups")
+@Command(name="list-groups",group="group")
 public class ListGroupsSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ListRepositoriesSubCommand.java

@@ -48,7 +48,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("list-repositories")
+@Command(name="list-repositories",group="repository")
 public class ListRepositoriesSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ListUsersSubCommand.java

@@ -48,7 +48,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("list-users")
+@Command(name="list-users",group="user")
 public class ListUsersSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ModifyGroupSubCommand.java

@@ -53,7 +53,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("modify-group")
+@Command(name="modify-group",group="group")
 public class ModifyGroupSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ModifyRepositorySubCommand.java

@@ -53,7 +53,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("modify-repository")
+@Command(name="modify-repository",group="repository")
 public class ModifyRepositorySubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/ModifyUserSubCommand.java

@@ -53,7 +53,7 @@ import java.util.Map;
  *
  * @author Sebastian Sdorra
  */
-@Command("modify-user")
+@Command(name="modify-user",group="user")
 public class ModifyUserSubCommand extends TemplateSubCommand
 {
 

scm-clients/scm-cli-client/src/main/java/sonia/scm/cli/cmd/StoreConfigSubCommand.java

@@ -41,7 +41,7 @@ import sonia.scm.cli.config.ScmClientConfig;
  *
  * @author Sebastian Sdorra
  */
-@Command("store-config")
+@Command(name = "store-config", group = "config")
 public class StoreConfigSubCommand extends SubCommand
 {
 

scm-clients/scm-cli-client/src/main/resources/logback.xml

@@ -18,7 +18,7 @@
     </encoder>
   </appender>
 
-  <logger name="sonia.scm.cli" level="TRACE" />
+  <logger name="sonia.scm.cli" level="ERROR" />
 
   <root level="ERROR">
     <appender-ref ref="STDOUT" />

scm-clients/scm-cli-client/src/main/resources/sonia/resources/i18n.properties

@@ -31,7 +31,7 @@ VAL = value
 FILE = file
 error = Error
 
-subCommandsTitle = SubCommands
+subCommandsTitle = list of commands
 
 optionConfig = Configuration name
 optionServerUrl = SCM-Manager URL
@@ -70,3 +70,9 @@ groupNotFoun = The group could not be found
 metaVar_config = configname
 metaVar_arg = subcommand arguments
 metaVar_command = subcommand
+
+config = Configuration
+misc = Miscellaneous
+repository = Repository
+group = Group
+user = User