The overall flow of autograding

1. Set up a project via GitHub classroom

2. Solve problems locally

3. Push with a tag

4. GitHub action automatically grades the submitted code

5. GitHub action leaves comments on a 'feedback' pull request

6. GitHub action sends grading scores to the google spreadsheet

Requirements for autograding

For submission, you should fill in your information.

Go to Link and register.

• Nickname: your submission will be recorded on a spreadsheet with this nickname

After registration, you should do set up authentification.

Each project has 'auth.yaml' file.

You should type your information (student id and password) in this file.

If not, your submission will not be graded.

How to push with a tag?

Before reading this article, please fully understand what a tag is.

Autograding action triggers on a certain tag.

If you want to submit your code without ANY UNEXPECTED SITUATION, you should follow the steps below

1. Create a tag that starts with sub.

   • For example, sub.1, sub.2, sub.3 and etc.

   • Command: 'git tag <tag name>'

2. Push tag with your commits (Read this step carefully!!)

   • Pushing tag is different from pushing a commit

     • If you type 'git push --tags', it pushes your tag only not your commits

   • Command: 'git push --atomic origin <branch name> <tag name>'

     • --atomic flag does 'git push sub.1' and 'git push' altogether

   • For example, 'git push --atomic origin main sub.1'

For example, if you want to submit your code with tag name sub.2, you should type like below.

git add .

git commit -m "<Some message>"

git tag sub.2

git push --atomic main sub.2

Case study: set up for project 1

1. Set up a project via GitHub classroom

First, you should accept the assignment

Second, check repository created, and clone it to your local

2. Solved problems locally

You solved the problem with the given local autograder.

3. Push with a tag

You want to submit your code. Then, you should type the following commands.

git add .

git commit -m "<MESSAGE>"

git tag <tag_name>

git push --atomic origin main <tag_name>

4. Autograding runs

First, open GitHub repository and go to pull requests/feedback

Check the test passed or not.

Check spreadsheet.

5. Write report and submit

Write reports and submit through PLMS