Joint Teapot

A handy tool for TAs in JI to handle works through Gitea, Canvas, and JOJ. Joint is related to JI and also this tool which join websites together. Teapot means to hold Gitea, inspired by @nichujie.

This tool is still under heavy development. The docs may not be updated on time, and all the features are provided with the probability to change.

Getting Started

Setup venv (Optional)

python3 -m venv env # you only need to do that once
source env/Scripts/activate # each time when you need this venv

Install

pip3 install -e .
cp .env.example .env && vi .env # configure environment
joint-teapot --help

For developers

pip3 install -r requirements-dev.txt
pre-commit install
pytest -svv

Commands & Features

• archive-all-repos: archive all repos in gitea organization
• check-issues: check the existence of issue by title on gitea
• checkout-releases: checkout git repo to git tag fetched from gitea by release name, with due date
• clone-all-repos: clone all gitea repos to local
• close-all-issues: close all issues and pull requests in gitea organization
• create-issues: create issues on gitea
• create-personal-repos: create personal repos on gitea for all canvas students
• create-teams: create teams on gitea by canvas groups
• get-no-collaborator-repos: list all repos with no collaborators
• get-public-keys: list all public keys on gitea
• get-repos-status: list status of all repos with conditions
• invite-to-teams: invite all canvas students to gitea teams by team name
• prepare-assignment-dir: prepare assignment dir from extracted canvas "Download Submissions" zip
• upload-assignment-grades: upload assignment grades to canvas from grade file (GRADE.txt by default), read the first line as grade, the rest as comments

License

MIT