Add test script for local solution testing (#366)

* add test script

* add readme

* remove curDir

* Apply suggestions from code review

Co-authored-by: Isaac Good <[email protected]>

* simplify

* fix scripts

* fix scripts

---------

Co-authored-by: Isaac Good <[email protected]>

Author: 0xNeshi

README.md

@@ -57,14 +57,18 @@ _Thoughtful suggestions will likely result faster & more enthusiastic responses
 
 <br>
 
-## Testing
+## Verifying
 
-Tests currently use Cairo v2.9.2 (included with Scarb v2.9.2).
+The track currently uses Cairo v2.9.2 (included with Scarb v2.9.2).
 
-To test all exercises, run `./bin/verify-exercises`.
-This command will iterate over all exercises and check to see if their exemplar/example implementation passes all the tests.
+To verify all exercises, run `./bin/verify-exercises`.
+This command will iterate over all exercises and check to see if the stub compiles and the exemplar/example implementation passes all the tests.
 
-To test a single exercise, run `./bin/verify-exercises <exercise-slug>`.
+To verify a single exercise, run `./bin/verify-exercises <exercise-slug>`.
+
+# Testing
+
+To check whether your solution passes the tests, just run `./bin/test <exercise-slug>`
 
 ### Track linting
 

bin/test

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+
+# Synopsis:
+# Test the student's solution.
+
+# Example: test two-fer
+# ./bin/test two-fer
+
+set -eo pipefail
+
+repo=$(git rev-parse --show-toplevel)
+
+if (( "$#" != 1 )); then
+    echo "Error: Incorrect number of arguments. This script requires exactly one argument."
+    echo "Expected: './bin/test <exercise-slug>'"
+    exit 1
+fi
+    
+slug="$1"
+
+exercise_path="$repo/exercises/*/$slug"
+if [[ ! -d "$exercise_path" ]]; then
+    echo "No such exercise $slug"
+    exit 1
+fi
+
+# Exercism sets a timeout limit for tests
+timeout 20 scarb --manifest-path "$exercise_path/Scarb.toml" cairo-test --include-ignored --test-kind integration || { echo "$slug timed out"; exit 1; }