python3 -m pip install requests
To generate metrics, you'll want to prepare by updating the orgs[] array in
start.py to include the github organizations you want to analyze.
Note: The more organizations you add to the array, the longer it will take to run - so you may want to consider only running with one org at a time.
There are two ways to set up your local environment to run the script, but either way you'll need a GitHub account and a personal access token.
-
Set the following environment variables:
GITHUB_USERNAMEGITHUB_AUTH_TOKEN -
To generate metrics, run
python3 start.py
-
You can store your GitHub auth token in your OSX keyring and run this script using Summon and the keyring provider.
To do this, add your auth token to your keyring by running:
security add-generic-password \ -s "summon" \ -a "github/api_token" \ -w "[ACCESS TOKEN]" -
Update
secrets.ymlto include your github username. -
To generate metrics, run
summon -p keyring.py python3 start.py
Running the script produces a .json file for each GitHub org you specified in
start.py.