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

2.3 KiB Raw Blame History