GIT-FAME(1)

NAME

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

SYNOPSIS

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

DESCRIPTION

See <https://github.com/casperdcl/git-fame>.

Probably not necessary on UNIX systems:

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

For example, to print statistics regarding all source files in a C++/CUDA repository (*.c/h/t(pp), *.cu(h)), carefully handling whitespace and line copies:

    git fame --incl '\.[cht][puh]{0,2}$' -twMC

OPTIONS

<gitdir>
    [default: ./] optional arguments:

-h, --help
    show this help message and exit

--sort=key
    [default: loc]|commits|files|hours|months.

-t, --bytype
    Show stats per file extension [default: False].

--log=lvl
    FATAL|CRITICAL|ERROR|WARN(ING)|[default: INFO]|DEBUG|NOTSET.

--cost=method
    Include time cost in person-months (COCOMO) or person- hours (based on commit times). Methods: month(s)|cocomo|hour(s)|commit(s). May be multiple comma-separated values.

-w, --ignore-whitespace

                    Ignore whitespace when comparing the parent's version
                    and the child's to find where the lines came from
                    [default: False].

--incl=f
    Included files [default: .*]. See --excl for format.

--format=format
    Table format [default: pipe]|md|markdown|yaml|yml|json|csv|tsv|tabulate. May require git-fame[<format>], e.g. pip install git- fame[yaml]. Any tabulate.tabulate_formats is also accepted.

--branch=b
    Branch or tag [default: HEAD] up to which to check.

-C, -C
    Detect inter-file line moves and copies [default: False].

--since=date
    Date from which to check. Can be absoulte (eg: 1970-01-31) or relative to now (eg: 3.weeks).

-v, --version
    show program's version number and exit

-s, --silent-progress

                    Suppress `tqdm` [default: False].

    --warn-binary Don't silently skip files which appear to be binary data [default: False].

-M, -M
    Detect intra-file line moves and copies [default: False].

-n, --no-regex
    Assume are comma-separated exact matches rather than regular expressions [default: False]. NB: if regex is enabled , is equivalent to |.

--manpath=path
    Directory in which to install git-fame man pages.

--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).

AUTHORS
Casper da Costa-Luis <https://github.com/casperdcl>.