TypeScript API client for autograder.io. Can be installed via npm:

npm install ag-client-typescript

Requires Ubuntu 20.04 or later and Node 16 (newer versions might work).

git clone --recursive https://github.com/eecs-autograder/ag-client-typescript.git

If you forgot the --recursive flag, initialize the submodule with:

git submodule update --init

You'll also need to rerun this command after pulling repository updates.

If you are updating this library to include new changes to the autograder-server code, make sure the autograder-server submodule is up to date:

git submodule update --remote

Add and commit the autograder-server changes:

git add autograder-server
git commit

Ubuntu: https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-ce-1

First, install Python 3.10

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.10 python3.10-distutils python3.10-venv
curl https://bootstrap.pypa.io/get-pip.py | sudo python3.10

python3.10 -m venv venv
source venv/bin/activate

Next, install the minimum dependencies needed to run generate_secrets.py:

python -m pip install --upgrade pip
python -m pip install Django==3.1 python-gnupg

Run the script:

cd autograder-server && python3 generate_secrets.py

docker compose build
docker compose up -d
docker ps

docker exec -it typescript-cli-django python3 manage.py migrate

npm ci

Note: If you ran npm run build (for publishing new package versions), you will need to delete the "dist" folder, otherwise the linter will read the stale .d.ts files instead of the updated .ts files in the src directory.

Run the linters and test suite:

npm run lint
npm test