A CLI tool for managing large amounts of GitHub repositories
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.