idahoinstitute / repo-tools

Tools for repo maintenance, etc.

This repo contains a number of tools for working with GitHub repositories:

• author_check.py: Check that AUTHORS is correct in our repos.
• pull_age.py: Compute the age of pull requests.
• wall.py: Run the wall-displayed Pull Request aging chart.
• sync_labels.py: Sync labels across all GitHub repos to another.

Most of these make GitHub API calls, and so will need GitHub credentials in order to not be severely rate-limited. Edit (or create) ~/.netrc so that it has an entry like this:

machine api.github.com
  login your_user_name
  password ddf9079e12042ac022c101c61c0235965851e209

The login is your GitHub user name, the password is the personal access token you get from https://github.com/settings/applications.

Installation

You'll need to have virtualenv installed already. Then run:

$ git clone https://github.com/edx/repo-tools.git
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt

people.yaml contains the mapping between GitHub username and the canonical entry for AUTHORS files. It also has information about whether the person has signed a contributor agreement or is covered by the institution they work for.

author_check

A commandline utility for checking for consistency between committers, people who have signed a contributor agreement and people in the AUTHORS file.

author_check needs a different authentication mechanism than ~/.netrc. Create an auth.yaml file of the form:

user: "<your github username>"
token: "<your personal access token>"

Various ways to invoke author_check.py:

$ ./author_check.py <owner>/<repo>
audits the given repo

$ ./author_check.py <owner>/<repo> <pull-request-number>
audits the given pull request

$ ./author_check.py <user>
status of given user

$ ./author_check.py
audits all repos in repos.yaml

wall

Generates the JSON used to build the wall-displayed Pull Request age chart.

$ python wall.py > age/age.json
returns a JSON string of aging data

$ python -m SimpleHTTPServer && python -m webbrowser age/age.html
look at the awesome chart

sync_labels

Syncs all github repos in repos.yaml to contain all the labels in labels.yaml

Deletes any labels that exist in a repo but not in labels.yaml

Feedback

Please send any feedback to [email protected].