git-summary(1)

1GIT-SUMMARY(1)                    Git Extras                    GIT-SUMMARY(1)
2
3
4

NAME

6       git-summary - Show repository summary
7

SYNOPSIS

9       git-summary [--dedup-by-email] [--no-merges] [<committish>]
10
11       git-summary --line [<path>]
12

DESCRIPTION

14       Shows a summary of the repository or a path within it.
15

OPTIONS

17       <committish>
18
19       Summarize only the range of commits included in the <committish>.
20
21       <path>
22
23       Summarize only the range of files included in the <path>.
24
25       --dedup-by-email
26
27       Remove  duplicate authors who belong to the same email address. For ex‐
28       ample,
29
30
31           $ git summary
32           ...
33           133  TJ Holowaychuk            9.9%
34           115  Tj Holowaychuk            8.5%
35
36           $ git summary --dedup-by-email
37           ...
38           248  TJ Holowaychuk            18.4%
39
40
41
42       --no-merges
43
44       Exclude merge commits.
45
46       --line
47
48       Summarize with lines other than commits. When --line is specified,  the
49       last argument is treated as <path>.
50
51       This   option  can  not  be  used  together  with  --dedup-by-email  or
52       --no-merges.
53
54       --output-style <style>
55
56       Summarizes the repository and print the output according to the  speci‐
57       fied  style.  Styles:  *  tabular: Prints the summary in a tabular form
58       having a header in the first line and the values in the second.  Column
59       separator  is a | sorrounded by at least one space on each side. * one‐
60       line: Prints the summary in a single line. Fields are separated by a  /
61       sorrounded by one space on each side.
62
63       Some information like the authors cannot be displayed in this mode.
64

EXAMPLES

66       Outputs a repo summary:
67
68
69           $ git summary
70
71           project     : express
72           repo age    : 10 months ago
73           branch      : master
74           last active : 3 weeks ago
75           active on   : 93 days
76           commits     : 1893
77           files       : 111
78           uncommitted : 3
79           authors     :
80            1285 visionmedia
81             478 Tj Holowaychuk
82              48 Aaron Heckmann
83              34 csausdev
84              26 ciaranj
85               6 Guillermo Rauch
86               3 Nick Poulden
87               2 Brian McKinney
88               2 Benny Wong
89               1 Justin Lilly
90               1 James Herdman
91               1 Adam Sanderson
92               1 Viktor Kelemen
93               1 Gregory Ritter
94               1 Greg Ritter
95               1 ewoudj
96               1 isaacs
97               1 Matt Colyer
98
99
100
101       This  command  can also take a committish, and will print a summary for
102       the range of commits included in the committish:
103
104
105           $ git summary v42..
106
107
108
109       Outputs a repo summary by line:
110
111
112           $ git summary --line
113
114           project  : git-extras
115           lines    : 26820
116           authors  :
117             ...
118
119
120
121       Filter with the path:
122
123
124           $ git summary --line bin/
125
126           project  : git-extras
127           lines    : 4420
128           authors  :
129             ...
130
131
132
133       Tabular summary
134
135
136           $ git summary --output-style tabular
137           # Repo     | Age       | Last active | Active on | Commits | Uncommitted | Branch
138           git-extras | 13 years  | 7 hours ago | 807 days  | 1703    | 3           | master
139
140
141
142       Oneline summary
143
144
145           $ git summary --output-style oneline
146           git-extras / age: 13 years / last active: 7 hours ago / active on 807 days / commits: 1703 / uncommitted: 3 / branch: master
147
148
149

AUTHOR

151       Written by Tj Holowaychuk <tj@vision-media.ca>
152

REPORTING BUGS

154       <https://github.com/tj/git-extras/issues>
155