1GIT-FAME(1)                                                        GIT-FAME(1)
2
3
4

NAME

6       git-fame  - Pretty-print git repository collaborators sorted by contri‐
7       butions.
8

SYNOPSIS

10       gitfame [--help | options] [<gitdir>...]
11

DESCRIPTION

13       See <https://github.com/casperdcl/git-fame>.
14
15       Probably not necessary on UNIX systems:
16
17              git config --global alias.fame "!python -m gitfame"
18
19       For example, to print  statistics  regarding  all  source  files  in  a
20       C++/CUDA  repository  (*.c/h/t(pp), *.cu(h)), carefully handling white‐
21       space and line copies:
22
23              git fame --incl '\.[cht][puh]{0,2}$' -twMC
24

OPTIONS

26       <gitdir>
27              Git directory [default: ./].  May be specified multiple times to
28              aggregate across multiple repositories.
29
30       -h, --help
31              Print this help and exit.
32
33       -v, --version
34              Print module version and exit.
35
36       --branch=b
37              Branch or tag [default: HEAD] up to which to check.
38
39       --sort=key
40              [default: loc]|commits|files|hours|months.
41
42       --excl=f
43              Excluded files (default: None).  In no-regex mode, may be a com‐
44              ma-separated list.  Escape (\,) for a literal comma (may require
45              \\, in shell).
46
47       --incl=f
48              Included files [default: .*].  See --excl for format.
49
50       --since=date
51              Date  from  which to check.  Can be absoulte (eg: 1970-01-31) or
52              relative to now (eg: 3.weeks).
53
54       --cost=method
55              Include time cost  in  person-months  (COCOMO)  or  person-hours
56              (based  on commit times).  Methods: month(s)|cocomo|hour(s)|com‐
57              mit(s).  May be multiple comma-separated values.
58
59       -n, --no-regex
60              Assume are comma-separated exact matches rather than regular ex‐
61              pressions [default: False].  NB: if regex is enabled , is equiv‐
62              alent to |.
63
64       -s, --silent-progress
65              Suppress tqdm [default: False].
66
67       --warn-binary
68              Don't silently skip files which appear to be  binary  data  [de‐
69              fault: False].
70
71       -e, --show-email
72              Show author email instead of name [default: False].
73
74       -t, --bytype
75              Show stats per file extension [default: False].
76
77       -w, --ignore-whitespace
78              Ignore  whitespace  when  comparing the parent's version and the
79              child's to find where the lines came from [default: False].   -M
80              Detect  intra-file  line  moves and copies [default: False].  -C
81              Detect inter-file line moves and copies [default: False].
82
83       --format=format
84              Table          format          [default:          pipe]|md|mark‐
85              down|yaml|yml|json|csv|tsv|tabulate.  May require git-fame[<for‐
86              mat>],  e.g.   pip install git-fame[yaml].   Any  tabulate.tabu‐
87              late_formats is also accepted.
88
89       --manpath=path
90              Directory in which to install git-fame man pages.
91
92       --log=lvl
93              FATAL|CRITICAL|ERROR|WARN(ING)|[default: INFO]|DEBUG|NOTSET.
94

AUTHORS

96       Casper da Costa-Luis <https://github.com/casperdcl>.
97
98
99
100git-fame User Manuals              2016-2018                       GIT-FAME(1)
Impressum