def parse_change_desc(changedesc, changenum, allow_empty=False):
if not changedesc:
return None
changeset = ChangeSet()
try:
changeset.changenum = int(changedesc['change'])
except ValueError:
changeset.changenum = changenum
# At it's most basic, a perforce changeset description has three
# sections.
#
# ---------------------------------------------------------
# Change <num> by <user>@<client> on <timestamp> *pending*
#
# description...
# this can be any number of lines
#
# Affected files ...
#
# //depot/branch/etc/file.cc#<revision> branch
# //depot/branch/etc/file.hh#<revision> delete
# ---------------------------------------------------------
#
# At the moment, we only care about the description and the list of
# files. We take the first line of the description as the summary.
#
# We parse the username out of the first line to check that one user
# isn't attempting to "claim" another's changelist. We then split
# everything around the 'Affected files ...' line, and process the
# results.
changeset.username = changedesc['user']
try:
changeset.description = changedesc['desc'].decode('utf-8')
except UnicodeDecodeError:
changeset.description = changedesc['desc'].decode(
'utf-8', 'replace')
if changedesc['status'] == "pending":
changeset.pending = True
try:
changeset.files = changedesc['depotFile']
except KeyError:
if not allow_empty:
raise EmptyChangeSetError(changenum)
split = changeset.description.find('\n\n')
if split >= 0 and split < 100:
changeset.summary = \
changeset.description.split('\n\n', 1)[0].replace('\n', ' ')
else:
changeset.summary = changeset.description.split('\n', 1)[0]
return changeset
def _parse_change_desc(self, changedesc, changenum, allow_empty=False):
"""Parse the contents of a change description from Perforce.
This will attempt to grab details from the change description,
including the changeset ID, the list of files, change message,
and state.
Args:
changedesc (dict):
The change description dictionary from Perforce.
changenum (int):
THe change number.
allow_empty (bool, optional):
Whether an empty changeset (containing no files) is allowed.
Returns:
reviewboard.scmtools.core.ChangeSet:
The resulting changeset, or ``None`` if ``changedesc`` is empty.
Raises:
reviewboard.scmtools.errors.EmptyChangeSetError:
The resulting changeset contained no file modifications (and
``allow_empty`` was ``False``).
"""
if not changedesc:
return None
changeset = ChangeSet()
try:
changeset.changenum = int(changedesc['change'])
except ValueError:
changeset.changenum = changenum
# At it's most basic, a perforce changeset description has three
# sections.
#
# ---------------------------------------------------------
# Change <num> by <user>@<client> on <timestamp> *pending*
#
# description...
# this can be any number of lines
#
# Affected files ...
#
# //depot/branch/etc/file.cc#<revision> branch
# //depot/branch/etc/file.hh#<revision> delete
# ---------------------------------------------------------
#
# At the moment, we only care about the description and the list of
# files. We take the first line of the description as the summary.
#
# We parse the username out of the first line to check that one user
# isn't attempting to "claim" another's changelist. We then split
# everything around the 'Affected files ...' line, and process the
# results.
changeset.username = force_text(changedesc['user'])
changeset.description = force_text(changedesc['desc'],
errors='replace')
if changedesc['status'] == 'pending':
changeset.pending = True
try:
changeset.files = [
force_text(depot_file)
for depot_file in changedesc['depotFile']
]
except KeyError:
if not allow_empty:
raise EmptyChangeSetError(changenum)
split = changeset.description.find('\n\n')
if split >= 0 and split < 100:
changeset.summary = \
changeset.description.split('\n\n', 1)[0].replace('\n', ' ')
else:
changeset.summary = changeset.description.split('\n', 1)[0]
return changeset