Rolodex - Test Script

This is a document explaining the steps to perform manual testing (i.e. manual scripted testing), starting with how to load the sample data.

Setting Up

1. Follow the instructions with numbers labeled closely.
2. Download the latest rolodex.jar from here.
3. Download our sample database with more than 25 persons pre-loaded for this exercise here.
4. Start up rolodex.jar in an empty directory and close it.
5. You should see a preferences.json file in the same directory as your jar file.
6. Replace the value of the key rolodexFilePath in the json file to a directory of your choosing.
7. Place SampleData.rldx in that directory. We recommend creating a directory data in the same folder as your rolodex.jar file and placing SampleData.rldx in there. (i.e. data/SampleData.rldx)
8. Start up rolodex.jar again. You should see the application loaded with at least 25 sample contacts.
9. The status bar on the bottom right should correctly display the directory at which you placed the SampleData.rldx (the file you are going to be operating on).

Add Command

Basic Functionality

1. Type add n/Alice Ken p/91234567 e/alice@gmail.com a/900, Alice Street
2. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory.

Abbreviations

1. Type a n/Alice Ken p/91234567 e/alice@gmail.com a/800, Alice Street
2. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

1. Type + n/Alice Ken p/91234567 e/alice@gmail.com a/700, Alice Street
2. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

Drop-down List

1. Type a
2. Press Enter or click to select the add option in the drop-down list
3. Press Space
4. Type n/Alice Ken p/91234567 e/alice@gmail.com a/900, Alice Street
5. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

Auto-completion

1. Type add and press Tab
2. Type Alice Ken and press Tab
3. Type 91234567 and press Tab
4. Type alice@gmail.com and press Tab
5. Type 900, Alice Street
6. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

Invalid Command Suggestion

1. Type add alice@gmail.com Alice Ken 900, Alice Street 91234567
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean add n/Alice Ken p/91234567 e/alice@gmail.com a/900, Alice Street?’
4. Press Enter

Expected Behaviour

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

Keyboard Shortcut

1. Press Ctrl + +
2. Type Alice Ken and press Tab
3. Type 91234567 and press Tab
4. Type alice@gmail.com and press Tab
5. Type 900, Alice Street
6. Press Enter

Expected Behaviour:

• New contact with entered particulars is added to Rolodex
• Contact is automatically displayed on the bottom right panel
• Name, phone, email and address fields are compulsory

Delete Command

Basic Functionality

1. Type delete 1
2. Press Enter

Expected Behaviour

• First contact is deleted from Rolodex

Abbreviations

1. Type d 2
2. Press Enter

Expected Behaviour

• Second contact is deleted from Rolodex

1. Type - 3
2. Press Enter

Expected Behaviour

• Third contact is deleted from Rolodex

Auto-completion

1. Type delete and press Tab
2. Type 1 and press Enter

Expected Behaviour

• First contact is deleted from Rolodex

Invalid Command Suggestion

1. Type d21 durian
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean D21?’
4. Press Enter

Expected Behavior

• The 21st contact is deleted from Rolodex

Keyboard Shortcut

1. Press Ctrl + D
2. Type 1 and press Enter

Expected Behaviour

• First contact is deleted from Rolodex

Edit Command

Basic Functionality

1. Type edit 1 n/A p/99999999 e/edit@gmail.com r/Edited contact. t/edited
2. Press Enter

Expected Behaviour

• The particulars of the first contact are edited with the new inputs.
• The tag edited should be added to the existing tags.
• The edited contact is automatically displayed on the bottom right panel

Tag Toggling

1. Type edit 1 t/edited (A should be the first contact)
2. Press Enter

Expected Behaviour

• The tag edited should be removed from A

Abbreviations

1. Type e 1 n/B
2. Press Enter

Expected Behaviour

• First contact should be renamed to B

1. Type change 1 p/88888888
2. Press Enter

Expected Behaviour

• Phone number of first contact should now be “88888888”

1. Type modify 1 e/modified@mail.com
2. Press Enter

Expected behaviour

• Email of first contact should now be "modified@mail.com"

Drop-down List

1. Type e
2. Press ↓ until the edit option is highlighted in the drop-down list
3. Press Enter
4. Press Space
5. Type n/A p/99999999 e/edit@gmail.com r/Edited contact. t/edited
6. Press Enter

Expected Behaviour

• The particulars of the first contact are edited with the new inputs.
• The tag edited should be added to the existing tags.
• The edited contact is automatically displayed on the bottom right panel

Auto-completion

1. Type edit
2. Press Tab
3. Type 1 n/B
4. Press Enter

Expected Behaviour

• First contact should be renamed to B

