Package: repomate
RepomateImportant:Repomate has changed name to RepoBee. Please seeRepoBee's GitHub pagefor details.OverviewRepomate 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 atKTH 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.InstallRepomate is on PyPi, sopython3 -m pip install repomateshould do the trick. See theinstall instructionsfor more elaborate instructions.Getting startedThe best way to get started with Repomate is to head over to theDocs, where you (among other
things) will find theuser guide.
It covers the use of Repomate's varous commands by way of practical example,
and should set you on the right path with little effort.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 oldteachers_pettool, 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 Repomate can be customized using a simple but powerfulplugin
system. For example, therepomate-junit4pluginallows for
automatically runningJUnit4test classes on production code in student repos.
Below is the output from runningrepomate -h, giving brief descriptions of
each of the main features:$ repomate -h
usage: repomate [-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://repomate.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 infoRoadmapAs of December 17th 2018, Repomate's CLI is a stable release and adheres toSemantic Versioning 2.0.0. The internals
of Repomatedo notadhere to this versioning, so using Repomate 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.LicenseThis software is licensed under the MIT License. See theLICENSEfile for specifics.