github-social-graph

This program helps to build simple social graphs for GitHub with the help of GitHub API v3 and graphviz.

Prerequisites

To build Pillow and pygraphviz dependencies you will need some dev packages. Example for Debian-like system:

$ [sudo] apt-get install python-dev libjpeg-dev pkg-config graphviz-dev

Install

$ [sudo] pip install github-social-graph

Usage

Show help:

$ github-social-graph -h  # or gsg -h

Usage examples:

# Draw graph for vim-jp organization members (without authorization):
$ gsg --orgs vim-jp -o 1.png

# Draw graph for organization and users (with authorization by password):
$ gsg -u Kagami -p --orgs vim-jp --users Shougo -o 1.png

# Only fetch data for future use and analysis:
$ gsg --orgs vim-jp -o jp.json

# Use pre-fetched data to draw graph:
$ gsg -i jp.json -o jp.png

Examples

This graph demonstrates some curious relationships between Japanese/Vim/Haskell users (click for fullsize image):

(Produced by github-social-graph --token --orgs vim-jp akechi golang-samples vimjolts neovim --users bos tibbe donsbot kazu-yamamoto spl MarcWeber ZyX-I -o jp.png)

Much simpler graph:

(Produced by github-social-graph --full-graph --users Kagami -o kagami.png)

TODO

• Proper error handling
• Info about current rate limits
• Deep crawling
• Merge several JSON inputs
• Additional graph modes and options

License

github-social-graph - Build simple social graphs for GitHub

Written in 2014-2015 by Kagami Hiiragi [email protected]

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see http://creativecommons.org/publicdomain/zero/1.0/.