Invalid Command Suggestion

1. Type edit 1Alice
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean edit 1 n/Alice?’
4. Press Enter

Expected Behaviour

• First contact should be renamed to alice

1. Type edt 1 12345678
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean edit 1 p/12345678?’
4. Press Enter

Expected Behaviour

• Phone number of first contact should now be “12345678”

1. Type edi 1 abc@efg
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean edit 1 e/abc@efg?’
4. Press Enter

Expected Behaviour

• Email of first contact should now be “abc@efg”

1. Type dit 1 3 computing drive
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean edit 1 a/3 computing drive?’
4. Press Enter

Expected Behaviour

• Address of first contact should now be “3 computing drive”

Keyboard Shortcut

1. Press Ctrl + E
2. Type 1 n/bob
3. Press Enter

Expected Behaviour

• First contact should be renamed to bob

Select Command

Basic Functionality

1. Type select 1

Expected Behaviour

• The first contact should be selected

Abbreviations

1. Type s 2

Expected Behaviour

• The second contact should be selected

Drop-Down List

1. Type s
2. Press Enter or click to choose the select option in the drop-down list
3. Press space and type 3
4. Press Enter

Expected Behaviour

• The third contact should be selected

Auto-completion

1. Type s
2. Press Tab
3. Type 1
4. Press Enter

Expected Behaviour

• The first contact should be selected

Invalid Command Suggestion

1. Type s1
2. PressEnter
3. Type y or yes or k or ok or yea or yeah when prompted “Did you mean s 1?”
4. Press Enter

Expected Behaviour

• The first contact should be selected

Keyboard Shortcut

1. Press Esc
2. Press ↓ or ↑ several times
3. Press Enter

Expected Behaviour

• In step 1, the command box should be deselected
• In step 2, the contact list should be scrollable
• In step 3, the command box should be selected

Email Command

Basic functionality

1. Type email 1 s/hello
2. Press Enter

Expected Behaviour

• Your default email client should open a new compose email window
• Recipient’s email address should be the first contact’s email address
• Subject should be “hello”

1. Type email 1
2. Press Enter

Expected Behaviour

• Your default email client should open a new compose email window
• Recipient’s email address should be the first contact’s email address (Subject field is optional)

Auto-completion

1. Type M
2. Press Tab
3. Type 1 s/hello
4. Press Tab

Expected Behaviour

• Your default email client should open a new compose email window
• Recipient’s email address should be the first contact’s email address
• Subject should be “hello”

Invalid Command Suggestion

1. Type mal1 hello
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted “Did you mean mail 1 s/hello?”
4. Press Enter

Expected Behaviour

• Your default email client should open a new compose email window
• Recipient’s email address should be the first contact’s email address
• Subject should be “hello”

Keyboard Shortcut

1. Press Ctrl + M
2. Type 1 s/hello
3. Press Enter

Expected Behaviour

• Your default email client should open a new compose email window
• Recipient’s email address should be the first contact’s email address
• Subject should be “hello”

Find Command

Find by name

Exact matches

1. Type find bravo
2. Press Enter

Expected behavior

• The contact list is filtered with contacts with the name “Bravo”

Fuzzy Matching

1. Type find brabo
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts roughly matching the name “brabo”, “Bravo” included.

Find by tag

1. Type find friends
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”.

Sorting

1. Type find friends n/desc
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”, sorted by descending order of name.

1. Type find friends p/desc
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”, sorted by descending phone.

1. Type find friends p/desc
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”, sorted by descending phone.

1. Type find friends p/desc a/
2. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”, sorted by descending phone, then by ascending address.

Auto-completion

1. Type find
2. Press Tab
3. Type bravo
4. Press Enter

Expected Behavior

• The contact list is filtered with contacts roughly matching the name “brabo”, “Bravo” included.

Keyboard Shortcut

1. Press Ctrl + F
2. Type school and press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “school”.

Invalid Command Suggestion

1. Type findmy friends
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean find friends?’
4. Press Enter

Expected Behavior

• The contact list is filtered with contacts tagged as “friends”.

Help Command

Basic Functionality

1. Type help
2. Press Enter

Expected Behavior

• The Rolodex User Guide should be opened in a new window

Help Window Searching

1. Type add into the search bar located at the top of the window
2. Press Enter or click the Search button

Expected Behavior

• All words “add” in the document should be highlighted in yellow

Invalid Command Suggestion

1. Type halp me
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean help?’
4. Press Enter

Expected Behavior

• The Rolodex User Guide should be opened in a new window

History Command

Basic Functionality

1. Type history
2. Press Enter

Expected Behavior

• Entered commands from most recent to earliest should be displayed on the result panel

