[W5][T12-1]Zhang Chenxi

docs/UserGuide.adoc

@@ -111,6 +111,26 @@ Deletes the 2nd person in the address book.
 `delete 1` +
 Deletes the 1st person in the results of the `find` command.
 
+== Highlighting a person : `group`
+
+Deletes the specified person from the address book. Irreversible. +
+Format: `group INDEX`
+
+****
+Highlights(groups) the person at the specified `INDEX`.
+The index refers to the index number shown in the most recent listing.
+****
+
+Examples:
+
+* `list` +
+`group 2` +
+Highlights the 2nd person in the address book.
+
+* `find Betsy` +
+`group 1` +
+Highlights the 1st person in the results of the `find` command.
+
 == View non-private details of a person : `view`
 
 Displays the non-private details of the specified person. +

src/seedu/addressbook/commands/GroupCommand.java

@@ -0,0 +1,42 @@
+package seedu.addressbook.commands;
+
+import seedu.addressbook.common.Messages;
+import seedu.addressbook.data.person.ReadOnlyPerson;
+import seedu.addressbook.data.person.UniquePersonList.PersonNotFoundException;
+
+
+/**
+ * Groups a person identified using it's last displayed index from the address book.
+ */
+public class GroupCommand extends Command {
+
+    public static final String COMMAND_WORD = "group";
+
+    public static final String MESSAGE_USAGE = COMMAND_WORD
+            + ": Highlight the person identified by the index number used in the last person listing.\n"
+            + "Parameters: INDEX\n"
+            + "Example: " + COMMAND_WORD + " 1";
+
+    public static final String MESSAGE_GROUP_PERSON_SUCCESS = "Grouped Person: %1$s";
+
+
+    public GroupCommand(int targetVisibleIndex) {
+        super(targetVisibleIndex);
+    }
+
+
+    @Override
+    public CommandResult execute() {
+        try {
+            final ReadOnlyPerson target = getTargetPerson();
+            addressBook.removePerson(target);
+            return new CommandResult(String.format(MESSAGE_GROUP_PERSON_SUCCESS, target));
+
+        } catch (IndexOutOfBoundsException ie) {
+            return new CommandResult(Messages.MESSAGE_INVALID_PERSON_DISPLAYED_INDEX);
+        } catch (PersonNotFoundException pnfe) {
+            return new CommandResult(Messages.MESSAGE_PERSON_NOT_IN_ADDRESSBOOK);
+        }
+    }
+
+}

src/seedu/addressbook/data/AddressBook.java

@@ -54,6 +54,15 @@ public void removePerson(ReadOnlyPerson toRemove) throws PersonNotFoundException
         allPersons.remove(toRemove);
     }
 
+    /**
+     * Groups the equivalent person from the address book.
+     *
+     * @throws PersonNotFoundException if no such Person could be found.
+     */
+    public void groupPerson(Person toGroup) throws PersonNotFoundException {
+        allPersons.group(toGroup);
+    }
+
     /**
      * Clears all persons and tags from the address book.
      */

src/seedu/addressbook/data/person/UniquePersonList.java

@@ -37,6 +37,8 @@ public static class PersonNotFoundException extends Exception {}
 
     private final List<Person> internalList = new ArrayList<>();
 
+    private final List<Person> groupedPersonList = new ArrayList<>();
+
     /**
      * Constructs empty person list.
      */
@@ -122,6 +124,18 @@ public void remove(ReadOnlyPerson toRemove) throws PersonNotFoundException {
         }
     }
 
+    /**
+     * Groups the equivalent person from the list.
+     *
+     * @throws PersonNotFoundException if no such person could be found in the list.
+     */
+    public void group(Person toGroup) throws PersonNotFoundException {
+        final boolean personFoundAndGrouped = groupedPersonList.add(toGroup);
+        if (!personFoundAndGrouped) {
+            throw new PersonNotFoundException();
+        }
+    }
+
     /**
      * Clears all persons in list.
      */

src/seedu/addressbook/parser/Parser.java

@@ -15,6 +15,7 @@
 import seedu.addressbook.commands.ClearCommand;
 import seedu.addressbook.commands.Command;
 import seedu.addressbook.commands.DeleteCommand;
+import seedu.addressbook.commands.GroupCommand;
 import seedu.addressbook.commands.ExitCommand;
 import seedu.addressbook.commands.FindCommand;
 import seedu.addressbook.commands.HelpCommand;
@@ -79,6 +80,9 @@ public Command parseCommand(String userInput) {
         case DeleteCommand.COMMAND_WORD:
             return prepareDelete(arguments);
 
+        case GroupCommand.COMMAND_WORD:
+            return prepareGroup(arguments);
+
         case ClearCommand.COMMAND_WORD:
             return new ClearCommand();
 
@@ -174,6 +178,24 @@ private Command prepareDelete(String args) {
         }
     }
 
+
+    /**
+     * Parses arguments in the context of the group person command.
+     *
+     * @param args full command args string
+     * @return the prepared command
+     */
+    private Command prepareGroup(String args) {
+        try {
+            final int targetIndex = parseArgsAsDisplayedIndex(args);
+            return new GroupCommand(targetIndex);
+        } catch (ParseException pe) {
+            return new IncorrectCommand(String.format(MESSAGE_INVALID_COMMAND_FORMAT, GroupCommand.MESSAGE_USAGE));
+        } catch (NumberFormatException nfe) {
+            return new IncorrectCommand(MESSAGE_INVALID_PERSON_DISPLAYED_INDEX);
+        }
+    }
+
     /**
      * Parses arguments in the context of the view command.
      *