nus-cs2103-AY1617S1 · rachx · Oct 1, 2016 · Oct 3, 2016 · Oct 3, 2016 · Oct 3, 2016
diff --git a/.project b/.project
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-	<name>addressbook-level4</name>
-	<comment>Project addressbook-level4 created by Buildship.</comment>
+	<name>Agendum</name>
+	<comment>Agendum created by Buildship.</comment>
 	<projects>
 	</projects>
 	<buildSpec>

diff --git a/.travis.yml b/.travis.yml
@@ -11,3 +11,8 @@ addons:
   apt:
     packages:
       - oracle-java8-installer
+
+notifications:
+  email:
+    on_success: change
+    on_failure: always
diff --git a/README.md b/README.md
@@ -1,34 +1,47 @@
-[![Build Status](https://travis-ci.org/se-edu/addressbook-level4.svg?branch=master)](https://travis-ci.org/se-edu/addressbook-level4)
-[![Coverage Status](https://coveralls.io/repos/github/se-edu/addressbook-level4/badge.svg?branch=master)](https://coveralls.io/github/se-edu/addressbook-level4?branch=master)
+[![Build Status](https://travis-ci.org/CS2103AUG2016-W11-C2/main.svg?branch=master)](https://travis-ci.org/CS2103AUG2016-W11-C2/main)
+[![Coverage Status](https://coveralls.io/repos/github/CS2103AUG2016-W11-C2/main/badge.svg?branch=master)](https://coveralls.io/github/CS2103AUG2016-W11-C2/main?branch=master)
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/b2c2cb7e938f4d9eb626926dc3670f3c)](https://www.codacy.com/app/vishnu/main?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=CS2103AUG2016-W11-C2/main&amp;utm_campaign=Badge_Grade)
 
-# Address Book (Level 4)
+# Agendum
 
-<img src="docs/images/Ui.png" width="600"><br>
+<img src="docs/images/Ui.png" width="800"><br>
 
-* This is a desktop Address Book application. It has a GUI but most of the user interactions happen using 
-  a CLI (Command Line Interface).
-* It is a Java sample application intended for students learning Software Engineering while using Java as 
-  the main programming language. 
-* It is **written in OOP fashion**. It provides a **reasonably well-written** code example that is 
-  **significantly bigger** (around 6 KLoC)than what students usually write in beginner-level SE modules. 
-* What's different from [level 3](https://github.com/se-edu/addressbook-level3):
-    * A more sophisticated GUI that includes a list panel and an in-built Browser.
-    * More test cases, including automated GUI testing.
-    * Support for *Build Automation* using Gradle and for *Continuous Integration* using Travis CI.
+### Table of Contents
 
+* [Introduction](#introduction)
+* [Site Map](#site-map)
+* [Acknowledgements](#acknowledgements)
+* [License](#license)
+
+
+### Introduction
+Hello! Do you have too many tasks and are unable to finish all of them? Are you looking for a hassle-free task manager which works swiftly?
+Enter Agendum.
+
+This task manager will assist you in completing all your tasks on time. It will automatically sort your tasks by date, so you can always see the most urgent tasks at the top of list!
+
+With just one line of command, Agendum will carry out your wishes. You don’t ever have to worry about having to click multiple links. It is even capable of allowing you to create your own custom commands! This means that you can get things done even faster, your way.
 
-#### Site Map
+### Site Map
 * [User Guide](docs/UserGuide.md) 
 * [Developer Guide](docs/DeveloperGuide.md) 
-* [Learning Outcomes](docs/LearningOutcomes.md) 
 * [About Us](docs/AboutUs.md)
 * [Contact Us](docs/ContactUs.md)
 
 
-#### Acknowledgements
-
-* Some parts of this sample application were inspired by the excellent 
-  [Java FX tutorial](http://code.makery.ch/library/javafx-8-tutorial/) by *Marco Jakob*. 
+### Acknowledgements
+Our team would like to thank the following people:
 
+* Professor [Damith C. Rajapakse](http://www.comp.nus.edu.sg/~damithch) 
+  for giving us invaluable advice on Software Engineering
+* TA [Muthu Kumar Chandrasekaran](https://www.quora.com/profile/Muthu-Kumar-Chandrasekaran)
+  who has given us constructive feedback to aid in our development of Agendum
+* The development team of Address Book (Level 4) which can be found at this 
+  [GitHub repo](https://github.com/nus-cs2103-AY1617S1/addressbook-level4)
+* [Joe Stelmach](http://natty.joestelmach.com/) who created the Natty Date Parser which powers our date-time parsing.
+* Marco Jakob for providing [Java FX tutorial](http://code.makery.ch/library/javafx-8-tutorial/)
+* [Google Calendar API](https://developers.google.com/google-apps/calendar/)
+* [Mockito](http://site.mockito.org/)
 
-#### Licence : [MIT](LICENSE)
+### License
+* [MIT](LICENSE)
diff --git a/build.gradle b/build.gradle
@@ -35,6 +35,13 @@ allprojects {
         junitVersion = '4.12'
         testFxVersion = '4.0.+'
         monocleVersion = '1.8.0_20'
+        nattyVersion = '0.12'
+		reflectionsVersion = '0.9.10'
+		googleCalendarVersion = 'v3-rev220-1.22.0'
+		googleHttpVersion = '1.21.0'
+		googleOauthVersion = '1.21.0'
+		mockitoVersion = '1.+'
+
 
         libDir = 'lib'
     }
@@ -52,6 +59,12 @@ allprojects {
         compile "com.fasterxml.jackson.core:jackson-databind:$jacksonVersion"
         compile "com.fasterxml.jackson.datatype:jackson-datatype-jsr310:$jacksonDataTypeVersion"
         compile "com.google.guava:guava:$guavaVersion"
+        compile "com.joestelmach:natty:$nattyVersion"
+		compile "org.reflections:reflections:$reflectionsVersion"
+		compile "com.google.apis:google-api-services-calendar:$googleCalendarVersion"
+		compile "com.google.http-client:google-http-client-jackson2:$googleHttpVersion"
+		compile "com.google.oauth-client:google-oauth-client-jetty:$googleOauthVersion"
+		compile "org.mockito:mockito-core:$mockitoVersion"
 
         testCompile "junit:junit:$junitVersion"
         testCompile "org.testfx:testfx-core:$testFxVersion"
@@ -74,10 +87,10 @@ allprojects {
     }
 
     shadowJar {
-        archiveName = "addressbook.jar"
+        archiveName = "agendum.jar"
 
         manifest {
-            attributes "Main-Class": "seedu.address.MainApp"
+            attributes "Main-Class": "seedu.agendum.MainApp"
         }
 
         destinationDir = file("${buildDir}/jar/")
@@ -113,8 +126,8 @@ tasks.coveralls {
     onlyIf { System.env.'CI' }
 }
 
-class AddressBookTest extends Test {
-    public AddressBookTest() {
+class AgendumTest extends Test {
+    public AgendumTest() {
     	  forkEvery = 1
         systemProperty 'testfx.setup.timeout', '60000'
     }
@@ -128,7 +141,7 @@ class AddressBookTest extends Test {
     }
 }
 
-task guiTests(type: AddressBookTest) {
+task guiTests(type: AgendumTest) {
     include 'guitests/**'
 
     jacoco {
@@ -137,19 +150,24 @@ task guiTests(type: AddressBookTest) {
 }
 
 
-task nonGuiTests(type: AddressBookTest) {
-    include 'seedu/address/**'
+task nonGuiTests(type: AgendumTest) {
+    include 'seedu/agendum/**'
 
     jacoco {
         destinationFile = new File("${buildDir}/jacoco/test.exec")
     }
 }
 
 // Test mode depends on whether headless task has been run
-task allTests(type: AddressBookTest) {
+task allTests(type: AgendumTest) {
     jacoco {
         destinationFile = new File("${buildDir}/jacoco/test.exec")
     }
+
+    exec {
+      executable 'rm'
+      args '-vf', 'data/StoredCredential'
+    }
 }
 
 task headless << {

diff --git a/cal/StoredCredential_1 b/cal/StoredCredential_1
diff --git a/cal/StoredCredential_2 b/cal/StoredCredential_2
diff --git a/cal/StoredCredential_3 b/cal/StoredCredential_3
diff --git a/collated/docs/A0003878Y.md b/collated/docs/A0003878Y.md
@@ -0,0 +1,177 @@
+# A0003878Y
+###### /DeveloperGuide.md
+``` md
+### 3. Logic component
+
+`Logic` provides several APIs for `UI` to execute the commands entered by the user. It also obtains information about the to-do list to render to the user.
+The **API** of the logic component can be found at [`Logic.java`](../src/main/java/seedu/agendum/logic/Logic.java)
+
+The class diagram of the Logic Component is given below. `LogicManager` implements the `Logic Interface` and has exactly one `Parser`. `Parser` is responsible for processing the user command and creating instances of concrete `Command` objects (such as `AddCommand`) which will then be executed by the `LogicManager`. New command types must implement the `Command` class. Each `Command` class produces exactly one `CommandResult`.
+
+<img src="images/LogicClassDiagram.png" width="800"><br>
+
+The `CommandLibrary` class is responsible for managing the various Agendum's reserved command keywords and their aliases. The `Parser` checks and queries the `CommandLibrary` to ascertain if a command word given has been aliased to a reserved command word. `AliasCommand` and `UnaliasCommand` will also check and update the `CommandLibrary` to add and remove aliases. The singleton pattern is applied to restrict the instantiation of the class to one object. This is to ensure that all other objects, such as `Parser`, `AliasCommand` and `UnaliasCommand` objects will refer to the same instance that records and manages all the alias relationships.  
+
+You can view the Sequence Diagram below for interactions within the `Logic` component for the `execute("delete 1")` API call.<br>
+
+<img src="images/DeleteTaskSdForLogic.png" width="800"><br>
+
+#### Command Pattern
+The Parser creates concrete Command objects such as `AddCommand` objects. `LogicManager` will then execute the various commands, such as `AddCommand` and `UndoCommand`. Each command does a different task and gives a different result. However, as all command types inherit from the abstract class `Command` and implement the _`execute`_ method, LogicManager (the invoker) can treat all of them as Command Object without knowing each specific Command type. By calling the _`execute`_ method, different actions result.
+
+
+```
+###### /DeveloperGuide.md
+``` md
+## Appendix C : Non Functional Requirements
+
+1.  Should work on any [mainstream OS](#mainstream-os) as long as it has Java `1.8.0_60` or higher installed.
+2.	Should be able to hold up to 800 tasks in total (including completed tasks).
+3.	Should come with automated unit tests.
+4.	Should use a Continuous Integration server for real time status of master’s health.
+5.	Should be kept open source code.
+6.	Should favour DOS style commands over Unix-style commands.
+7.	Should adopt an object oriented design.
+8.	Should not violate any copyrights.
+9.	Should have a response time of less than 2 second for every action performed.
+10.	Should work offline without an internet connection.
+11.	Should work as a standalone application.
+12.	Should not use relational databases to store data.
+13.	Should store data in an editable text file.
+14.	Should not require an installer.
+15.	Should not use paid libraries and frameworks.
+16.	Should be a free software.
+17.	Should be easily transferrable between devices; only 1 folder needs to be transferred.
+18.	Should have documentation that matches the source code
+19.	Should not have unhandled exceptions from user input
+20.	Should be installable without assistance other than the user guide.
+21. Should have understandable code such that new members can start working on the project within 1 week.
+
+
+&nbsp;
+
+
+```
+###### /UserGuide.md
+``` md
+## Getting Started
+
+### Download
+
+1. Ensure that you have Java version `1.8.0_60` or above installed on your computer.
+2. Download the latest `Agendum.jar` from [here](../../../releases).<br>
+<img src="images/userguide/releases.png" width="300"><br>
+3. Copy the jar file to the folder that you intend to use as the root directory of Agendum.
+
+### Launch
+
+To launch Agendum, double-click on `Agendum.jar` to launch Agendum. Welcome!
+
+Here is the main window you will be greeted with. Initially the task panels are empty but fill them up with tasks soon.
+
+<img src="images/userguide/launch.png" width="800"><br>
+
+```
+###### /UserGuide.md
+``` md
+## Features
+
+### Commands
+
+**Here are some general things to note:**
+> * All command words are case-insensitive. e.g. `Add` will match `add`
+> * Words enclosed in angle brackets, e.g.`<name>` are the parameters. You can freely decide what you want to use in its place.
+> * Parameters with `...` after them can have multiple instances (separated by whitespace). For example, `<id>...` means that you can specify multiple indices such as `3 5 7`.
+
+
+### Adding a task: `add`
+
+If you have a task to work on, add it to the Agendum to start keeping track! <br>
+
+Here are the *acceptable format(s)*:
+
+* `add <name>` - adds a task which can be done anytime.
+* `add <name> by <deadline>` - adds a task which have to be done by the specified deadline. Note the keyword `by`.
+* `add <name> from <start time> to <end time>` - adds a event which will take place between start time and end time. Note the keyword `from` and `to`.
+
+Here are some *examples*:
+
+```
+Description: I want to watch Star Wars but I don't have a preferred time.
+> add watch Star Wars
+Result: Agendum will add a task to the "Do It Anytime" panel.
+
+Description: I need to return my library books by the end of this week.
+> add return library books by Friday 8pm
+Result: Agendum will add a task "return library books" to the "Do It Soon" panel.
+It will have a deadline set to the nearest upcoming Friday and with time 8pm.
+
+Description: I have a wedding dinner which will take place on 30 Oct night.
+> add attend wedding dinner from 30 Oct 7pm to 30 Oct 9.30pm
+Result: Agendum will add a task "attend wedding dinner" to the "Do It Soon" panel.
+It will have a start time 30 Oct 7pm and end time 30 Oct 9.30pm.
+```
+
+> A task cannot have both a deadline and a event time.
+
+Did Agendum intepret part of your task name as a deadline/event time when you did not intend for it to do so? Simply `undo` the last command and remember to enclose your task name with **single** quotation mark this time around.
+```
+> add 'drop by 7 eleven' by tmr
+```
+
+#### Date Time Format
+How do you specify the `<deadline>`, `<start time>` and `<end time>` of a task?
+
+Agendum supports a wide variety of date time formats. Combine any of the date format and time format below. The date/time formats are case insensitive too.
+
+*Date Format*
+
+| Date Format     | Example(s)           |
+|-----------------|----------------------|
+| Month/day       | 1/23                 |
+| Day Month       | 1 Oct                |
+| Month Day       | Oct 1                |
+| Day of the week | Wed, Wednesday       |
+| Relative date   | today, tmr, next wed |
+
+ > If no year is specified, it is always assumed to be the current year.
+ > It is possible to specify the year before or after the month-day pair in the first 3 formats (e.g. 1/23/2016 or 2016 1 Oct)
+ > The day of the week refers to the following week. For example, today is Sunday (30 Oct). Agendum will interpret Wednesday and Sunday as 2 Nov and 6 Nov respectively (a week from now).
+
+*Time Format*
+
+| Time Format     | Example(s)                              |
+|-----------------|-----------------------------------------|
+| Hour            | 10, 22                                  |
+| Hour:Minute     | 10:30                                   |
+| Hour.Minute     | 10.30                                   |
+| Relative time   | this morning, this afternoon, tonight   |
+
+> By default, we use the 24 hour time format but we do support the meridian format as well e.g. 10am, 10pm
+
+Here are some examples of the results if these formats are used in conjunction with the `add` command.  
+```
+> add submit homework by 9pm
+Result: The day is not specified. Agendum will create a task "submit homework"
+with the deadline day as today (the date of creation) and time as 9pm
+
+> add use coupons by next Wed
+Result: The time is not specified. Agendum will create a task "use coupons"
+with deadline day as the upcoming Wednesday and time as the current time.
+
+> add attend wedding dinner from 10 Nov 8pm to 10 Nov 9pm
+Result: All the date and time are specified and there is no ambiguity at all.
+```
+
+Note
+> If no year, date or time is specified, the current year, date or time will be used.
+> It is advisable to specify both the date and time.
+
+
+Helpful tip: With Agendum, you can skip typing the second date only if the deadline/event is **happening some time in the future**
+```
+> add attend wedding dinner from 30 Nov 8pm to 9pm
+```
+
+
+```