1GIT-FAME(1) GIT-FAME(1)
2
3
4
6 git-fame - Pretty-print git repository collaborators sorted by contri‐
7 butions.
8
10 gitfame [--help | options] [<gitdir>...]
11
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
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
96 Casper da Costa-Luis <https://github.com/casperdcl>.
97
98
99
100git-fame User Manuals 2016-2018 GIT-FAME(1)