Metadata-Version: 2.0
Name: git-fame
Version: 1.0.1
Summary: Pretty-print `git` repository collaborators sorted by contributions
Home-page: UNKNOWN
Author: Casper da Costa-Luis 
Author-email: casper@caspersci.uk.to
License: [MPLv2.0](https://mozilla.org/MPL/2.0/)
Keywords: git blame stat stats statistics count author commit commitslog shortlog ls-files
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Environment :: Console
Classifier: Framework :: IPython
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: IronPython
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Requires: tqdm
Provides: gitfame

gitfame
=======

Pretty-print ``git`` repository collaborators sorted by contributions.

.. code:: sh

    ~$ git fame
    Blame: 100%|███████████████████████████████████| 11/11 [00:00<00:00, 208.43it/s]
    Total commits: 30
    Total files: 17
    Total loc: 522
    +----------------------+------+------+------+----------------+
    | Author               |  loc | coms | fils |  distribution  |
    +======================+======+======+======+================+
    | Casper da Costa-Luis | 3123 |  297 |   35 | 99.6/98.3/85.4 |
    | Not Committed Yet    |    7 |    4 |    2 |  0.2/ 1.3/ 4.9 |
    | Nikolay Yakimov      |    4 |    1 |    1 |  0.1/ 0.3/ 2.4 |
    +----------------------+------+------+------+----------------+

------------------------------------------

.. contents:: Table of contents
   :backlinks: top
   :local:


Installation
------------

Latest pypi stable release
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: sh

    pip install git-fame

Latest development release on github
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Pull and install in the current directory:

.. code:: sh

    pip install -e git+https://github.com/casperdcl/git-fame.git@master#egg=gitfame

Register alias with git
~~~~~~~~~~~~~~~~~~~~~~~

.. code:: sh

    git config --global alias.co "!python -m gitfame"


Usage
-----

.. code:: sh

    ~$ git fame            # If alias registered with git (see above)
    ~$ python -m gitfame   # Alternative execution as python module


Documentation
-------------

Usage
~~~~~

.. code:: sh

        gitfame [--help | options] [<gitdir>]

    Options:
        -h, --help     Print this help and exit.
        -v, --version  Print module version and exit.
        --sort=<key>    Options: [default: loc], files, commits.
        --excl=<f>      Excluded files [default: None].
                        In no-regex mode, may be a comma-separated list.
                        Escape (\,) for a literal comma (may require \\, in shell).
        --incl=<f>      Included files [default: .*]. See `--excl` for format.
        -n, --no-regex  Assume <f> are comma-separated exact matches
                        rather than regular expressions [default: False].
                        NB: if regex is enabled `,` is equivalent to `|`.
        -s, --silent-progress    Suppress `tqdm` [default: False].
        -t, --bytype             Show stats per file extension [default: False].
        -w, --ignore-whitespace  Ignore whitespace when comparing the parent's
                                 version and the child's to find where the lines
                                 came from [default: False].
        -M              Detect intra-file line moves and copies [default: False].
        -C              Detect inter-file line moves and copies [default: False].

    Arguments:
        <gitdir>       Git directory [default: ./].


Licence
-------

OSI approved.

Copyright (c) 2016 Casper da Costa-Luis <casper@caspersci.uk.to>.

This Source Code Form is subject to the terms of the
Mozilla Public License, v. 2.0.
If a copy of the MPL was not distributed with this file, You can obtain one
at `https://mozilla.org/MPL/2.0/ <https://mozilla.org/MPL/2.0/>`__.


Authors
-------

- Casper da Costa-Luis <casper@caspersci.uk.to>


