gitstats

   1 #!/usr/bin/env python
   2 # Copyright (c) 2007-2009 Heikki Hokkanen <hoxu@users.sf.net> & others (see doc/author.txt)
   3 # GPLv2 / GPLv3
   4 import datetime
   5 import glob
   6 import os
   7 import pickle
   8 import re
   9 import shutil
  10 import subprocess
  11 import sys
  12 import time
  13 import zlib
  14
  15 GNUPLOT_COMMON = 'set terminal png transparent\nset size 0.5,0.5\n'
  16 MAX_EXT_LENGTH = 10 # maximum file extension length
  17
  18 exectime_internal = 0.0
  19 exectime_external = 0.0
  20 time_start = time.time()
  21
  22 # By default, gnuplot is searched from path, but can be overridden with the
  23 # environment variable "GNUPLOT"
  24 gnuplot_cmd = 'gnuplot'
  25 if 'GNUPLOT' in os.environ:
  26         gnuplot_cmd = os.environ['GNUPLOT']
  27
  28 def getpipeoutput(cmds, quiet = False):
  29         global exectime_external
  30         start = time.time()
  31         if not quiet:
  32                 print '>> ' + ' | '.join(cmds),
  33                 sys.stdout.flush()
  34         p0 = subprocess.Popen(cmds[0], stdout = subprocess.PIPE, shell = True)
  35         p = p0
  36         for x in cmds[1:]:
  37                 p = subprocess.Popen(x, stdin = p0.stdout, stdout = subprocess.PIPE, shell = True)
  38                 p0 = p
  39         output = p.communicate()[0]
  40         end = time.time()
  41         if not quiet:
  42                 print '\r[%.5f] >> %s' % (end - start, ' | '.join(cmds))
  43         exectime_external += (end - start)
  44         return output.rstrip('\n')
  45
  46 def getkeyssortedbyvalues(dict):
  47         return map(lambda el : el[1], sorted(map(lambda el : (el[1], el[0]), dict.items())))
  48
  49 # dict['author'] = { 'commits': 512 } - ...key(dict, 'commits')
  50 def getkeyssortedbyvaluekey(d, key):
  51         return map(lambda el : el[1], sorted(map(lambda el : (d[el][key], el), d.keys())))
  52
  53 VERSION = 0
  54 def getversion():
  55         global VERSION
  56         if VERSION == 0:
  57                 VERSION = getpipeoutput(["git rev-parse --short HEAD"]).split('\n')[0]
  58         return VERSION
  59
  60 class DataCollector:
  61         """Manages data collection from a revision control repository."""
  62         def __init__(self):
  63                 self.stamp_created = time.time()
  64                 self.cache = {}
  65
  66         ##
  67         # This should be the main function to extract data from the repository.
  68         def collect(self, dir):
  69                 self.dir = dir
  70                 self.projectname = os.path.basename(os.path.abspath(dir))
  71
  72         ##
  73         # Load cacheable data
  74         def loadCache(self, cachefile):
  75                 if not os.path.exists(cachefile):
  76                         return
  77                 print 'Loading cache...'
  78                 f = open(cachefile)
  79                 try:
  80                         self.cache = pickle.loads(zlib.decompress(f.read()))
  81                 except:
  82                         # temporary hack to upgrade non-compressed caches
  83                         f.seek(0)
  84                         self.cache = pickle.load(f)
  85                 f.close()
  86
  87         ##
  88         # Produce any additional statistics from the extracted data.
  89         def refine(self):
  90                 pass
  91
  92         ##
  93         # : get a dictionary of author
  94         def getAuthorInfo(self, author):
  95                 return None
  96
  97         def getActivityByDayOfWeek(self):
  98                 return {}
  99
 100         def getActivityByHourOfDay(self):
 101                 return {}
 102
 103         ##
 104         # Get a list of authors
 105         def getAuthors(self):
 106                 return []
 107
 108         def getFirstCommitDate(self):
 109                 return datetime.datetime.now()
 110
 111         def getLastCommitDate(self):
 112                 return datetime.datetime.now()
 113
 114         def getStampCreated(self):
 115                 return self.stamp_created
 116
 117         def getTags(self):
 118                 return []
 119
 120         def getTotalAuthors(self):
 121                 return -1
 122
 123         def getTotalCommits(self):
 124                 return -1
 125
 126         def getTotalFiles(self):
 127                 return -1
 128
 129         def getTotalLOC(self):
 130                 return -1
 131
 132         ##
 133         # Save cacheable data
 134         def saveCache(self, filename):
 135                 print 'Saving cache...'
 136                 f = open(cachefile, 'w')
 137                 #pickle.dump(self.cache, f)
 138                 data = zlib.compress(pickle.dumps(self.cache))
 139                 f.write(data)
 140                 f.close()
 141
 142 class GitDataCollector(DataCollector):
 143         def collect(self, dir):
 144                 DataCollector.collect(self, dir)
 145
 146                 try:
 147                         self.total_authors = int(getpipeoutput(['git log', 'git shortlog -s', 'wc -l']))
 148                 except:
 149                         self.total_authors = 0
 150                 #self.total_lines = int(getoutput('git-ls-files -z |xargs -0 cat |wc -l'))
 151
 152                 self.activity_by_hour_of_day = {} # hour -> commits
 153                 self.activity_by_day_of_week = {} # day -> commits
 154                 self.activity_by_month_of_year = {} # month [1-12] -> commits
 155                 self.activity_by_hour_of_week = {} # weekday -> hour -> commits
 156                 self.activity_by_hour_of_day_busiest = 0
 157                 self.activity_by_hour_of_week_busiest = 0
 158
 159                 self.authors = {} # name -> {commits, first_commit_stamp, last_commit_stamp}
 160
 161                 # author of the month
 162                 self.author_of_month = {} # month -> author -> commits
 163                 self.author_of_year = {} # year -> author -> commits
 164                 self.commits_by_month = {} # month -> commits
 165                 self.commits_by_year = {} # year -> commits
 166                 self.first_commit_stamp = 0
 167                 self.last_commit_stamp = 0
 168
 169                 # tags
 170                 self.tags = {}
 171                 lines = getpipeoutput(['git show-ref --tags']).split('\n')
 172                 for line in lines:
 173                         if len(line) == 0:
 174                                 continue
 175                         (hash, tag) = line.split(' ')
 176
 177                         tag = tag.replace('refs/tags/', '')
 178                         output = getpipeoutput(['git log "%s" --pretty=format:"%%at %%an" -n 1' % hash])
 179                         if len(output) > 0:
 180                                 parts = output.split(' ')
 181                                 stamp = 0
 182                                 try:
 183                                         stamp = int(parts[0])
 184                                 except ValueError:
 185                                         stamp = 0
 186                                 self.tags[tag] = { 'stamp': stamp, 'hash' : hash, 'date' : datetime.datetime.fromtimestamp(stamp).strftime('%Y-%m-%d') }
 187
 188                 # Collect revision statistics
 189                 # Outputs "<stamp> <author>"
 190                 lines = getpipeoutput(['git rev-list --pretty=format:"%at %an" HEAD', 'grep -v ^commit']).split('\n')
 191                 for line in lines:
 192                         # linux-2.6 says "<unknown>" for one line O_o
 193                         parts = line.split(' ')
 194                         author = ''
 195                         try:
 196                                 stamp = int(parts[0])
 197                         except ValueError:
 198                                 stamp = 0
 199                         if len(parts) > 1:
 200                                 author = ' '.join(parts[1:])
 201                         date = datetime.datetime.fromtimestamp(float(stamp))
 202
 203                         # First and last commit stamp
 204                         if self.last_commit_stamp == 0:
 205                                 self.last_commit_stamp = stamp
 206                         self.first_commit_stamp = stamp
 207
 208                         # activity
 209                         # hour
 210                         hour = date.hour
 211                         if hour in self.activity_by_hour_of_day:
 212                                 self.activity_by_hour_of_day[hour] += 1
 213                         else:
 214                                 self.activity_by_hour_of_day[hour] = 1
 215                         # most active hour?
 216                         if self.activity_by_hour_of_day[hour] > self.activity_by_hour_of_day_busiest:
 217                                 self.activity_by_hour_of_day_busiest = self.activity_by_hour_of_day[hour]
 218
 219                         # day of week
 220                         day = date.weekday()
 221                         if day in self.activity_by_day_of_week:
 222                                 self.activity_by_day_of_week[day] += 1
 223                         else:
 224                                 self.activity_by_day_of_week[day] = 1
 225
 226                         # hour of week
 227                         if day not in self.activity_by_hour_of_week:
 228                                 self.activity_by_hour_of_week[day] = {}
 229                         if hour not in self.activity_by_hour_of_week[day]:
 230                                 self.activity_by_hour_of_week[day][hour] = 1
 231                         else:
 232                                 self.activity_by_hour_of_week[day][hour] += 1
 233                         # most active hour?
 234                         if self.activity_by_hour_of_week[day][hour] > self.activity_by_hour_of_week_busiest:
 235                                 self.activity_by_hour_of_week_busiest = self.activity_by_hour_of_week[day][hour]
 236
 237                         # month of year
 238                         month = date.month
 239                         if month in self.activity_by_month_of_year:
 240                                 self.activity_by_month_of_year[month] += 1
 241                         else:
 242                                 self.activity_by_month_of_year[month] = 1
 243
 244                         # author stats
 245                         if author not in self.authors:
 246                                 self.authors[author] = {}
 247                         # commits
 248                         if 'last_commit_stamp' not in self.authors[author]:
 249                                 self.authors[author]['last_commit_stamp'] = stamp
 250                         self.authors[author]['first_commit_stamp'] = stamp
 251                         if 'commits' in self.authors[author]:
 252                                 self.authors[author]['commits'] += 1
 253                         else:
 254                                 self.authors[author]['commits'] = 1
 255
 256                         # author of the month/year
 257                         yymm = datetime.datetime.fromtimestamp(stamp).strftime('%Y-%m')
 258                         if yymm in self.author_of_month:
 259                                 if author in self.author_of_month[yymm]:
 260                                         self.author_of_month[yymm][author] += 1
 261                                 else:
 262                                         self.author_of_month[yymm][author] = 1
 263                         else:
 264                                 self.author_of_month[yymm] = {}
 265                                 self.author_of_month[yymm][author] = 1
 266                         if yymm in self.commits_by_month:
 267                                 self.commits_by_month[yymm] += 1
 268                         else:
 269                                 self.commits_by_month[yymm] = 1
 270
 271                         yy = datetime.datetime.fromtimestamp(stamp).year
 272                         if yy in self.author_of_year:
 273                                 if author in self.author_of_year[yy]:
 274                                         self.author_of_year[yy][author] += 1
 275                                 else:
 276                                         self.author_of_year[yy][author] = 1
 277                         else:
 278                                 self.author_of_year[yy] = {}
 279                                 self.author_of_year[yy][author] = 1
 280                         if yy in self.commits_by_year:
 281                                 self.commits_by_year[yy] += 1
 282                         else:
 283                                 self.commits_by_year[yy] = 1
 284
 285                 # TODO Optimize this, it's the worst bottleneck
 286                 # outputs "<stamp> <files>" for each revision
 287                 self.files_by_stamp = {} # stamp -> files
 288                 revlines = getpipeoutput(['git rev-list --pretty=format:"%at %T" HEAD', 'grep -v ^commit']).strip().split('\n')
 289                 lines = []
 290                 for revline in revlines:
 291                         time, rev = revline.split(' ')
 292                         #linecount = int(getpipeoutput(['git-ls-tree -r --name-only "%s"' % rev, 'wc -l']).split('\n')[0])
 293                         linecount = self.getFilesInCommit(rev)
 294                         lines.append('%d %d' % (int(time), linecount))
 295
 296                 self.total_commits = len(lines)
 297                 for line in lines:
 298                         parts = line.split(' ')
 299                         if len(parts) != 2:
 300                                 continue
 301                         (stamp, files) = parts[0:2]
 302                         try:
 303                                 self.files_by_stamp[int(stamp)] = int(files)
 304                         except ValueError:
 305                                 print 'Warning: failed to parse line "%s"' % line
 306
 307                 # extensions
 308                 self.extensions = {} # extension -> files, lines
 309                 lines = getpipeoutput(['git ls-files']).split('\n')
 310                 self.total_files = len(lines)
 311                 for line in lines:
 312                         base = os.path.basename(line)
 313                         # Ignore extensionless (including .hidden files)
 314                         if base.find('.') == -1 or base.rfind('.') == 0:
 315                                 ext = ''
 316                         else:
 317                                 ext = base[(base.rfind('.') + 1):]
 318                         if len(ext) > MAX_EXT_LENGTH:
 319                                 ext = ''
 320
 321                         if ext not in self.extensions:
 322                                 self.extensions[ext] = {'files': 0, 'lines': 0}
 323
 324                         self.extensions[ext]['files'] += 1
 325                         try:
 326                                 # Escaping could probably be improved here
 327                                 self.extensions[ext]['lines'] += int(getpipeoutput(['wc -l "%s"' % line]).split()[0])
 328                         except:
 329                                 print 'Warning: Could not count lines for file "%s"' % line
 330
 331                 # line statistics
 332                 # outputs:
 333                 #  N files changed, N insertions (+), N deletions(-)
 334                 # <stamp> <author>
 335                 self.changes_by_date = {} # stamp -> { files, ins, del }
 336                 lines = getpipeoutput(['git log --shortstat --pretty=format:"%at %an"']).split('\n')
 337                 lines.reverse()
 338                 files = 0; inserted = 0; deleted = 0; total_lines = 0
 339                 for line in lines:
 340                         if len(line) == 0:
 341                                 continue
 342
 343                         # <stamp> <author>
 344                         if line.find('files changed,') == -1:
 345                                 pos = line.find(' ')
 346                                 if pos != -1:
 347                                         try:
 348                                                 (stamp, author) = (int(line[:pos]), line[pos+1:])
 349                                                 self.changes_by_date[stamp] = { 'files': files, 'ins': inserted, 'del': deleted, 'lines': total_lines }
 350                                         except ValueError:
 351                                                 print 'Warning: unexpected line "%s"' % line
 352                                 else:
 353                                         print 'Warning: unexpected line "%s"' % line
 354                         else:
 355                                 numbers = re.findall('\d+', line)
 356                                 if len(numbers) == 3:
 357                                         (files, inserted, deleted) = map(lambda el : int(el), numbers)
 358                                         total_lines += inserted
 359                                         total_lines -= deleted
 360                                 else:
 361                                         print 'Warning: failed to handle line "%s"' % line
 362                                         (files, inserted, deleted) = (0, 0, 0)
 363                                 #self.changes_by_date[stamp] = { 'files': files, 'ins': inserted, 'del': deleted }
 364                 self.total_lines = total_lines
 365
 366         def refine(self):
 367                 # authors
 368                 # name -> {place_by_commits, commits_frac, date_first, date_last, timedelta}
 369                 authors_by_commits = getkeyssortedbyvaluekey(self.authors, 'commits')
 370                 authors_by_commits.reverse() # most first
 371                 for i, name in enumerate(authors_by_commits):
 372                         self.authors[name]['place_by_commits'] = i + 1
 373
 374                 for name in self.authors.keys():
 375                         a = self.authors[name]
 376                         a['commits_frac'] = (100 * float(a['commits'])) / self.getTotalCommits()
 377                         date_first = datetime.datetime.fromtimestamp(a['first_commit_stamp'])
 378                         date_last = datetime.datetime.fromtimestamp(a['last_commit_stamp'])
 379                         delta = date_last - date_first
 380                         a['date_first'] = date_first.strftime('%Y-%m-%d')
 381                         a['date_last'] = date_last.strftime('%Y-%m-%d')
 382                         a['timedelta'] = delta
 383
 384         def getActivityByDayOfWeek(self):
 385                 return self.activity_by_day_of_week
 386
 387         def getActivityByHourOfDay(self):
 388                 return self.activity_by_hour_of_day
 389
 390         def getAuthorInfo(self, author):
 391                 return self.authors[author]
 392
 393         def getAuthors(self):
 394                 return self.authors.keys()
 395
 396         def getFilesInCommit(self, rev):
 397                 try:
 398                         res = self.cache['files_in_tree'][rev]
 399                 except:
 400                         res = int(getpipeoutput(['git ls-tree -r --name-only "%s"' % rev, 'wc -l']).split('\n')[0])
 401                         if 'files_in_tree' not in self.cache:
 402                                 self.cache['files_in_tree'] = {}
 403                         self.cache['files_in_tree'][rev] = res
 404
 405                 return res
 406
 407         def getFirstCommitDate(self):
 408                 return datetime.datetime.fromtimestamp(self.first_commit_stamp)
 409
 410         def getLastCommitDate(self):
 411                 return datetime.datetime.fromtimestamp(self.last_commit_stamp)
 412
 413         def getTags(self):
 414                 lines = getpipeoutput(['git show-ref --tags', 'cut -d/ -f3'])
 415                 return lines.split('\n')
 416
 417         def getTagDate(self, tag):
 418                 return self.revToDate('tags/' + tag)
 419
 420         def getTotalAuthors(self):
 421                 return self.total_authors
 422
 423         def getTotalCommits(self):
 424                 return self.total_commits
 425
 426         def getTotalFiles(self):
 427                 return self.total_files
 428
 429         def getTotalLOC(self):
 430                 return self.total_lines
 431
 432         def revToDate(self, rev):
 433                 stamp = int(getpipeoutput(['git log --pretty=format:%%at "%s" -n 1' % rev]))
 434                 return datetime.datetime.fromtimestamp(stamp).strftime('%Y-%m-%d')
 435
 436 class ReportCreator:
 437         """Creates the actual report based on given data."""
 438         def __init__(self):
 439                 pass
 440
 441         def create(self, data, path):
 442                 self.data = data
 443                 self.path = path
 444
 445 def html_linkify(text):
 446         return text.lower().replace(' ', '_')
 447
 448 def html_header(level, text):
 449         name = html_linkify(text)
 450         return '\n<h%d><a href="#%s" name="%s">%s</a></h%d>\n\n' % (level, name, name, text, level)
 451
 452 class HTMLReportCreator(ReportCreator):
 453         def create(self, data, path):
 454                 ReportCreator.create(self, data, path)
 455                 self.title = data.projectname
 456
 457                 # copy static files if they do not exist
 458                 for file in ('gitstats.css', 'sortable.js', 'arrow-up.gif', 'arrow-down.gif', 'arrow-none.gif'):
 459                         basedir = os.path.dirname(os.path.abspath(__file__))
 460                         shutil.copyfile(basedir + '/' + file, path + '/' + file)
 461
 462                 f = open(path + "/index.html", 'w')
 463                 format = '%Y-%m-%d %H:%m:%S'
 464                 self.printHeader(f)
 465
 466                 f.write('<h1>GitStats - %s</h1>' % data.projectname)
 467
 468                 self.printNav(f)
 469
 470                 f.write('<dl>')
 471                 f.write('<dt>Project name</dt><dd>%s</dd>' % (data.projectname))
 472                 f.write('<dt>Generated</dt><dd>%s (in %d seconds)</dd>' % (datetime.datetime.now().strftime(format), time.time() - data.getStampCreated()))
 473                 f.write('<dt>Generator</dt><dd><a href="http://gitstats.sourceforge.net/">GitStats</a> (version %s)</dd>' % getversion())
 474                 f.write('<dt>Report Period</dt><dd>%s to %s</dd>' % (data.getFirstCommitDate().strftime(format), data.getLastCommitDate().strftime(format)))
 475                 f.write('<dt>Total Files</dt><dd>%s</dd>' % data.getTotalFiles())
 476                 f.write('<dt>Total Lines of Code</dt><dd>%s</dd>' % data.getTotalLOC())
 477                 f.write('<dt>Total Commits</dt><dd>%s</dd>' % data.getTotalCommits())
 478                 f.write('<dt>Authors</dt><dd>%s</dd>' % data.getTotalAuthors())
 479                 f.write('</dl>')
 480
 481                 f.write('</body>\n</html>')
 482                 f.close()
 483
 484                 ###
 485                 # Activity
 486                 f = open(path + '/activity.html', 'w')
 487                 self.printHeader(f)
 488                 f.write('<h1>Activity</h1>')
 489                 self.printNav(f)
 490
 491                 #f.write('<h2>Last 30 days</h2>')
 492
 493                 #f.write('<h2>Last 12 months</h2>')
 494
 495                 # Hour of Day
 496                 f.write(html_header(2, 'Hour of Day'))
 497                 hour_of_day = data.getActivityByHourOfDay()
 498                 f.write('<table><tr><th>Hour</th>')
 499                 for i in range(1, 25):
 500                         f.write('<th>%d</th>' % i)
 501                 f.write('</tr>\n<tr><th>Commits</th>')
 502                 fp = open(path + '/hour_of_day.dat', 'w')
 503                 for i in range(0, 24):
 504                         if i in hour_of_day:
 505                                 r = 127 + int((float(hour_of_day[i]) / data.activity_by_hour_of_day_busiest) * 128)
 506                                 f.write('<td style="background-color: rgb(%d, 0, 0)">%d</td>' % (r, hour_of_day[i]))
 507                                 fp.write('%d %d\n' % (i, hour_of_day[i]))
 508                         else:
 509                                 f.write('<td>0</td>')
 510                                 fp.write('%d 0\n' % i)
 511                 fp.close()
 512                 f.write('</tr>\n<tr><th>%</th>')
 513                 totalcommits = data.getTotalCommits()
 514                 for i in range(0, 24):
 515                         if i in hour_of_day:
 516                                 r = 127 + int((float(hour_of_day[i]) / data.activity_by_hour_of_day_busiest) * 128)
 517                                 f.write('<td style="background-color: rgb(%d, 0, 0)">%.2f</td>' % (r, (100.0 * hour_of_day[i]) / totalcommits))
 518                         else:
 519                                 f.write('<td>0.00</td>')
 520                 f.write('</tr></table>')
 521                 f.write('<img src="hour_of_day.png" alt="Hour of Day" />')
 522                 fg = open(path + '/hour_of_day.dat', 'w')
 523                 for i in range(0, 24):
 524                         if i in hour_of_day:
 525                                 fg.write('%d %d\n' % (i + 1, hour_of_day[i]))
 526                         else:
 527                                 fg.write('%d 0\n' % (i + 1))
 528                 fg.close()
 529
 530                 # Day of Week
 531                 f.write(html_header(2, 'Day of Week'))
 532                 day_of_week = data.getActivityByDayOfWeek()
 533                 f.write('<div class="vtable"><table>')
 534                 f.write('<tr><th>Day</th><th>Total (%)</th></tr>')
 535                 fp = open(path + '/day_of_week.dat', 'w')
 536                 for d in range(0, 7):
 537                         commits = 0
 538                         if d in day_of_week:
 539                                 commits = day_of_week[d]
 540                         fp.write('%d %d\n' % (d + 1, commits))
 541                         f.write('<tr>')
 542                         f.write('<th>%d</th>' % (d + 1))
 543                         if d in day_of_week:
 544                                 f.write('<td>%d (%.2f%%)</td>' % (day_of_week[d], (100.0 * day_of_week[d]) / totalcommits))
 545                         else:
 546                                 f.write('<td>0</td>')
 547                         f.write('</tr>')
 548                 f.write('</table></div>')
 549                 f.write('<img src="day_of_week.png" alt="Day of Week" />')
 550                 fp.close()
 551
 552                 # Hour of Week
 553                 f.write(html_header(2, 'Hour of Week'))
 554                 f.write('<table>')
 555
 556                 f.write('<tr><th>Weekday</th>')
 557                 for hour in range(0, 24):
 558                         f.write('<th>%d</th>' % (hour + 1))
 559                 f.write('</tr>')
 560
 561                 for weekday in range(0, 7):
 562                         f.write('<tr><th>%d</th>' % (weekday + 1))
 563                         for hour in range(0, 24):
 564                                 try:
 565                                         commits = data.activity_by_hour_of_week[weekday][hour]
 566                                 except KeyError:
 567                                         commits = 0
 568                                 if commits != 0:
 569                                         f.write('<td')
 570                                         r = 127 + int((float(commits) / data.activity_by_hour_of_week_busiest) * 128)
 571                                         f.write(' style="background-color: rgb(%d, 0, 0)"' % r)
 572                                         f.write('>%d</td>' % commits)
 573                                 else:
 574                                         f.write('<td></td>')
 575                         f.write('</tr>')
 576
 577                 f.write('</table>')
 578
 579                 # Month of Year
 580                 f.write(html_header(2, 'Month of Year'))
 581                 f.write('<div class="vtable"><table>')
 582                 f.write('<tr><th>Month</th><th>Commits (%)</th></tr>')
 583                 fp = open (path + '/month_of_year.dat', 'w')
 584                 for mm in range(1, 13):
 585                         commits = 0
 586                         if mm in data.activity_by_month_of_year:
 587                                 commits = data.activity_by_month_of_year[mm]
 588                         f.write('<tr><td>%d</td><td>%d (%.2f %%)</td></tr>' % (mm, commits, (100.0 * commits) / data.getTotalCommits()))
 589                         fp.write('%d %d\n' % (mm, commits))
 590                 fp.close()
 591                 f.write('</table></div>')
 592                 f.write('<img src="month_of_year.png" alt="Month of Year" />')
 593
 594                 # Commits by year/month
 595                 f.write(html_header(2, 'Commits by year/month'))
 596                 f.write('<div class="vtable"><table><tr><th>Month</th><th>Commits</th></tr>')
 597                 for yymm in reversed(sorted(data.commits_by_month.keys())):
 598                         f.write('<tr><td>%s</td><td>%d</td></tr>' % (yymm, data.commits_by_month[yymm]))
 599                 f.write('</table></div>')
 600                 f.write('<img src="commits_by_year_month.png" alt="Commits by year/month" />')
 601                 fg = open(path + '/commits_by_year_month.dat', 'w')
 602                 for yymm in sorted(data.commits_by_month.keys()):
 603                         fg.write('%s %s\n' % (yymm, data.commits_by_month[yymm]))
 604                 fg.close()
 605
 606                 # Commits by year
 607                 f.write(html_header(2, 'Commits by Year'))
 608                 f.write('<div class="vtable"><table><tr><th>Year</th><th>Commits (% of all)</th></tr>')
 609                 for yy in reversed(sorted(data.commits_by_year.keys())):
 610                         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()))
 611                 f.write('</table></div>')
 612                 f.write('<img src="commits_by_year.png" alt="Commits by Year" />')
 613                 fg = open(path + '/commits_by_year.dat', 'w')
 614                 for yy in sorted(data.commits_by_year.keys()):
 615                         fg.write('%d %d\n' % (yy, data.commits_by_year[yy]))
 616                 fg.close()
 617
 618                 f.write('</body></html>')
 619                 f.close()
 620
 621                 ###
 622                 # Authors
 623                 f = open(path + '/authors.html', 'w')
 624                 self.printHeader(f)
 625
 626                 f.write('<h1>Authors</h1>')
 627                 self.printNav(f)
 628
 629                 # Authors :: List of authors
 630                 f.write(html_header(2, 'List of Authors'))
 631
 632                 f.write('<table class="authors sortable" id="authors">')
 633                 f.write('<tr><th>Author</th><th>Commits (%)</th><th>First commit</th><th>Last commit</th><th class="unsortable">Age</th><th># by commits</th></tr>')
 634                 for author in sorted(data.getAuthors()):
 635                         info = data.getAuthorInfo(author)
 636                         f.write('<tr><td>%s</td><td>%d (%.2f%%)</td><td>%s</td><td>%s</td><td>%s</td><td>%d</td></tr>' % (author, info['commits'], info['commits_frac'], info['date_first'], info['date_last'], info['timedelta'], info['place_by_commits']))
 637                 f.write('</table>')
 638
 639                 # Authors :: Author of Month
 640                 f.write(html_header(2, 'Author of Month'))
 641                 f.write('<table class="sortable" id="aom">')
 642                 f.write('<tr><th>Month</th><th>Author</th><th>Commits (%)</th><th class="unsortable">Next top 5</th></tr>')
 643                 for yymm in reversed(sorted(data.author_of_month.keys())):
 644                         authordict = data.author_of_month[yymm]
 645                         authors = getkeyssortedbyvalues(authordict)
 646                         authors.reverse()
 647                         commits = data.author_of_month[yymm][authors[0]]
 648                         next = ', '.join(authors[1:5])
 649                         f.write('<tr><td>%s</td><td>%s</td><td>%d (%.2f%% of %d)</td><td>%s</td></tr>' % (yymm, authors[0], commits, (100 * commits) / data.commits_by_month[yymm], data.commits_by_month[yymm], next))
 650
 651                 f.write('</table>')
 652
 653                 f.write(html_header(2, 'Author of Year'))
 654                 f.write('<table class="sortable" id="aoy"><tr><th>Year</th><th>Author</th><th>Commits (%)</th><th class="unsortable">Next top 5</th></tr>')
 655                 for yy in reversed(sorted(data.author_of_year.keys())):
 656                         authordict = data.author_of_year[yy]
 657                         authors = getkeyssortedbyvalues(authordict)
 658                         authors.reverse()
 659                         commits = data.author_of_year[yy][authors[0]]
 660                         next = ', '.join(authors[1:5])
 661                         f.write('<tr><td>%s</td><td>%s</td><td>%d (%.2f%% of %d)</td><td>%s</td></tr>' % (yy, authors[0], commits, (100 * commits) / data.commits_by_year[yy], data.commits_by_year[yy], next))
 662                 f.write('</table>')
 663
 664                 f.write('</body></html>')
 665                 f.close()
 666
 667                 ###
 668                 # Files
 669                 f = open(path + '/files.html', 'w')
 670                 self.printHeader(f)
 671                 f.write('<h1>Files</h1>')
 672                 self.printNav(f)
 673
 674                 f.write('<dl>\n')
 675                 f.write('<dt>Total files</dt><dd>%d</dd>' % data.getTotalFiles())
 676                 f.write('<dt>Total lines</dt><dd>%d</dd>' % data.getTotalLOC())
 677                 f.write('<dt>Average file size</dt><dd>%.2f bytes</dd>' % ((100.0 * data.getTotalLOC()) / data.getTotalFiles()))
 678                 f.write('</dl>\n')
 679
 680                 # Files :: File count by date
 681                 f.write(html_header(2, 'File count by date'))
 682
 683                 fg = open(path + '/files_by_date.dat', 'w')
 684                 for stamp in sorted(data.files_by_stamp.keys()):
 685                         fg.write('%s %d\n' % (datetime.datetime.fromtimestamp(stamp).strftime('%Y-%m-%d'), data.files_by_stamp[stamp]))
 686                 fg.close()
 687
 688                 f.write('<img src="files_by_date.png" alt="Files by Date" />')
 689
 690                 #f.write('<h2>Average file size by date</h2>')
 691
 692                 # Files :: Extensions
 693                 f.write(html_header(2, 'Extensions'))
 694                 f.write('<table class="sortable" id="ext"><tr><th>Extension</th><th>Files (%)</th><th>Lines (%)</th><th>Lines/file</th></tr>')
 695                 for ext in sorted(data.extensions.keys()):
 696                         files = data.extensions[ext]['files']
 697                         lines = data.extensions[ext]['lines']
 698                         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))
 699                 f.write('</table>')
 700
 701                 f.write('</body></html>')
 702                 f.close()
 703
 704                 ###
 705                 # Lines
 706                 f = open(path + '/lines.html', 'w')
 707                 self.printHeader(f)
 708                 f.write('<h1>Lines</h1>')
 709                 self.printNav(f)
 710
 711                 f.write('<dl>\n')
 712                 f.write('<dt>Total lines</dt><dd>%d</dd>' % data.getTotalLOC())
 713                 f.write('</dl>\n')
 714
 715                 f.write(html_header(2, 'Lines of Code'))
 716                 f.write('<img src="lines_of_code.png" />')
 717
 718                 fg = open(path + '/lines_of_code.dat', 'w')
 719                 for stamp in sorted(data.changes_by_date.keys()):
 720                         fg.write('%d %d\n' % (stamp, data.changes_by_date[stamp]['lines']))
 721                 fg.close()
 722
 723                 f.write('</body></html>')
 724                 f.close()
 725
 726                 ###
 727                 # tags.html
 728                 f = open(path + '/tags.html', 'w')
 729                 self.printHeader(f)
 730                 f.write('<h1>Tags</h1>')
 731                 self.printNav(f)
 732
 733                 f.write('<dl>')
 734                 f.write('<dt>Total tags</dt><dd>%d</dd>' % len(data.tags))
 735                 if len(data.tags) > 0:
 736                         f.write('<dt>Average commits per tag</dt><dd>%.2f</dd>' % (data.getTotalCommits() / len(data.tags)))
 737                 f.write('</dl>')
 738
 739                 f.write('<table>')
 740                 f.write('<tr><th>Name</th><th>Date</th></tr>')
 741                 # sort the tags by date desc
 742                 tags_sorted_by_date_desc = map(lambda el : el[1], reversed(sorted(map(lambda el : (el[1]['date'], el[0]), data.tags.items()))))
 743                 for tag in tags_sorted_by_date_desc:
 744                         f.write('<tr><td>%s</td><td>%s</td></tr>' % (tag, data.tags[tag]['date']))
 745                 f.write('</table>')
 746
 747                 f.write('</body></html>')
 748                 f.close()
 749
 750                 self.createGraphs(path)
 751
 752         def createGraphs(self, path):
 753                 print 'Generating graphs...'
 754
 755                 # hour of day
 756                 f = open(path + '/hour_of_day.plot', 'w')
 757                 f.write(GNUPLOT_COMMON)
 758                 f.write(
 759 """
 760 set output 'hour_of_day.png'
 761 unset key
 762 set xrange [0.5:24.5]
 763 set xtics 4
 764 set ylabel "Commits"
 765 plot 'hour_of_day.dat' using 1:2:(0.5) w boxes fs solid
 766 """)
 767                 f.close()
 768
 769                 # day of week
 770                 f = open(path + '/day_of_week.plot', 'w')
 771                 f.write(GNUPLOT_COMMON)
 772                 f.write(
 773 """
 774 set output 'day_of_week.png'
 775 unset key
 776 set xrange [0.5:7.5]
 777 set xtics 1
 778 set ylabel "Commits"
 779 plot 'day_of_week.dat' using 1:2:(0.5) w boxes fs solid
 780 """)
 781                 f.close()
 782
 783                 # Month of Year
 784                 f = open(path + '/month_of_year.plot', 'w')
 785                 f.write(GNUPLOT_COMMON)
 786                 f.write(
 787 """
 788 set output 'month_of_year.png'
 789 unset key
 790 set xrange [0.5:12.5]
 791 set xtics 1
 792 set ylabel "Commits"
 793 plot 'month_of_year.dat' using 1:2:(0.5) w boxes fs solid
 794 """)
 795                 f.close()
 796
 797                 # commits_by_year_month
 798                 f = open(path + '/commits_by_year_month.plot', 'w')
 799                 f.write(GNUPLOT_COMMON)
 800                 f.write(
 801 """
 802 set output 'commits_by_year_month.png'
 803 unset key
 804 set xdata time
 805 set timefmt "%Y-%m"
 806 set format x "%Y-%m"
 807 set xtics rotate by 90 15768000
 808 set bmargin 5
 809 set ylabel "Commits"
 810 plot 'commits_by_year_month.dat' using 1:2:(0.5) w boxes fs solid
 811 """)
 812                 f.close()
 813
 814                 # commits_by_year
 815                 f = open(path + '/commits_by_year.plot', 'w')
 816                 f.write(GNUPLOT_COMMON)
 817                 f.write(
 818 """
 819 set output 'commits_by_year.png'
 820 unset key
 821 set xtics 1
 822 set ylabel "Commits"
 823 set yrange [0:]
 824 plot 'commits_by_year.dat' using 1:2:(0.5) w boxes fs solid
 825 """)
 826                 f.close()
 827
 828                 # Files by date
 829                 f = open(path + '/files_by_date.plot', 'w')
 830                 f.write(GNUPLOT_COMMON)
 831                 f.write(
 832 """
 833 set output 'files_by_date.png'
 834 unset key
 835 set xdata time
 836 set timefmt "%Y-%m-%d"
 837 set format x "%Y-%m-%d"
 838 set ylabel "Files"
 839 set xtics rotate by 90
 840 set bmargin 6
 841 plot 'files_by_date.dat' using 1:2 w histeps
 842 """)
 843                 f.close()
 844
 845                 # Lines of Code
 846                 f = open(path + '/lines_of_code.plot', 'w')
 847                 f.write(GNUPLOT_COMMON)
 848                 f.write(
 849 """
 850 set output 'lines_of_code.png'
 851 unset key
 852 set xdata time
 853 set timefmt "%s"
 854 set format x "%Y-%m-%d"
 855 set ylabel "Lines"
 856 set xtics rotate by 90
 857 set bmargin 6
 858 plot 'lines_of_code.dat' using 1:2 w lines
 859 """)
 860                 f.close()
 861
 862                 os.chdir(path)
 863                 files = glob.glob(path + '/*.plot')
 864                 for f in files:
 865                         out = getpipeoutput([gnuplot_cmd + ' "%s"' % f])
 866                         if len(out) > 0:
 867                                 print out
 868
 869         def printHeader(self, f, title = ''):
 870                 f.write(
 871 """<?xml version="1.0" encoding="UTF-8"?>
 872 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 873 <html xmlns="http://www.w3.org/1999/xhtml">
 874 <head>
 875         <title>GitStats - %s</title>
 876         <link rel="stylesheet" href="gitstats.css" type="text/css" />
 877         <meta name="generator" content="GitStats %s" />
 878         <script type="text/javascript" src="sortable.js"></script>
 879 </head>
 880 <body>
 881 """ % (self.title, getversion()))
 882
 883         def printNav(self, f):
 884                 f.write("""
 885 <div class="nav">
 886 <ul>
 887 <li><a href="index.html">General</a></li>
 888 <li><a href="activity.html">Activity</a></li>
 889 <li><a href="authors.html">Authors</a></li>
 890 <li><a href="files.html">Files</a></li>
 891 <li><a href="lines.html">Lines</a></li>
 892 <li><a href="tags.html">Tags</a></li>
 893 </ul>
 894 </div>
 895 """)
 896
 897
 898 usage = """
 899 Usage: gitstats [options] <gitpath> <outputpath>
 900
 901 Options:
 902 """
 903
 904 if len(sys.argv) <  3:
 905         print usage
 906         sys.exit(0)
 907
 908 gitpath = sys.argv[1]
 909 outputpath = os.path.abspath(sys.argv[2])
 910 rundir = os.getcwd()
 911
 912 try:
 913         os.makedirs(outputpath)
 914 except OSError:
 915         pass
 916 if not os.path.isdir(outputpath):
 917         print 'FATAL: Output path is not a directory or does not exist'
 918         sys.exit(1)
 919
 920 print 'Git path: %s' % gitpath
 921 print 'Output path: %s' % outputpath
 922
 923 os.chdir(gitpath)
 924
 925 cachefile = os.path.join(outputpath, 'gitstats.cache')
 926
 927 print 'Collecting data...'
 928 data = GitDataCollector()
 929 data.loadCache(cachefile)
 930 data.collect(gitpath)
 931 print 'Refining data...'
 932 data.saveCache(cachefile)
 933 data.refine()
 934
 935 os.chdir(rundir)
 936
 937 print 'Generating report...'
 938 report = HTMLReportCreator()
 939 report.create(data, outputpath)
 940
 941 time_end = time.time()
 942 exectime_internal = time_end - time_start
 943 print 'Execution time %.5f secs, %.5f secs (%.2f %%) in external commands)' % (exectime_internal, exectime_external, (100.0 * exectime_external) / exectime_internal)