[Cheng-Zhiyuan] iP

.gitignore

@@ -15,3 +15,9 @@ bin/
 
 /text-ui-test/ACTUAL.TXT
 text-ui-test/EXPECTED-UNIX.TXT
+
+#.class files
+*.class
+
+#data.txt
+/data/data.txt

README.md

@@ -1,4 +1,4 @@
-# Duke project template
+# Thoth project template
 
 This is a project template for a greenfield Java project. It's named after the Java mascot _Duke_. Given below are instructions on how to use it.
 
@@ -13,7 +13,7 @@ Prerequisites: JDK 17, update Intellij to the most recent version.
    1. If there are any further prompts, accept the defaults.
 1. Configure the project to use **JDK 17** (not other versions) as explained in [here](https://www.jetbrains.com/help/idea/sdk.html#set-up-jdk).<br>
    In the same dialog, set the **Project language level** field to the `SDK default` option.
-1. After that, locate the `src/main/java/Duke.java` file, right-click it, and choose `Run Duke.main()` (if the code editor is showing compile errors, try restarting the IDE). If the setup is correct, you should see something like the below as the output:
+1. After that, locate the `src/main/java/Thoth.java` file, right-click it, and choose `Run Thoth.main()` (if the code editor is showing compile errors, try restarting the IDE). If the setup is correct, you should see something like the below as the output:
    ```
    Hello from
     ____        _        

data/data.txt

@@ -0,0 +1,3 @@
+[E][X] work on CS2113 IP (from: 13/03/2025 12 noon to: 13/03/2025 4 pm)
+[E][ ] sleep (from: now to: never)
+[D][X] sleep (by: 11pm)

docs/README.md

@@ -1,30 +1,166 @@
-# Duke User Guide
+# Thoth User Guide
+Thoth Task Manager is a command-line application designed to help you manage your daily tasks efficiently. It supports adding todos, deadlines, and events, as well as marking tasks as done, unmarking them, deleting tasks, and searching for tasks. This README provides an overview of the application, installation instructions, usage details, and troubleshooting tips.
 
-// Update the title above to match the actual product name
+Thoth Task Manager enables you to manage three main types of tasks:
 
-// Product screenshot goes here
+- **Todos:** Simple tasks that need to be done.
+- **Deadlines:** Tasks that must be completed by a specific date/time.
+- **Events:** Tasks that occur within a specified time range.
 
-// Product intro goes here
+Users interact with the application via a command-line interface (CLI) by entering commands that the system parses and executes. Each command is processed through a central parser that maps user input to the corresponding functionality. 
 
-## Adding deadlines
+When you start Thoth Task Manager, you will be greeted with a welcome message followed by a prompt where you can enter your commands. The application continuously listens for your input until you choose to exit.
 
-// Describe the action and its outcome.
+## Available Commands
+### Exiting the Application: _bye_
 
-// Give examples of usage
+The bye command terminates the application gracefully. It prints a goodbye message to indicate that the session is closing.
 
-Example: `keyword (optional arguments)`
+Syntax: 
+```
+    bye
+```  
+Example code:   
+```
+    bye
+```
+Sample output: 
+```
+    Bye. Hope to see you again soon!
+```
+
+### Listing the Task Lists: _list_
 
-// A description of the expected outcome goes here
+The list command prints the list of the users to the screen of the CLI software
 
+Syntax: 
+```
+    list
 ```
-expected output
+Example code: 
 ```
+    list
+```
+Sample output:
+```
+    1. [T][ ] eat 
+    2. [T][ ] sleep 
+    3. [T][ ] repeat
+``` 
+### Adding a todo task : _todo_
+The `todo` command adds a new simple task without any associated deadline or time.  
 
-## Feature ABC
+Syntax: 
+```
+    todo TASK_DESCRIPTION
+```  
+Example code: 
+```
+    todo work on CS2113 IP
+```
+Sample output:
+```
+    Got it. I've added this task:
+    [T][ ] work on CS2113 IP
+    Now you have 4 tasks in the list.
+```
+### Adding a deadline task : _deadline_
+The `deadline` command creates a task with a deadline. Both a task description and a deadline time must be specified.
 
-// Feature details
+Syntax: 
+```
+    deadline TASK_DESCRIPTION /by DEADLINE_TIME
+```  
+Example code: 
+```
+    deadline work on CS2113 IP /by tody 2359
+```
+Sample output: 
+```
+    Got it. I've added this task:
+    [D][ ] work on CS2113 IP (by: today 2359)
+    Now you have 5 tasks in the list.
+```
+### Adding an event task : _event_ 
+The `event` command schedules a task that occurs during a specified time range. The task description, start and end time of the event must be specified.
 
+Syntax: 
+```
+    event TASK_DESCRIPTION /from START_TIME /to END_TIME
+```  
+Example code: 
+```
+    event work on CS2113 IP /from 13/03/2025 12 noon /to 13/03/2025 4 pm
+```
+Sample output: 
+```
+    Got it. I've added this task:
+    [E][ ] work on CS2113 IP (from: 13/03/2025 12 noon to: 13/03/2025 4 pm)
+    Now you have 6 tasks in the list.
+```
+### Marking a task as Done: _mark_
+The `mark` command sets a task's status to the done state.  
 
-## Feature XYZ
+Syntax: 
+```
+    mark TASK_LIST_INDEX
+```
+Example code: 
+```
+    mark 1
+```
+Sample Output:
+```
+    Nice! I've marked this task as done:
+    [T][X] eat
+```
+### Marking a task as Not Done: _unmark_
+The `unmark` command reverts a task's status back to the not done state.  
+Syntax:
+```
+    unmark TASK_LIST_INDEX
+```
+Example code:
+```
+    unmark 1
+```
+Sample Output:
+```
+    OK, I've marked this task as not done yet:
+    [T][ ] eat
+```
+### Deleting a task from the task list: _delete_
+The `delete` command removes a specified task from your list.   
+
+Syntax:
+```
+    detele TASK_LIST_INDEX
+```
+Example code:
+```
+    delete 2
+```
+Sample Output:
+```
+    Noted. I've removed this task:
+    [T][ ] sleep
+    Now you have 5 tasks in the list.
+```
+### Finding tasks with a string: _find_ 
+The `find` command searches for tasks containing a specified keyword (case-insensitive) and displays the matching tasks.    
 
-// Feature details
+Syntax:
+```
+    find KEYWORD
+```
+Example code:
+```
+    find CS2113
+```
+Sample Output:
+```
+    Here are the matching tasks:
+    1. [T][ ] work on CS2113 IP
+    2. [D][ ] work on CS2113 IP (by: today 2359)
+    3. [E][ ] work on CS2113 IP (from: 13/03/2025 12 noon to: 13/03/2025 4 pm)
+```

src/main/java/META-INF/MANIFEST.MF

@@ -0,0 +1,3 @@
+Manifest-Version: 1.0
+Main-Class: thoth.Thoth
+

src/main/java/thoth/Storage.java

@@ -0,0 +1,92 @@
+package thoth;
+
+import thoth.parser.TaskParser;
+import thoth.tasks.Task;
+
+import java.io.File;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Scanner;
+
+
+public class Storage {
+
+    private static final String DEFAULT_FILE_PATH = "data/data.txt";
+    private static final int MIN_HEADER_SIZE = 7;
+    private static final int TYPE_INDEX = 1;
+    private static final int DONE_INDEX = 4;
+
+    /**
+     * Create a file to store data
+     *
+     * @throws IOException if an I/O error occurs while creating the file
+     */
+    public static void createFile() throws IOException {
+        File file = new File(DEFAULT_FILE_PATH);
+
+        // Ensure the parent directories exist (if there are any)
+        if (file.getParentFile() != null) {
+            file.getParentFile().mkdirs();
+        }
+        // Create the file if it doesn't already exist
+        if (!file.exists()) {
+            file.createNewFile();
+        }
+    }
+
+    /**
+     * Add a new line into the file with the user input
+     *
+     * @param input the string to be written to the file
+     * @throws IOException if an I/O error occurs while writing to this file
+     */
+    public static void writeFile(String input) throws IOException {
+        try (FileWriter fw = new FileWriter(DEFAULT_FILE_PATH, true)) {
+            fw.append(input).append(System.lineSeparator());
+        }
+    }
+
+    /**
+     * Saves the list of tasks into the data file
+     *
+     * @param tasks the task list that is to be saved
+     * @throws IOException if an I/O error occurs while writing to this file
+     */
+    public static void saveTasks(List<Task> tasks) throws IOException {
+        try (FileWriter fw = new FileWriter(DEFAULT_FILE_PATH, false)) {
+            for (Task t : tasks) {
+                fw.write(t.getTaskString() + System.lineSeparator());
+            }
+        }
+    }
+
+    /**
+     * Load the task from the data file
+     *
+     * @return a list of tasks loaded from the file or an empty list if the file does not exist
+     * @throws IOException if an I/O error occurs while writing to this file
+     */
+    public static List<Task> loadTasks() throws IOException {
+        List<Task> tasks = new ArrayList<>();
+        File f = new File(DEFAULT_FILE_PATH);
+        if (!f.exists()) {
+            return tasks; // no file => no tasks
+        }
+
+        try (Scanner s = new Scanner(f)) {
+            while (s.hasNextLine()) {
+                String line = s.nextLine().trim();
+                Task t = TaskParser.parseLineToTask(line);
+                if (t != null) {
+                    tasks.add(t);
+                }
+            }
+        }
+
+        return tasks;
+    }
+
+
+}