feat: lab2

Author: AxelHowe

lab1/main_test.js

@@ -2,73 +2,22 @@ const test = require('node:test');
 const assert = require('assert');
 const { MyClass, Student } = require('./main');
 
-// 測試 MyClass 的 addStudent 方法
 test("Test MyClass's addStudent", () => {
-    const myClass = new MyClass();
-    const student = new Student();
-    
-    // 新增正確的 Student 物件
-    let index = myClass.addStudent(student);
-    assert.strictEqual(index, 0);
-    assert.strictEqual(myClass.students.length, 1);
-
-    // 嘗試新增非 Student 物件
-    index = myClass.addStudent({});
-    assert.strictEqual(index, -1);
-    assert.strictEqual(myClass.students.length, 1); // 確保長度未變
+    // TODO
+    throw new Error("Test not implemented");
 });
 
-// 測試 MyClass 的 getStudentById 方法
 test("Test MyClass's getStudentById", () => {
-    const myClass = new MyClass();
-    const student1 = new Student();
-    student1.setName("Alice");
-
-    const student2 = new Student();
-    student2.setName("Bob");
-
-    myClass.addStudent(student1);
-    myClass.addStudent(student2);
-
-    // 測試有效 ID
-    let result = myClass.getStudentById(0);
-    assert.strictEqual(result.getName(), "Alice");
-
-    result = myClass.getStudentById(1);
-    assert.strictEqual(result.getName(), "Bob");
-
-    // 測試無效 ID
-    result = myClass.getStudentById(-1);
-    assert.strictEqual(result, null);
-
-    result = myClass.getStudentById(10);
-    assert.strictEqual(result, null);
+    // TODO
+    throw new Error("Test not implemented");
 });
 
-// 測試 Student 的 setName 方法
 test("Test Student's setName", () => {
-    const student = new Student();
-
-    // 設定正確的名字
-    student.setName("Charlie");
-    assert.strictEqual(student.getName(), "Charlie");
-
-    // 設定無效的名字（非字串）
-    student.setName(12345);
-    assert.strictEqual(student.getName(), "Charlie"); // 名字應該不變
-
-    student.setName(null);
-    assert.strictEqual(student.getName(), "Charlie"); // 名字應該不變
+    // TODO
+    throw new Error("Test not implemented");
 });
 
-// 測試 Student 的 getName 方法
 test("Test Student's getName", () => {
-    const student = new Student();
-
-    // 初始 name 應該是空字串
-    assert.strictEqual(student.getName(), "");
-
-    // 設定名稱後應該正確返回
-    student.setName("David");
-    assert.strictEqual(student.getName(), "David");
-});
+    // TODO
+    throw new Error("Test not implemented");
+});

lab2/README.md

@@ -0,0 +1,22 @@
+# Lab2
+
+## Introduction
+
+In this lab, you will write unit tests for functions implemented in `main.js`. You can learn how to use classes and functions in it by uncommenting the code in it. (But remember don't commit them on GitHub)
+
+## Requirement
+
+1. Write test cases in `main_test.js` and achieve 100% code coverage. Remember to use Mock, Spy, or Stub when necessary, you need to at least use one of them in your test cases. (100%)
+
+You can run `validate.sh` in your local to test if you satisfy the requirements.
+
+Please note that you must not alter files other than `main_test.js`. You will get 0 points if
+
+1. you modify other files to achieve requirements.
+2. you can't pass all CI on your PR.
+
+## Submission
+
+You need to open a pull request to your branch (e.g. 311XXXXXX, your student number) and contain the code that satisfies the abovementioned requirements.
+
+Moreover, please submit the URL of your PR to E3. Your submission will only be accepted when you present at both places.

lab2/main.js

@@ -0,0 +1,81 @@
+const fs = require('fs');
+const util = require('util');
+const readFile = util.promisify(fs.readFile);
+
+class MailSystem {
+    write(name) {
+        console.log('--write mail for ' + name + '--');
+        const context = 'Congrats, ' + name + '!';
+        return context;
+    }
+
+    send(name, context) {
+        console.log('--send mail to ' + name + '--');
+        // Interact with mail system and send mail
+        // random success or failure
+        const success = Math.random() > 0.5;
+        if (success) {
+            console.log('mail sent');
+        } else {
+            console.log('mail failed');
+        }
+        return success;
+    }
+}
+
+class Application {
+    constructor() {
+        this.people = [];
+        this.selected = [];
+        this.mailSystem = new MailSystem();
+        this.getNames().then(([people, selected]) => {
+            this.people = people;
+            this.selected = selected;
+        });
+    }
+
+    async getNames() {
+        const data = await readFile('name_list.txt', 'utf8');
+        const people = data.split('\n');
+        const selected = [];
+        return [people, selected];
+    }
+
+    getRandomPerson() {
+        const i = Math.floor(Math.random() * this.people.length);
+        return this.people[i];
+    }
+
+    selectNextPerson() {
+        console.log('--select next person--');
+        if (this.people.length === this.selected.length) {
+            console.log('all selected');
+            return null;
+        }
+        let person = this.getRandomPerson();
+        while (this.selected.includes(person)) {
+            person = this.getRandomPerson();
+        }
+        this.selected.push(person);
+        return person;
+    }
+
+    notifySelected() {
+        console.log('--notify selected--');
+        for (const x of this.selected) {
+            const context = this.mailSystem.write(x);
+            this.mailSystem.send(x, context);
+        }
+    }
+}
+
+// const app = new Application();
+// app.selectNextPerson();
+// app.selectNextPerson();
+// app.selectNextPerson();
+// app.notifySelected();
+
+module.exports = {
+    Application,
+    MailSystem,
+};

lab2/main_test.js

@@ -0,0 +1,6 @@
+const test = require('node:test');
+const assert = require('assert');
+const { Application, MailSystem } = require('./main');
+
+// TODO: write your tests here
+// Remember to use Stub, Mock, and Spy when necessary

lab2/validate.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+
+# Check for unwanted files
+for file in *; do
+  if [[ $file != "main.js" && $file != "main_test.js" && $file != "README.md" && $file != "validate.sh" ]]; then
+    echo "[!] Unwanted file detected: $file."
+    exit 1
+  fi
+done
+
+node=$(which node)
+test_path="${BASH_SOURCE[0]}"
+solution_path="$(realpath .)"
+tmp_dir=$(mktemp -d -t lab2-XXXXXXXXXX)
+
+cd $tmp_dir
+
+rm -rf *
+cp $solution_path/*.js .
+result=$($"node" --test --experimental-test-coverage) ; ret=$?
+if [ $ret -ne 0 ] ; then
+  echo "[!] testing fails"
+  exit 1
+else
+  coverage=$(echo "$result" | grep 'all files' | awk -F '|' '{print $2}' | sed 's/ //g')
+  if (( $(echo "$coverage < 100" | bc -l) )); then
+    echo "[!] Coverage is only $coverage%"
+    exit 1
+  else
+    echo "[V] Coverage is 100%"
+  fi
+fi
+
+rm -rf $tmp_dir
+
+exit 0
+
+# vim: set fenc=utf8 ff=unix et sw=2 ts=2 sts=2: