I’ve been using the Classroom grading mechanism for two semesters and generally am very happy with it. I am wondering if there is a way to display the score from the latest build at the top of the README, similar to build status badges, so that students can see their grade without having to dig down into the build details and scroll through system output, etc.
So, the final line that reads something like “Points 75/85” is what I want to display atop the README.
There is no current way of doing this. Though, you can write an automation script that does this. I am currently building my own version of the GitHub Classroom desktop tool so this is something that I will implement. @stevenbitner
It seems like if it isn’t available it requires either,
I suppose through non-password protected SSH keys on a server to connect to Github to pull the data, the latter idea is possible, but both approaches feel dirty. I’m sure there are ideas that I just haven’t considered though.
I have a solution to this, using an orphan branch for the points status badge. I also had to fork and slightly modify the education/autograding action. (I’m sure someone else can come up with something better.)
I assume you are looking for something like this: 
Replace (or edit) the .github/workflow/classroom.yml
name: GitHub Classroom Workflow
on:
push:
branches:
- '*'
- '!badges'
jobs:
build:
name: Autograding
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
# add id to action so outputs can be used
- uses: education/autograding@v1
id: autograder
continue-on-error: true
# make dir for badges
- name: badges branch and make dir
run: |
git checkout badges
mkdir -p .github/badges
# make points badge
- name: points badge
uses: emibcn/badge-action@v1
with:
LABEL: 'Points'
STATUS: ${{ steps.autograder.outputs.points }}
COLOR: cyan
path: '.github/badges/points.svg'
- name: Upload badge as artifact
uses: actions/upload-artifact@v2
with:
name: badge
path: '.github/badges/points.svg'
if-no-files-found: error
# commit and push badge if score has changed
- name: Commit badge
run: |
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add '.github/badges/points.svg'
git commit -m "Add/Update badge"
continue-on-error: true
- name: Push badge commit
uses: ad-m/github-push-action@master
if: success()
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
branch: badges
For the badge add the following to the README file
You can see this working here: https://github.com/markpatterson27/Simple-SQL-Exercise
[Edit: having read up a bit more on GH action outputs, I’ve realised points total is already exposed without having to fork the action. I’ve corrected the above .yml to reflect this.]
I changed
git checkout badges
to
git checkout -B badges
to ensure the action doesn’t break when I forget to create a badges branch. This solution is exactly what I wanted. Thanks @markpatterson27, if we ever cross paths I owe you a 
or 
.
EDIT: the above breaks on subsequent pushes since -B resets the branch. I grabbed this solution from SO - git checkout badges 2>/dev/null || git checkout -b badges.
I’ve added a progress style bar to the svg badge. It makes it a little clearer to students what their score is.
I’ve written it into it’s own action: Points Bar. The action includes a few styling options if you want to change the colors or the label used. There’s also a second style bar that might fit better for grading score feedback.
with
by
