Git2JSON¶

Convert git logs to JSON for easier analysis.

Free software: BSD license
Documentation: http://git2json.rtfd.org.

Installation¶

The easiest way to install git2json is through pip:

pip install git2json

If you want the most up-to-date version (at a greater risk of encountering bugs) you can clone this repository and install it manually:

git clone https://github.com/tarmstrong/git2json.git
cd git2json
python setup.py install

Usage¶

usage: git2json [-h] [--git-dir GIT_DIR]

optional arguments:
  -h, --help         show this help message and exit
  --git-dir GIT_DIR  Path to the .git/ directory of the repository you are
                    targeting

The resulting JSON log is printed to standard output.

Example JSON¶

The following shows the structure of the JSON emitted by the tool.

[{
    "committer": {
        "date": 1379903278,
        "timezone": "-0400",
        "name": "Tavish Armstrong",
        "email": "tavisharmstrong@gmail.com"
    },
    "parents": ["e307663594031738c932877c8589552d5aafc953"],
    "author": {
        "date": 1379903278,
        "timezone": "-0400",
        "name": "Tavish Armstrong",
        "email": "tavisharmstrong@gmail.com"
    },
    "tree": "bd03127651335e3a51241f507f3bf194d8336485",
    "commit": "d06454c160218b4a782afad2429abda1add54df0",
    "message": "Allow user to specify git-dir on the command line.",
    "changes": [
        [23, 3, "git2json/__init__.py"]
    ]
    },
    // ... More commits
    ]

Usage Examples¶

[How Long Does It Take To Review an IPython Pull Request?](http://nbviewer.ipython.org/urls/raw.github.com/tarmstrong/code-analysis/master/IPythonReviewTime.ipynb) by Tavish Armstrong (git2json author)

If you are using git2json in interesting ways, please share and I will add your notebooks/blog posts/code to this list.