repomate 0.4.1

A CLI tool for managing large amounts of GitHub repositories

repomate

Overview

repomate is A CLI tool for administrating large amounts of GitHub repositories, geared towards teachers and GitHub Enterprise. repomate is currently being used for the introductory courses in computer science at KTH Royal Technical Institute of Technology. The courses have roughly 200 students and several thousands of repositories, allowing us to test repomate at quite a large scale.

Getting started

The best way to get started with repomate is to head over to the Docs, where you (among other things) will find the install instructions and user guide.

Why repomate?

repomate was developed at KTH Royal Technical Institute of Technology to help teachers and teaching assistants administrate GitHub repositories. It is inspired by the old teachers_pet tool, with added features and a user experience more to our liking. Features range from creating student repositories based on master (template) repos, to opening and closing issues in bulk. repomate also allows for cloning repos in bulk, and executing arbitrary tasks on the cloned repos by utlizing its simple but powerful plugin system. Below is the output from running repomate -h, giving brief descriptions of each of the main featues:

$ repomate -h
usage: repomate [-h] [-v]
                {setup,update,migrate,clone,add-to-teams,open-issues,close-issues,list-issues,assign-peer-reviews,purge-peer-review-teams,verify-settings}
                ...

A CLI tool for administrating student repositories.

positional arguments:
  {setup,update,migrate,clone,add-to-teams,open-issues,close-issues,list-issues,assign-peer-reviews,purge-peer-review-teams,verify-settings}
    setup               Setup student repos.
    update              Update existing student repos.
    migrate             Migrate master repositories into the target
                        organization.
    clone               Clone student repos.
    add-to-teams        Create student teams and add students to them. This
                        command is automatically executed by the `setup`
                        command.
    open-issues         Open issues in student repos.
    close-issues        Close issues in student repos.
    list-issues         List issues in student repos.
    assign-peer-reviews
                        Randomly assign students to peer review each others'
                        repos.
    purge-peer-review-teams
                        Remove all review teams associated with the specified
                        students and master repos.
    verify-settings     Verify your settings, such as the base url and the
                        OAUTH token.

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         Display version info

Roadmap

repomate is currently in public beta. The currently existing commands are fairly stable and are unlikely to change, barring unexpected bugs or usability issues. This is with the exception of the peer review commands, that are under active development.

The internal API of repomate, including the plugin system, is less stable and may or may not change significantly in the near future.

Any breaking changes will be advertised with deprecation messages in the application well before they are put in effect. repomate is expected to reach a 1.0 release sometime this year.

License

This software is licensed under the MIT License. See the LICENSE file for specifics.