repobee 1.2.1

A CLI tool for managing large amounts of GitHub repositories

RepoBee

Overview

RepoBee is A CLI tool for administrating large amounts of Git repositories, geared towards teachers and GitHub Enterprise. The most basic use case is to automate generation of student repositories based on master (i.e. template) repositories, that can contain for example instructions and skeleton code. There is however a whole lot more on offer, such as batch updating and cloning, simple peer review functionality as well as issue management features. There is also a plugin system in place that allows Python programmers to expand RepoBee in various ways. The repobee-junit4 plugin plugin is one such plugins, which JUnit4 test classes on Java code in cloned student repos.

RepoBee 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 RepoBee at quite a large scale.

Install

RepoBee is on PyPi, so python3 -m pip install repobee should do the trick. See the install instructions for more elaborate instructions.

Getting started

The best way to get started with RepoBee is to head over to the Docs, where you (among other things) will find the user guide. It covers the use of RepoBee's varous commands by way of practical example, and should set you on the right path with little effort.

Why RepoBee?

RepoBee 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, to assigning peer reviews and cloning repos in bulk. Some parts of RepoBee can be customized using a simple but powerful plugin system. For example, the repobee-junit4 plugin allows for automatically running JUnit4 test classes on production code in student repos. Below is the output from running repobee -h, giving brief descriptions of each of the main features:

$ repobee -h
usage: repobee [-h] [-v]
                {show-config,setup,update,migrate,clone,open-issues,
                 close-issues,list-issues,assign-reviews,
                 purge-review-teams,check-reviews,verify-settings}
                ...

A CLI tool for administering large amounts of git repositories on GitHub
instances. See the full documentation at https://repobee.readthedocs.io

positional arguments:
  {show-config,setup,update,migrate,clone,open-issues,
   close-issues,list-issues,assign-reviews,
   purge-review-teams,check-reviews,verify-settings}
    show-config         Show the configuration file
    setup               Setup student repos.
    update              Update existing student repos.
    migrate             Migrate master repositories into the target
                        organization.
    clone               Clone student repos.
    open-issues         Open issues in student repos.
    close-issues        Close issues in student repos.
    list-issues         List issues in student repos.
    assign-reviews      Randomly assign students to peer review each others'
                        repos.
    purge-review-teams  Remove all review teams associated with the specified
                        students and master repos.
    check-reviews       Fetch all peer review teams for the specified student
                        repos, and check which assigned reviews have been done
                        (i.e. which issues have been opened).
    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

As of December 17th 2018, RepoBee's CLI is a stable release and adheres to Semantic Versioning 2.0.0. The internals of RepoBee do not adhere to this versioning, so using RepoBee as a library is not recommended.

The plugin system is still to be considered in the beta phase, as it has seen much less live action use than the rest of the CLI. Features are highly unlikely to be cut, but hooks may be modified as new use-cases arise.

License

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