Invalid Command Suggestion

1. Type hisdory is a dory pun
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean history?’
4. Press Enter

Expected Behavior

• Entered commands from most recent to earliest should be displayed on the result panel

Keyboard Shortcut

1. Type Ctrl + H

Expected Behavior

• Entered commands from most recent to earliest should be displayed on the result panel

List Command

Basic Functionality

1. Type list
2. Press Enter

Expected Behavior

• All contacts should be listed in Rolodex

Abbreviations

1. Type l
2. Press Enter

Expected Behavior

• All contacts should be listed in Rolodex

1. Type show
2. Press Enter

Expected Behavior

• All contacts should be listed in Rolodex

1. Type display
2. Press Enter

Expected Behavior

• All contacts should be listed in Rolodex

Sorting

1. Type list p/asc a/desc
2. Press Enter

Expected Behavior

• The contact list should be sorted by ascending phone, then by descending address.

Invalid Command Suggestion

1. Type lost is me, Am I lost? Yes I am. Lost little lamb
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean list?’
4. Press Enter

Expected Behavior

• All contacts should be listed in Rolodex

Keyboard Shortcut

1. Press Ctrl + L

Expected Behavior

• All contacts should be listed in Rolodex

New Rolodex Command

Creating New Rolodex at Relative Directory

1. Type new data/SampleData2.rldx or n data/SampleData2.rldx
2. Press Enter

Expected Behaviour

• A new Rolodex is created under the relative directory (data folder should be in same place as .jar file).
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. the data file you are currently operating on)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Creating New Rolodex at System Directory

Windows:

1. Type new C:/Users/YOUR_USERNAME/Desktop/SampleData.rldx
2. Press Enter

Mac:

1. Type new /Users/YOUR_USERNAME/Desktop/SampleData.rldx
2. Press Enter

Linux:

1. Type new /home/YOUR_USERNAME/Desktop/SampleData.rldx
2. Press Enter

Expected Behaviour

• A new test file, SampleData.rldx should be created on your desktop.
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. the data file you are currently operating on)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Attempting to Re-Create Existing Rolodex

1. Type new data/SampleData.rldx
2. Press Enter

Expected Behaviour

• An error message should be displayed, prompting to use the open command instead.
• The original SampleData.rldx should not be overwritten or changed.

Auto-completion

1. Type new
2. Press Tab
3. Typedata/SampleData3.rldx
4. Press Enter

Expected Behaviour

• A new Rolodex is created under the relative directory (data folder should be in same place as .jar file).
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. data/SampleData3.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Invalid Command Suggestion

