# Copyright 2020 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Git utilities."""
import datetime
import json
import logging
import subprocess
def _run_git(*cmd):
"""Runs a git command and returns the output."""
cmd = ['git'] + list(cmd)
return subprocess.check_output(cmd)
def _get_commit_message(rev):
"""Gets the commit message for a revision."""
return _run_git('log', '--format=%B', '-n', '1', rev)
def get_commit_date(rev):
"""Gets the date a commit was committed."""
raw_date = _run_git('show', '--no-patch', '--no-notes', '--pretty=%cd',
rev).strip().decode('utf-8')
# The last space separate section is timezone. '%z' doesn't let us parse this
# because python datetime (in 2.7, at least) doesn't support parsing timezones
# by default.
split = raw_date.split(' ')
raw_date, tz = ' '.join(split[:-1]), split[-1]
# `git log` seems to always give us dates in UTC. Parsing the UTC timezone
# itself is hard, so just enforce that we always get UTC for now.
assert tz == '+0000', 'Expected git timezone %s, got %s.' % ('+0000', tz)
return datetime.datetime.strptime(raw_date.strip(), '%a %b %d %H:%M:%S %Y')
def get_revisions_between(commit1, commit2):
"""Gets the list of revisions between commit1 and commit2.
commit1 must have been committed before commit2.
Args:
commit1: A git commit hash.
commit2: A git commit hash.
Returns:
A list of git commits between the two commits, not including commit1 or
commit2.
"""
lines = _run_git('log', '--format=oneline', '%s..%s' % (commit1, commit2))
return [l.split()[0].strip().decode('utf-8') for l in lines.splitlines()]