CS3281 Github Utility

This is a basic python3 utility program to help with batch git clone, push, and a few other operations.

Installation and Running

You need python3 with pip.
I am using pipenv to manage dependencies.

pipenv install
pipenv shell
python3 CS3281Automation.py

Basic Usage

The program runs a primitive/clunky REPL.
Basic commands:

• q - exit
• activate # - "opens" an assignment # for grading. Prompts for grading group and clones the assignment from github if the directory does not exist.
• status - prints the current activated assignment.
• print_grades - prints the "grade.md" of each repository under the current activated assignment.
• push_grading - adds, commits, and pushes the file "grade.md" for each repository under the current activated assignment.
• check_commits - checks github for new commits for the current assignment.
• check_commit_date - prints the commit date of the latest commit for each repository for the current assignment.
• help - doesn't do anything

Directory Structure

The expected directory structure that this program uses is the following. The groupN.txt files are lists (separated by new line) of github IDs for that specified group number.

|-- assignment1
|   |-- assignment-1-student123
|   |-- assignment-1-student234
|   `-- assignment-1-student345
|-- assignment2
|   |-- assignment-2-student123
|   |-- assignment-2-student234
|   `-- assignment-2-student345
|-- Automation
|   |-- ...
|   `-- CS3281Automation.py
|-- group1.txt
|-- group2.txt
|-- group3.txt
|-- group4.txt
`-- group5.txt

Example usage

python3 CS3281Automation.py

# Clone grading group 2 for assignment 6:
activate 6
y
3

# Check commit dates for late days
check_commit_date

# When done grading, print the grades for the current assignment (or for entering in gradebook)
print_grades

# When everything looks good, push to github
push_grading

# Exit the program
q

Screenshot