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       git-fame [--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       --loc=type
43              surv(iving)|ins(ertions)|del(etions)  What  loc represents.  Use
44              `ins,del' to count both.  defaults to `surviving' unless  --cost
45              is specified.
46
47       --excl=f
48              Excluded files (default: None).  In no-regex mode, may be a com‐
49              ma-separated list.  Escape (\,) for a literal comma (may require
50              \\, in shell).
51
52       --incl=f
53              Included files [default: .*].  See --excl for format.
54
55       --since=date
56              Date  from  which to check.  Can be absoulte (eg: 1970-01-31) or
57              relative to now (eg: 3.weeks).
58
59       --cost=method
60              Include time cost  in  person-months  (COCOMO)  or  person-hours
61              (based  on commit times).  Methods: month(s)|cocomo|hour(s)|com‐
62              mit(s).  May be multiple comma-separated values.   Alters  --loc
63              default to imply `ins' (COCOMO) or `ins,del' (hours).
64
65       -R, --recurse
66              Recursively find repositories & submodules within .
67
68       -n, --no-regex
69              Assume are comma-separated exact matches rather than regular ex‐
70              pressions [default: False].  NB: if  regex  is  enabled  `,'  is
71              equivalent to `|'.
72
73       -s, --silent-progress
74              Suppress tqdm [default: False].
75
76       --warn-binary
77              Don’t  silently  skip  files which appear to be binary data [de‐
78              fault: False].
79
80       -e, --show-email
81              Show author email instead of name [default: False].
82
83       --enum Show row numbers [default: False].
84
85       -t, --bytype
86              Show stats per file extension [default: False].
87
88       -w, --ignore-whitespace
89              Ignore whitespace when comparing the parent’s  version  and  the
90              child’s  to find where the lines came from [default: False].  -M
91              Detect intra-file line moves and copies  [default:  False].   -C
92              Detect inter-file line moves and copies [default: False].
93
94       --ignore-rev=rev
95              Ignore  changes  made by the given revision (requires --loc=sur‐
96              viving).
97
98       --ignore-revs-file=f
99              Ignore revisions listed in the given file  (requires  --loc=sur‐
100              viving).
101
102       --format=format
103              Table          format          [default:          pipe]|md|mark‐
104              down|yaml|yml|json|csv|tsv|tabulate.  May require git-fame[<for‐
105              mat>],  e.g. pip  install  git-fame[yaml].   Any  tabulate.tabu‐
106              late_formats is also accepted.
107
108       --manpath=path
109              Directory in which to install git-fame man pages.
110
111       --log=lvl
112              FATAL|CRITICAL|ERROR|WARN(ING)|[default: INFO]|DEBUG|NOTSET.
113

AUTHORS

115       Casper da Costa-Luis <https://github.com/casperdcl>.
116
117
118
119git-fame User Manuals              2016-2023                       GIT-FAME(1)
Impressum