Skip to content
Brian Warner edited this page Mar 20, 2018 · 11 revisions

Facade is a tool for monitoring who is contributing code to git repositories. When properly configured, it can provide useful insights into who is doing the bulk of the work across multiple repos, and allow you to identify when an organization's contribution patterns change.

Useful links:

Getting started

Writing your own UI

Updates to the database

If you've pulled new code and something seems not right, your best bet is to try running facade-worker.py. All of the database update logic is in that script, and to the greatest extent possible Facade should detect an out-of-date database and bring it up to speed.

A note on Python versions:

Facade has migrated from Python 2 to Python 3 for a variety of reasons. The legacy Python 2 version is in a branch, appropriately called "python2-legacy", in case you need to stick with that. New development will proceed using Python 3.

  • If you are doing a fresh install: the install_deps.sh script will pull in the proper versions of things.
  • If you are updating an existing installation: you need to run install_deps.sh again to pull in the proper dependencies. If you're using cron to run facade-worker.py you'll also need to change python to python3 in your crontab.