https://github.com/suminb/gitstats

Generating overall statistics for multiple git repositories
https://github.com/suminb/gitstats

git python

Last synced: 3 months ago
JSON representation

Generating overall statistics for multiple git repositories

• Host: GitHub
• URL: https://github.com/suminb/gitstats
• Owner: suminb
• License: bsd-4-clause
• Created: 2013-06-16T12:28:34.000Z (over 11 years ago)
• Default Branch: develop
• Last Pushed: 2020-01-08T13:18:21.000Z (about 5 years ago)
• Last Synced: 2024-09-29T14:42:09.793Z (4 months ago)
• Topics: git, python
• Language: Python
• Size: 37.1 KB
• Stars: 20
• Watchers: 4
• Forks: 4
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
Gitstat

=======

.. image:: https://travis-ci.org/suminb/gitstats.svg?branch=develop

   :target: https://travis-ci.org/suminb/gitstats

.. image:: https://coveralls.io/repos/github/suminb/gitstats/badge.svg?branch=develop

   :target: https://coveralls.io/github/suminb/gitstats?branch=develop

Visualizes overall code commits for multiple Git repositories. The red

indicates my own commits whereas the blue indicates your teammates'.

.. image:: http://s1.postimg.org/mrnwnla3j/2014.png

Installation

============

.. code-block:: console

   pip install gitstats

Usage

=====

The following example shows how `gitstats` discovers all Git repositories

in the home directory to consolidate all commit logs.

Git Repository Analysis

~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: console

    gitstats analyze ~ > gitstats.json

The target directory may be a single repository.

.. code-block:: console

    gitstats analyze ~/work/project_x > gitstats.json

If you would like to exclude certain repositories, put a ``.exclude`` file in

each directory you want to exclude from the statistics. Note that the content

of the file is irrelevant.

Generating Commit Graphs

~~~~~~~~~~~~~~~~~~~~~~~~

`gitstats` generates annual commit graphs that are similar to what GitHub

shows on each user's page. However, the major difference is that `gitstats`

differentiates your commits from others based on your email address(es).

.. code-block:: console

    gitstats generate-graph gitstats.json 2017 --email ${your_email} > 2017.svg

If you have multiple email addresses, you may pass them as follows:

.. code-block:: console

    gitstats generate-graph gitstats.json 2017 --email ${your_email1} --email ${your_email2} > 2017.svg