2 # Copyright (c) 2007 Heikki Hokkanen <hoxu@users.sf.net>
13 GNUPLOT_COMMON
= 'set terminal png transparent\nset size 0.5,0.5\n'
15 def getoutput(cmd
, quiet
= False):
18 output
= commands
.getoutput(cmd
)
21 def getkeyssortedbyvalues(dict):
22 return map(lambda el
: el
[1], sorted(map(lambda el
: (el
[1], el
[0]), dict.items())))
24 # TODO getdictkeyssortedbyvaluekey(dict, key) - eg. dict['author'] = { 'commits' : 512 } - ...key(dict, 'commits')
27 """Manages data collection from a revision control repository."""
29 self
.stamp_created
= time
.time()
33 # This should be the main function to extract data from the repository.
34 def collect(self
, dir):
38 # : get a dictionary of author
39 def getAuthorInfo(self
, author
):
42 def getActivityByDayOfWeek(self
):
45 def getActivityByHourOfDay(self
):
49 # Get a list of authors
53 def getFirstCommitDate(self
):
54 return datetime
.datetime
.now()
56 def getLastCommitDate(self
):
57 return datetime
.datetime
.now()
59 def getStampCreated(self
):
60 return self
.stamp_created
65 def getTotalAuthors(self
):
68 def getTotalCommits(self
):
71 def getTotalFiles(self
):
74 def getTotalLOC(self
):
77 class GitDataCollector(DataCollector
):
78 def collect(self
, dir):
79 DataCollector
.collect(self
, dir)
81 self
.total_authors
= int(getoutput('git-log |git-shortlog -s |wc -l'))
82 self
.total_commits
= int(getoutput('git-rev-list HEAD |wc -l'))
83 self
.total_files
= int(getoutput('git-ls-files |wc -l'))
84 self
.total_lines
= int(getoutput('git-ls-files -z |xargs -0 cat |wc -l'))
86 self
.activity_by_hour_of_day
= {} # hour -> commits
87 self
.activity_by_day_of_week
= {} # day -> commits
88 self
.activity_by_month_of_year
= {} # month [1-12] -> commits
89 self
.activity_by_hour_of_week
= {} # weekday -> hour -> commits
91 self
.authors
= {} # name -> {commits, first_commit_stamp, last_commit_stamp}
94 self
.author_of_month
= {} # month -> author -> commits
95 self
.author_of_year
= {} # year -> author -> commits
96 self
.commits_by_month
= {} # month -> commits
97 self
.commits_by_year
= {} # year -> commits
98 self
.first_commit_stamp
= 0
99 self
.last_commit_stamp
= 0
103 lines
= getoutput('git-show-ref --tags').split('\n')
107 (hash, tag
) = line
.split(' ')
108 tag
= tag
.replace('refs/tags/', '')
109 output
= getoutput('git-log "%s" --pretty=format:"%%at %%an" -n 1' % hash)
111 parts
= output
.split(' ')
114 stamp
= int(parts
[0])
117 self
.tags
[tag
] = { 'stamp': stamp
, 'hash' : hash, 'date' : datetime
.datetime
.fromtimestamp(stamp
).strftime('%Y-%m-%d') }
120 # Collect revision statistics
121 # Outputs "<stamp> <author>"
122 lines
= getoutput('git-rev-list --pretty=format:"%at %an" HEAD |grep -v ^commit').split('\n')
124 # linux-2.6 says "<unknown>" for one line O_o
125 parts
= line
.split(' ')
128 stamp
= int(parts
[0])
132 author
= ' '.join(parts
[1:])
133 date
= datetime
.datetime
.fromtimestamp(float(stamp
))
135 # First and last commit stamp
136 if self
.last_commit_stamp
== 0:
137 self
.last_commit_stamp
= stamp
138 self
.first_commit_stamp
= stamp
143 if hour
in self
.activity_by_hour_of_day
:
144 self
.activity_by_hour_of_day
[hour
] += 1
146 self
.activity_by_hour_of_day
[hour
] = 1
150 if day
in self
.activity_by_day_of_week
:
151 self
.activity_by_day_of_week
[day
] += 1
153 self
.activity_by_day_of_week
[day
] = 1
156 if day
not in self
.activity_by_hour_of_week
:
157 self
.activity_by_hour_of_week
[day
] = {}
158 if hour
not in self
.activity_by_hour_of_week
[day
]:
159 self
.activity_by_hour_of_week
[day
][hour
] = 1
161 self
.activity_by_hour_of_week
[day
][hour
] += 1
165 if month
in self
.activity_by_month_of_year
:
166 self
.activity_by_month_of_year
[month
] += 1
168 self
.activity_by_month_of_year
[month
] = 1
171 if author
not in self
.authors
:
172 self
.authors
[author
] = {}
174 if 'last_commit_stamp' not in self
.authors
[author
]:
175 self
.authors
[author
]['last_commit_stamp'] = stamp
176 self
.authors
[author
]['first_commit_stamp'] = stamp
177 if 'commits' in self
.authors
[author
]:
178 self
.authors
[author
]['commits'] += 1
180 self
.authors
[author
]['commits'] = 1
182 # author of the month/year
183 yymm
= datetime
.datetime
.fromtimestamp(stamp
).strftime('%Y-%m')
184 if yymm
in self
.author_of_month
:
185 if author
in self
.author_of_month
[yymm
]:
186 self
.author_of_month
[yymm
][author
] += 1
188 self
.author_of_month
[yymm
][author
] = 1
190 self
.author_of_month
[yymm
] = {}
191 self
.author_of_month
[yymm
][author
] = 1
192 if yymm
in self
.commits_by_month
:
193 self
.commits_by_month
[yymm
] += 1
195 self
.commits_by_month
[yymm
] = 1
197 yy
= datetime
.datetime
.fromtimestamp(stamp
).year
198 if yy
in self
.author_of_year
:
199 if author
in self
.author_of_year
[yy
]:
200 self
.author_of_year
[yy
][author
] += 1
202 self
.author_of_year
[yy
][author
] = 1
204 self
.author_of_year
[yy
] = {}
205 self
.author_of_year
[yy
][author
] = 1
206 if yy
in self
.commits_by_year
:
207 self
.commits_by_year
[yy
] += 1
209 self
.commits_by_year
[yy
] = 1
211 # outputs "<stamp> <files>" for each revision
212 self
.files_by_stamp
= {} # stamp -> files
213 lines
= getoutput('git-rev-list --pretty=format:"%at %H" HEAD |grep -v ^commit |while read line; do set $line; echo "$1 $(git-ls-tree -r "$2" |wc -l)"; done').split('\n')
215 parts
= line
.split(' ')
218 (stamp
, files
) = parts
[0:2]
219 self
.files_by_stamp
[int(stamp
)] = int(files
)
222 self
.extensions
= {} # extension -> files, lines
223 lines
= getoutput('git-ls-files').split('\n')
225 base
= os
.path
.basename(line
)
226 if base
.find('.') == -1:
229 ext
= base
[(base
.rfind('.') + 1):]
231 if ext
not in self
.extensions
:
232 self
.extensions
[ext
] = {'files': 0, 'lines': 0}
234 self
.extensions
[ext
]['files'] += 1
236 self
.extensions
[ext
]['lines'] += int(getoutput('wc -l < %s' % line
, quiet
= True))
238 print 'Warning: Could not count lines for file "%s"' % line
240 def getActivityByDayOfWeek(self
):
241 return self
.activity_by_day_of_week
243 def getActivityByHourOfDay(self
):
244 return self
.activity_by_hour_of_day
246 def getAuthorInfo(self
, author
):
247 a
= self
.authors
[author
]
249 commits
= a
['commits']
250 commits_frac
= (100 * float(commits
)) / self
.getTotalCommits()
251 date_first
= datetime
.datetime
.fromtimestamp(a
['first_commit_stamp'])
252 date_last
= datetime
.datetime
.fromtimestamp(a
['last_commit_stamp'])
253 delta
= date_last
- date_first
255 res
= { 'commits': commits
, 'commits_frac': commits_frac
, 'date_first': date_first
.strftime('%Y-%m-%d'), 'date_last': date_last
.strftime('%Y-%m-%d'), 'timedelta' : delta
}
258 def getAuthors(self
):
259 return self
.authors
.keys()
261 def getFirstCommitDate(self
):
262 return datetime
.datetime
.fromtimestamp(self
.first_commit_stamp
)
264 def getLastCommitDate(self
):
265 return datetime
.datetime
.fromtimestamp(self
.last_commit_stamp
)
268 lines
= getoutput('git-show-ref --tags |cut -d/ -f3')
269 return lines
.split('\n')
271 def getTagDate(self
, tag
):
272 return self
.revToDate('tags/' + tag
)
274 def getTotalAuthors(self
):
275 return self
.total_authors
277 def getTotalCommits(self
):
278 return self
.total_commits
280 def getTotalFiles(self
):
281 return self
.total_files
283 def getTotalLOC(self
):
284 return self
.total_lines
286 def revToDate(self
, rev
):
287 stamp
= int(getoutput('git-log --pretty=format:%%at "%s" -n 1' % rev
))
288 return datetime
.datetime
.fromtimestamp(stamp
).strftime('%Y-%m-%d')
291 """Creates the actual report based on given data."""
295 def create(self
, data
, path
):
299 class HTMLReportCreator(ReportCreator
):
300 def create(self
, data
, path
):
301 ReportCreator
.create(self
, data
, path
)
303 # TODO copy the CSS if it does not exist
304 if not os
.path
.exists(path
+ '/gitstats.css'):
308 f
= open(path
+ "/index.html", 'w')
309 format
= '%Y-%m-%d %H:%m:%S'
312 f
.write('<h1>GitStats</h1>')
317 f
.write('<dt>Generated</dt><dd>%s (in %d seconds)</dd>' % (datetime
.datetime
.now().strftime(format
), time
.time() - data
.getStampCreated()));
318 f
.write('<dt>Report Period</dt><dd>%s to %s</dd>' % (data
.getFirstCommitDate().strftime(format
), data
.getLastCommitDate().strftime(format
)))
319 f
.write('<dt>Total Files</dt><dd>%s</dd>' % data
.getTotalFiles())
320 f
.write('<dt>Total Lines of Code</dt><dd>%s</dd>' % data
.getTotalLOC())
321 f
.write('<dt>Total Commits</dt><dd>%s</dd>' % data
.getTotalCommits())
322 f
.write('<dt>Authors</dt><dd>%s</dd>' % data
.getTotalAuthors())
325 f
.write('</body>\n</html>');
330 f
= open(path
+ '/activity.html', 'w')
332 f
.write('<h1>Activity</h1>')
335 f
.write('<h2>Last 30 days</h2>')
337 f
.write('<h2>Last 12 months</h2>')
340 f
.write('\n<h2>Hour of Day</h2>\n\n')
341 hour_of_day
= data
.getActivityByHourOfDay()
342 f
.write('<table><tr><th>Hour</th>')
343 for i
in range(1, 25):
344 f
.write('<th>%d</th>' % i
)
345 f
.write('</tr>\n<tr><th>Commits</th>')
346 fp
= open(path
+ '/hour_of_day.dat', 'w')
347 for i
in range(0, 24):
349 f
.write('<td>%d</td>' % hour_of_day
[i
])
350 fp
.write('%d %d\n' % (i
, hour_of_day
[i
]))
352 f
.write('<td>0</td>')
353 fp
.write('%d 0\n' % i
)
355 f
.write('</tr>\n<tr><th>%</th>')
356 totalcommits
= data
.getTotalCommits()
357 for i
in range(0, 24):
359 f
.write('<td>%.2f</td>' % ((100.0 * hour_of_day
[i
]) / totalcommits
))
361 f
.write('<td>0.00</td>')
362 f
.write('</tr></table>')
363 f
.write('<img src="hour_of_day.png" alt="Hour of Day" />')
364 fg
= open(path
+ '/hour_of_day.dat', 'w')
365 for i
in range(0, 24):
367 fg
.write('%d %d\n' % (i
+ 1, hour_of_day
[i
]))
369 fg
.write('%d 0\n' % (i
+ 1))
373 f
.write('\n<h2>Day of Week</h2>\n\n')
374 day_of_week
= data
.getActivityByDayOfWeek()
375 f
.write('<div class="vtable"><table>')
376 f
.write('<tr><th>Day</th><th>Total (%)</th></tr>')
377 fp
= open(path
+ '/day_of_week.dat', 'w')
378 for d
in range(0, 7):
379 fp
.write('%d %d\n' % (d
+ 1, day_of_week
[d
]))
381 f
.write('<th>%d</th>' % (d
+ 1))
383 f
.write('<td>%d (%.2f%%)</td>' % (day_of_week
[d
], (100.0 * day_of_week
[d
]) / totalcommits
))
385 f
.write('<td>0</td>')
387 f
.write('</table></div>')
388 f
.write('<img src="day_of_week.png" alt="Day of Week" />')
392 f
.write('\n<h2>Hour of Week</h2>\n\n')
395 f
.write('<tr><th>Weekday</th>')
396 for hour
in range(0, 24):
397 f
.write('<th>%d</th>' % (hour
+ 1))
400 for weekday
in range(0, 7):
401 f
.write('<tr><th>%d</th>' % (weekday
+ 1))
402 for hour
in range(0, 24):
404 commits
= data
.activity_by_hour_of_week
[weekday
][hour
]
408 f
.write('<td>%d</td>' % commits
)
416 f
.write('\n<h2>Month of Year</h2>\n\n')
417 f
.write('<div class="vtable"><table>')
418 f
.write('<tr><th>Month</th><th>Commits (%)</th></tr>')
419 fp
= open (path
+ '/month_of_year.dat', 'w')
420 for mm
in range(1, 13):
422 if mm
in data
.activity_by_month_of_year
:
423 commits
= data
.activity_by_month_of_year
[mm
]
424 f
.write('<tr><td>%d</td><td>%d (%.2f %%)</td></tr>' % (mm
, commits
, (100.0 * commits
) / data
.getTotalCommits()))
425 fp
.write('%d %d\n' % (mm
, commits
))
427 f
.write('</table></div>')
428 f
.write('<img src="month_of_year.png" alt="Month of Year" />')
430 # Commits by year/month
431 f
.write('<h2>Commits by year/month</h2>')
432 f
.write('<div class="vtable"><table><tr><th>Month</th><th>Commits</th></tr>')
433 for yymm
in reversed(sorted(data
.commits_by_month
.keys())):
434 f
.write('<tr><td>%s</td><td>%d</td></tr>' % (yymm
, data
.commits_by_month
[yymm
]))
435 f
.write('</table></div>')
436 f
.write('<img src="commits_by_year_month.png" alt="Commits by year/month" />')
437 fg
= open(path
+ '/commits_by_year_month.dat', 'w')
438 for yymm
in sorted(data
.commits_by_month
.keys()):
439 fg
.write('%s %s\n' % (yymm
, data
.commits_by_month
[yymm
]))
443 f
.write('<h2>Commits by year</h2>')
444 f
.write('<div class="vtable"><table><tr><th>Year</th><th>Commits (% of all)</th></tr>')
445 for yy
in reversed(sorted(data
.commits_by_year
.keys())):
446 f
.write('<tr><td>%s</td><td>%d (%.2f%%)</td></tr>' % (yy
, data
.commits_by_year
[yy
], (100.0 * data
.commits_by_year
[yy
]) / data
.getTotalCommits()))
447 f
.write('</table></div>')
448 f
.write('<img src="commits_by_year.png" alt="Commits by Year" />')
449 fg
= open(path
+ '/commits_by_year.dat', 'w')
450 for yy
in sorted(data
.commits_by_year
.keys()):
451 fg
.write('%d %d\n' % (yy
, data
.commits_by_year
[yy
]))
454 f
.write('</body></html>')
459 f
= open(path
+ '/authors.html', 'w')
462 f
.write('<h1>Authors</h1>')
465 # Authors :: List of authors
466 f
.write('\n<h2>List of authors</h2>\n\n')
468 f
.write('<table class="authors">')
469 f
.write('<tr><th>Author</th><th>Commits (%)</th><th>First commit</th><th>Last commit</th><th>Age</th></tr>')
470 for author
in sorted(data
.getAuthors()):
471 info
= data
.getAuthorInfo(author
)
472 f
.write('<tr><td>%s</td><td>%d (%.2f%%)</td><td>%s</td><td>%s</td><td>%s</td></tr>' % (author
, info
['commits'], info
['commits_frac'], info
['date_first'], info
['date_last'], info
['timedelta']))
475 # Authors :: Author of Month
476 f
.write('\n<h2>Author of Month</h2>\n\n')
478 f
.write('<tr><th>Month</th><th>Author</th><th>Commits (%)</th></tr>')
479 for yymm
in reversed(sorted(data
.author_of_month
.keys())):
480 authordict
= data
.author_of_month
[yymm
]
481 authors
= getkeyssortedbyvalues(authordict
)
483 commits
= data
.author_of_month
[yymm
][authors
[0]]
484 f
.write('<tr><td>%s</td><td>%s</td><td>%d (%.2f%% of %d)</td></tr>' % (yymm
, authors
[0], commits
, (100 * commits
) / data
.commits_by_month
[yymm
], data
.commits_by_month
[yymm
]))
488 f
.write('\n<h2>Author of Year</h2>\n\n')
489 f
.write('<table><tr><th>Year</th><th>Author</th><th>Commits (%)</th></tr>')
490 for yy
in reversed(sorted(data
.author_of_year
.keys())):
491 authordict
= data
.author_of_year
[yy
]
492 authors
= getkeyssortedbyvalues(authordict
)
494 commits
= data
.author_of_year
[yy
][authors
[0]]
495 f
.write('<tr><td>%s</td><td>%s</td><td>%d (%.2f%% of %d)</td></tr>' % (yy
, authors
[0], commits
, (100 * commits
) / data
.commits_by_year
[yy
], data
.commits_by_year
[yy
]))
498 f
.write('</body></html>')
503 f
= open(path
+ '/files.html', 'w')
505 f
.write('<h1>Files</h1>')
509 f
.write('<dt>Total files</dt><dd>%d</dd>' % data
.getTotalFiles())
510 f
.write('<dt>Total lines</dt><dd>%d</dd>' % data
.getTotalLOC())
511 f
.write('<dt>Average file size</dt><dd>%.2f bytes</dd>' % ((100.0 * data
.getTotalLOC()) / data
.getTotalFiles()))
514 # Files :: File count by date
515 f
.write('<h2>File count by date</h2>')
517 fg
= open(path
+ '/files_by_date.dat', 'w')
518 for stamp
in sorted(data
.files_by_stamp
.keys()):
519 fg
.write('%s %d\n' % (datetime
.datetime
.fromtimestamp(stamp
).strftime('%Y-%m-%d'), data
.files_by_stamp
[stamp
]))
522 f
.write('<img src="files_by_date.png" alt="Files by Date" />')
524 #f.write('<h2>Average file size by date</h2>')
526 # Files :: Extensions
527 f
.write('\n<h2>Extensions</h2>\n\n')
528 f
.write('<table><tr><th>Extension</th><th>Files (%)</th><th>Lines (%)</th><th>Lines/file</th></tr>')
529 for ext
in sorted(data
.extensions
.keys()):
530 files
= data
.extensions
[ext
]['files']
531 lines
= data
.extensions
[ext
]['lines']
532 f
.write('<tr><td>%s</td><td>%d (%.2f%%)</td><td>%d (%.2f%%)</td><td>%d</td></tr>' % (ext
, files
, (100.0 * files
) / data
.getTotalFiles(), lines
, (100.0 * lines
) / data
.getTotalLOC(), lines
/ files
))
535 f
.write('</body></html>')
540 f
= open(path
+ '/lines.html', 'w')
542 f
.write('<h1>Lines</h1>')
546 f
.write('<dt>Total lines</dt><dd>%d</dd>' % data
.getTotalLOC())
549 f
.write('</body></html>')
554 f
= open(path
+ '/tags.html', 'w')
556 f
.write('<h1>Tags</h1>')
560 f
.write('<dt>Total tags</dt><dd>%d</dd>' % len(data
.tags
))
561 if len(data
.tags
) > 0:
562 f
.write('<dt>Average commits per tag</dt><dd>%.2f</dd>' % (data
.getTotalCommits() / len(data
.tags
)))
566 f
.write('<tr><th>Name</th><th>Date</th></tr>')
567 # sort the tags by date desc
568 tags_sorted_by_date_desc
= map(lambda el
: el
[1], reversed(sorted(map(lambda el
: (el
[1]['date'], el
[0]), data
.tags
.items()))))
569 for tag
in tags_sorted_by_date_desc
:
570 f
.write('<tr><td>%s</td><td>%s</td></tr>' % (tag
, data
.tags
[tag
]['date']))
573 f
.write('</body></html>')
576 self
.createGraphs(path
)
579 def createGraphs(self
, path
):
580 print 'Generating graphs...'
583 f
= open(path
+ '/hour_of_day.plot', 'w')
584 f
.write(GNUPLOT_COMMON
)
587 set output 'hour_of_day.png'
589 set xrange [0.5:24.5]
592 plot 'hour_of_day.dat' using 1:2:(0.5) w boxes fs solid
597 f
= open(path
+ '/day_of_week.plot', 'w')
598 f
.write(GNUPLOT_COMMON
)
601 set output 'day_of_week.png'
606 plot 'day_of_week.dat' using 1:2:(0.5) w boxes fs solid
611 f
= open(path
+ '/month_of_year.plot', 'w')
612 f
.write(GNUPLOT_COMMON
)
615 set output 'month_of_year.png'
617 set xrange [0.5:12.5]
620 plot 'month_of_year.dat' using 1:2:(0.5) w boxes fs solid
624 # commits_by_year_month
625 f
= open(path
+ '/commits_by_year_month.plot', 'w')
626 f
.write(GNUPLOT_COMMON
)
629 set output 'commits_by_year_month.png'
634 set xtics rotate by 90 15768000
636 plot 'commits_by_year_month.dat' using 1:2:(0.5) w boxes fs solid
641 f
= open(path
+ '/commits_by_year.plot', 'w')
642 f
.write(GNUPLOT_COMMON
)
645 set output 'commits_by_year.png'
649 plot 'commits_by_year.dat' using 1:2:(0.5) w boxes fs solid
654 f
= open(path
+ '/files_by_date.plot', 'w')
655 f
.write(GNUPLOT_COMMON
)
658 set output 'files_by_date.png'
661 set timefmt "%Y-%m-%d"
662 set format x "%Y-%m-%d"
664 set xtics rotate by 90
665 plot 'files_by_date.dat' using 1:2 smooth csplines
670 files
= glob
.glob(path
+ '/*.plot')
672 print '>> gnuplot %s' % os
.path
.basename(f
)
673 os
.system('gnuplot %s' % f
)
675 def printHeader(self
, f
):
677 """<?xml version="1.0" encoding="UTF-8"?>
678 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
679 <html xmlns="http://www.w3.org/1999/xhtml">
681 <title>GitStats</title>
682 <link rel="stylesheet" href="gitstats.css" type="text/css" />
683 <meta name="generator" content="GitStats" />
688 def printNav(self
, f
):
692 <li><a href="index.html">General</a></li>
693 <li><a href="activity.html">Activity</a></li>
694 <li><a href="authors.html">Authors</a></li>
695 <li><a href="files.html">Files</a></li>
696 <li><a href="lines.html">Lines</a></li>
697 <li><a href="tags.html">Tags</a></li>
704 Usage: gitstats [options] <gitpath> <outputpath>
709 if len(sys
.argv
) < 3:
713 gitpath
= sys
.argv
[1]
714 outputpath
= os
.path
.abspath(sys
.argv
[2])
717 os
.makedirs(outputpath
)
720 if not os
.path
.isdir(outputpath
):
721 print 'FATAL: Output path is not a directory or does not exist'
724 print 'Git path: %s' % gitpath
725 print 'Output path: %s' % outputpath
729 print 'Collecting data...'
730 data
= GitDataCollector()
731 data
.collect(gitpath
)
733 print 'Generating report...'
734 report
= HTMLReportCreator()
735 report
.create(data
, outputpath
)