testcase

Author: markhuang1212

README.md

@@ -4,7 +4,7 @@ This is a backend for grading C++ code in a secure and controlled manner.
 
 ## Motivation
 
-Code grading can be a difficult task, and this project aims to simplify that. No matter you want to teach people how to define a variable, how to write a function, how to write an algorithm, or how to write codes that calls other external api, `code-grader` provides a customizable framework to help you do that.
+Code grading can be a difficult task, and this project aims to simplify that. `code-grader` enables grading of different types of code, from one line of variable definition, to a complete project.
 
 ## Usage
 

testcases/README.md

@@ -1,3 +1,21 @@
 # Writing Test Cases
 
 To add testcases to this folder, Please follow guidelines given in folders `example-x`. Upon commit, test cases will be automatically tested. Please make sure the answer can be run within the given runtime and memory.
+
+## Overview
+
+### example-1
+
+This test case is used internally for unit testing. It expect `int main() { cout << "Hello << endl; }`
+
+### simple-1
+
+This test case demonstrate how `code-grader` can be used to grade variable definition. Any variable definition of type `int` that has value `1024` pass. 
+
+```cpp
+int x = 1024; // this will pass
+int y = 1000+24; // this will also pass
+auto z = 0x00000400; // this will also pass
+// however
+char x = 'a'; // this won't pass
+```

testcases/simple-1/README.md

@@ -0,0 +1,11 @@
+# Writing Test Cases - 1
+
+It is compulsory for a test case to contain the following files
+* answer.txt
+* prepend.txt
+* append.txt
+* input.txt
+* output.txt
+* testcase.json
+
+If your test case's input and output is generated by a program/script, it's conventional to put the source code inside a folder called `__generate`

testcases/simple-1/answer.txt

@@ -0,0 +1 @@
+auto hello = 0x00000400;

testcases/simple-1/append.txt

@@ -0,0 +1,14 @@
+    
+    /// user code end
+
+    int *pos = &start + 1;
+
+    if (*pos == 1024)
+    {
+        cout << "Pass" << endl;
+    }
+    else
+    {
+        cout << "Fail" << endl;
+    }
+}

testcases/simple-1/input.txt

@@ -0,0 +1 @@
+Pass

testcases/simple-1/output.txt

@@ -0,0 +1,10 @@
+#include <bits/stdc++.h>
+
+using namespace std;
+
+int main()
+{
+    int start = 0;
+
+    /// user code start
+    

testcases/simple-1/prepend.txt

@@ -0,0 +1,6 @@
+{
+    "RuntimeOptions": {
+        "MemoryLimit": 64,
+        "RuntimeLimit": 5
+    }
+}