1. Type new:( data/SampleData4
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean new data/SampleData3.rldx?’
4. Press Enter

Expected Behaviour

• A new Rolodex is created under the relative directory (data folder should be in same place as .jar file).
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. data/SampleData4.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Keyboard Shortcut

1. Press Ctrl + N
2. Typedata/SampleData5.rldx
3. Press Enter

Expected Behaviour

• A new Rolodex is created under the relative directory (data folder should be in same place as .jar file).
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. data/SampleData5.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Open Rolodex Command

Requirements

1. Please complete the section New Rolodex Command before proceeding with this section.

Opening Rolodex at Relative Directory

1. Type open data/SampleData2.rldx or o data/SampleData2.rldx
2. Press Enter

Expected Behaviour

• The original Rolodex under the relative directory (data folder should be in same place as .jar file) is opened.
• The status bar on the bottom right of the application updates to the opened Rolodex (i.e. data/SampleData2.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Opening Rolodex at System Directory

Windows:

1. Type open C:/Users/YOUR_USERNAME/Desktop/SampleData3.rldx
2. Press Enter

Mac:

1. Type open /Users/YOUR_USERNAME/Desktop/SampleData3.rldx
2. Press Enter

Linux:

1. Type open /home/YOUR_USERNAME/Desktop/SampleData3.rldx
2. Press Enter

Expected Behaviour

• The original test file, SampleData.rldx should be loaded onto your application.
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. data/SampleData.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Attempting to Open Non-Existent Rolodex

1. Type open data/SampleData4.rldx
2. Press Enter

Expected Behaviour

• An error message should be displayed, prompting to use the new command instead.
• The original SampleData.rldx should not be overwritten or changed.

Auto-completion

1. Type open
2. Press Tab
3. Type data/SampleData.rldx

Expected Behaviour

• The original Rolodex under the relative directory (data folder should be in same place as .jar file) is opened.
• The status bar on the bottom right of the application updates to the opened Rolodex (i.e. data/SampleData.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Invalid Command Suggestion

1. Type open:) data/SampleData2
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean open data/SampleData2.rldx?’
4. Press Enter

Expected Behaviour

• The Rolodex under the relative directory (data folder should be in same place as .jar file).
• The status bar on the bottom right of the application updates to the new Rolodex (i.e. data/SampleData2.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Keyboard Shortcut

1. Press Ctrl + O
2. Type data/SampleData.rldx
3. Press Enter

Expected Behaviour

• The original Rolodex under the relative directory (data folder should be in same place as .jar file) is opened.
• The status bar on the bottom right of the application updates to the opened Rolodex (i.e. data/SampleData.rldx)
• Undo/Redo no longer works as new data has been inserted and stack has been cleared.

Remark Command

Basic Functionality

1. Type remark 1 r/Loves to talk.
2. Press Enter
3. Type select 1
4. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to talk.”

Abbreviations

1. Type rmk 3 r/Loves to sing.
2. Press Enter
3. Type select 3
4. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to sing.”

1. Type comment 3 r/Loves to jump.
2. Press Enter
3. Type select 3
4. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to jump.”

1. Type note 3 r/Loves to eat.
2. Press Enter
3. Type select 3
4. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to eat.”

Auto-completion

1. Type remark and press Tab
2. Type 1
3. Press Tab
4. Type Loves to swim
5. Press Enter
6. Type select 1
7. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to swim.”

Keyboard shortcut

1. Press Ctrl + R
2. Type 1
3. Press Tab
4. Type Loves to dance
5. Press Enter
6. Type select 1
7. Press Enter

Expected Behaviour

• The selected contact should have the remark “Loves to dance.”

Invalid Command Suggestion

1. Type rmk1 Hates dancing
2. Press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean rmk 1 r/Hates dancing?’
4. Press Enter
5. Type select 1
6. Press Enter

Expected Behaviour

• The selected contact should have the remark “Hates dancing”

Undo Command

Basic Functionality

1. Type delete 1 and press Enter
2. Type undo
3. Press Enter

Expected Behaviour

• The first contact should remain in Rolodex

Abbreviations

1. Type d 1 and press Enter
2. Type undo
3. Press Enter

Expected Behaviour

• The first contact should remain in Rolodex

Drop-Down List

1. Type d 1 and press Enter
2. Type u
3. Press Enter or click to select the undo option in the drop-down list
4. Press Enter

Expected Behaviour

• The first contact should remain in Rolodex

Invalid Command Suggestion

1. Type d 1 and press Enter
2. Type udon YUMMY!!! :P and press Enter
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean undo?’
4. Press Enter

Expected Behaviour

• The first contact should remain in Rolodex

Keyboard Shortcut

1. Type d 1 and press Enter
2. Press Ctrl + Z

Expected Behaviour

• The first contact should remain in Rolodex

Redo Command

Basic functionality

1. Type d 1 and press Enter
2. Type undo and press Enter
3. Type redo
4. Press Enter

Expected Behaviour

• The first contact should be deleted from Rolodex

Abbreviations

1. Type d 1 and press Enter
2. Type undo and press Enter
3. Type r
4. Press Enter

Expected Behaviour

• The first contact should be deleted from Rolodex

Drop-Down List

1. Type d 1 and press Enter
2. Type undo and press Enter
3. Type r
4. Press Enter or click to select the redo option in the drop-down list
5. Press Enter

Expected Behaviour

• The first contact should be deleted from Rolodex

Invalid Command Suggestion

1. Type d 1 and press Enter
2. Type undo and press Enter
3. Type redp
4. Press Enter

Expected Behaviour

• The first contact should be deleted from Rolodex

Keyboard Shortcut

1. Type d 1 and press Enter
2. Type undo and press Enter
3. Press Ctrl + Y

Expected Behaviour

• The first contact should be deleted from Rolodex

Exit Command

1. Type exit or quit or close or bye or esc
2. Press Enter

Expected Behaviour

• The application should be closed.

Invalid Command Suggestion

1. Reopen the application by clicking the rolodex.jar file.
2. Type exito
3. Type y or yes or k or ok or yea or yeah when prompted ‘Did you mean exit?’
4. Press Enter

Expected Behaviour

• The application should be closed.

End

Congratulations. You have reached the end of the tests. Found any bugs? Report it at https://github.com/CS2103AUG2017-W11-B2/main/issues. We’ll give you a cookie for finding bugs! :)

Bonus

Requirements

Make sure you are connected to the internet and are on a network that has port 25 open. Chances are many universities’s (ahem) networks block the incoming port and this won’t work. Solution? Use a tether. Trust us - it’s awesome!

Basic Functionality

1. Type starwars or sw
2. Press Enter.
3. Enjoy!