student-repos-handler 3.0.0

Simple tool to handle multiple repos at once, oriented to the grading of assignments in UCSE DAR

Student-repos-handler

Simple tool to handle multiple repos at once, oriented to the grading of assignments in courses. It allows you to clone and update multiple repos at once, run commands in them, show summaries of the results, easily find and edit files, browse wiki pages, etc.

This tool is meant to run in a linux environment, though most of the functionality also runs in other OSs. It was built mostly to solve my own needs while grading AI assignments in UCSE DAR, but it's general enough to be used by anyone else.

Installation

Recommended (requires uv):

uv tool install student-repos-handler

You can also install it with pip or any other python package manager.

Usage

First you need to create a repos.config file in a directory where you will manage all of your students repos (for instance, something like /home/fisa/university_ai_course/2026_teams/). In this file you will specify some configs for each repo you want to manage, plus some general configs related to the tools you want to use (code editor and browser). Example contents:

{
    "editor": "vscode",
    "browser": "firefox",
    "repos": {
        "capybara_team": {
            "repo_url": "[e-mail]:capybara_team/assignments.git",
            "description": "Alice Capybara, Bob Capybara, tags: experts,using_python,pending_grade",
            "server_url": "https://www.team_capybara_website.com",
            "has_wiki": true
        },
        "toad_team": {
            "repo_url": "https://github.com/toad_team/grupo2_gomez_failla_ia_2026.git",
            "description": "John Toad, Julia Toad, tags: novices,using_go,already_approved"
        },
        ... and so on
    }
}

With your repos.config file created, you can start using the repos command line tool from that directory. You will probably want to run a repos update for the first time so all the repos are cloned, and then you can explore the rest of the utilities by checking the help with repos help.