def __init__(self,
settings,
database,
dry_run=False,
memorise_forgotten=False,
ignore=None):
self.settings = settings
self.github = GitHub(api_token=settings.GITHUB_TOKEN)
self.repo_user, self.repo_name = settings.GITHUB_REPOSITORY.split("/")
self.database = database
self.dry_run = dry_run
self.memorise_forgotten = memorise_forgotten
self.ignore = set(ignore) if ignore else set()
def __init__(self, settings, database, dry_run=False, memorise_forgotten=False, ignore=None):
self.settings = settings
self.github = GitHub(api_token=settings.GITHUB_TOKEN)
self.repo_user, self.repo_name = settings.GITHUB_REPOSITORY.split("/")
self.database = database
self.dry_run = dry_run
self.memorise_forgotten = memorise_forgotten
self.ignore = set(ignore) if ignore else set()
class CappBot(object):
def __init__(self,
settings,
database,
dry_run=False,
memorise_forgotten=False,
ignore=None):
self.settings = settings
self.github = GitHub(api_token=settings.GITHUB_TOKEN)
self.repo_user, self.repo_name = settings.GITHUB_REPOSITORY.split("/")
self.database = database
self.dry_run = dry_run
self.memorise_forgotten = memorise_forgotten
self.ignore = set(ignore) if ignore else set()
def get_current_user(self):
if not getattr(self, '_current_user', None):
self._current_user = self.github.current_user()
return self._current_user
current_user = property(get_current_user)
def has_seen_issue(self, issue):
"""Return true if the issue is in our database."""
db = self.database
return 'issues' in db and db['issues'].get(unicode(
issue.id)) is not None
def last_seen_issue_update(self, issue):
"""Return the last seen updated_at time in YYYY-MM-DDTHH:MM:SSZ string format.
Note that updated_at might only change when there is a new comment. It does not
seem to change when there is a new label.
"""
if not self.has_seen_issue(issue):
return None
return self.database['issues'][unicode(issue.id)].get('updated_at')
def get_first_run_date(self):
if not self.database.get('first_run'):
self.database['first_run'] = datetime.datetime.now().isoformat()
return iso8601.parse_date(self.database['first_run'])
first_run_date = property(get_first_run_date)
def record_issue(self, issue):
"""Record the information we need to detect whether an issue has been changed."""
db = self.database
if not 'issues' in db:
db['issues'] = {}
db_issue = {
'id':
int(issue.id),
'number':
int(issue.number),
'comments_count':
int(issue.comments),
'milestone_number':
int(issue.milestone.number) if issue.milestone else None,
'assignee_id':
int(issue.assignee.id) if issue.assignee else None,
'labels':
sorted(label.name for label in issue.labels),
'updated_at':
issue.updated_at # (as a string)
}
# Note we need to use string keys for our JSON database's sake.
key = unicode(issue.id)
if key in db['issues']:
db['issues'][key].update(db_issue)
else:
db_issue['votes'] = None
db_issue['latest_seen_comment_id'] = None
db['issues'][key] = db_issue
def record_latest_seen_comment(self, issue):
"""Record the id of the newest comment so we can recognise new comments in the future,
and the time of the last update so that we can skip
"""
db = self.database
db['issues'][unicode(
issue.id)]['latest_seen_comment_id'] = issue._comments[
-1].id if issue._comments else None
def get_issue_changes(self, issue):
"""Examine the given issue against what is stored in the database to see how it's been changed, if it has."""
# Issue must be recorded at this point.
record = self.database['issues'][unicode(issue.id)]
r = set()
if set(record['labels']) != set(label.name for label in issue.labels):
r.add('labels')
if record['assignee_id'] != (int(issue.assignee.id)
if issue.assignee else None):
r.add('assignee')
if record['milestone_number'] != (int(issue.milestone.number)
if issue.milestone else None):
r.add('milestone')
# _comments might not have been loaded yet in which case we can't detect changes there.
if hasattr(issue, '_comments') and issue.comments and (
record['latest_seen_comment_id'] is None
or record['latest_seen_comment_id'] != int(
issue._comments[-1].id)):
r.add('comments')
if issue._force_paper_trail:
r.add('new')
return r
def install_issue_defaults(self, issue):
"""Assign default issue labels, milestone and assignee, if any."""
defs = self.settings.NEW_ISSUE_DEFAULTS
patch = {}
milestone_title = defs.get('milestone')
if milestone_title:
milestone = self.github.Milestones.get_or_create_in_repository(
self.repo_user, self.repo_name, milestone_title)
patch['milestone'] = milestone.number
if defs.get('labels') is not None:
patch['labels'] = map(unicode, defs['labels'])
if defs.get('assignee') is not None:
patch['assignee'] = defs['assignee']
if len(patch):
if not self.dry_run:
try:
issue.patch(**patch)
except:
logbook.error(
u"Unable to change issue %s with attributes %r" %
(issue, patch))
raise
logbook.info(u"Installed defaults %r for issue %s." %
(patch, issue))
def get_new_comments(self, issue):
"""Get all comments which are new since the last call to record_latest_seen_comment."""
record = self.database['issues'][unicode(issue.id)]
latest_seen_comment_id = record['latest_seen_comment_id']
comments = issue._comments
if latest_seen_comment_id is None:
return comments
for n, comment in enumerate(sorted(comments, key=attrgetter('id'))):
if comment.id == latest_seen_comment_id:
return comments[n + 1:]
elif comment.id > latest_seen_comment_id:
# Assume comment ids always go up, so if the last seen comment has been deleted,
# we'll react to the next one.
return comments[n:]
return []
def send_message(self, user, subject, body):
# TODO
return
if not user.email:
logbook.info("No email address found. Unable to send to %s: %s" %
(user.login, body))
return
logbook.info("Sending message to %s (%s): %s" %
(user.login, user.email, body))
if not self.dry_run:
# TODO
pass
def user_may_alter_labels(self, user):
return 'labels' in self.settings.PERMISSIONS.get(user.login, ())
def user_may_set_assignee(self, user):
return 'assignee' in self.settings.PERMISSIONS.get(user.login, ())
def user_may_set_milestone(self, user):
return 'milestone' in self.settings.PERMISSIONS.get(user.login, ())
def get_label_by_name(self, aLabel):
"""Get the label with the proper capitalisation among those available, or None if the label is not available."""
aLabel = aLabel.lower()
for label in self.known_labels:
if label.lower() == aLabel:
return label
return None
def get_milestone_title_by_title(self, aMilestone):
"""Get the milestone title with the proper capitalisation among those available, or None if the milestone is not available."""
if not aMilestone or not aMilestone.strip():
return None
aMilestone = aMilestone.lower()
for milestone in self.known_milestones:
if milestone.lower() == aMilestone:
return milestone
return None
def get_assignee_login_by_name(self, anAssignee):
"""Get the assignee login with the proper capitalisation among those available, or None if the assignee is not available.
Note that only repository collaborators can become assigned to an issue.
"""
if not anAssignee or not anAssignee.strip():
return None
anAssignee = anAssignee.lower()
for assignee in self.collaborator_logins:
if assignee.lower() == anAssignee:
return assignee
return None
def add_label(self, new_label, issue_working_state):
new_label_proper = self.get_label_by_name(new_label)
if new_label_proper in issue_working_state['labels']:
# Ensure we move this new label to the end of the list. We need to know which
# label was added last later.
issue_working_state['labels'].remove(new_label_proper)
issue_working_state['labels'].append(new_label_proper)
if any(l.lower() == new_label_proper.lower()
for l in self.settings.CLOSE_ISSUE_WHEN_CAPPBOT_ADDS_LABEL
) or self.should_open_issue is new_label_proper:
self.should_open_issue = False
self.should_close_issue = new_label_proper
def add_label_due_to_comment(self, new_label, comment,
issue_working_state):
new_label_proper = self.get_label_by_name(new_label)
if not new_label_proper:
logbook.info(u'Ignoring unknown label %s in comment %s by %s.' %
(new_label, comment.url, comment.user.login))
self.send_message(
comment.user, u'Unknown label',
u'(Your comment)[%s] appears to request that the label `%s` is added to the issue but this does not seems to be a valid label.'
% (comment.url, new_label))
return
if not self.user_may_alter_labels(comment.user):
logbook.warning(
u"Ignoring unathorised attempt to alter labels by %s through comment %s."
% (comment.user.login, comment.url))
self.send_message(
comment.user, u'Unable to alter label',
u'(Your comment)[%s] appears to request that the label `%s` is added to the issue but you do not have the required authorisation.'
% (comment.url, new_label_proper))
else:
logbook.info("Adding label %s due to comment %s by %s" %
(new_label_proper, comment.url, comment.user.login))
self.add_label(new_label_proper, issue_working_state)
def remove_label(self, remove_label, issue_working_state):
remove_label_proper = self.get_label_by_name(remove_label)
if not remove_label_proper in issue_working_state['labels']:
return
issue_working_state['labels'].remove(remove_label_proper)
if any(l.lower() == remove_label_proper.lower()
for l in self.settings.OPEN_ISSUE_WHEN_CAPPBOT_REMOVES_LABEL
) or self.should_close_issue is remove_label_proper:
self.should_open_issue = remove_label_proper
self.should_close_issue = False
def remove_label_due_to_comment(self, remove_label, comment,
issue_working_state):
remove_label_proper = self.get_label_by_name(remove_label)
if not remove_label_proper in self.known_labels:
logbook.info(u'Ignoring unknown label %s in comment %s by %s.' %
(remove_label, comment.id, comment.user.login))
self.send_message(
comment.user, u'Unknown label',
u'(Your comment)[%s] appears to request that the label `%s` is removed from the issue but this does not seems to be a valid label.'
% (comment.url, remove_label))
return
if not self.user_may_alter_labels(comment.user):
logbook.warning(
u"Ignoring unathorised attempt to alter labels by %s through comment %s."
% (comment.user.login, comment.url))
self.send_message(
comment.user, u'Unable to alter label',
u'(Your comment)[%s] appears to request that the label `%s` is removed from the issue but you do not have the required authorisation.'
% (comment.url, remove_label_proper))
else:
logbook.info("Removing label %s due to comment %s by %s" %
(remove_label_proper, comment.id, comment.user.login))
self.remove_label(remove_label_proper, issue_working_state)
def set_milestone(self, new_milestone, issue_working_state):
new_milestone_proper = self.get_milestone_title_by_title(new_milestone)
if new_milestone_proper == issue_working_state['milestone']:
return
issue_working_state['milestone'] = new_milestone_proper
def set_milestone_due_to_comment(self, new_milestone, comment,
issue_working_state):
if new_milestone:
new_milestone_proper = self.get_milestone_title_by_title(
new_milestone)
if not new_milestone_proper:
logbook.info(
u'Ignoring unknown milestone %s in comment %s by %s.' %
(new_milestone, comment.id, comment.user.login))
self.send_message(
comment.user, u'Unknown milestone',
u'(Your comment)[%s] appears to request that the milestone `%s` is set for the issue but this does not seems to be a valid milestone.'
% (comment.url, new_milestone))
return
else:
# You can clear the milestone.
new_milestone_proper = None
if not self.user_may_set_milestone(comment.user):
logbook.warning(
u"Ignoring unathorised attempt to alter milestone by %s through comment %s."
% (comment.user.login, comment.url))
self.send_message(
comment.user, u'Unable to alter milestone',
u'(Your comment)[%s] appears to request that the milestone `%s` is set for the issue but you do not have the required authorisation.'
% (comment.url, new_milestone_proper))
else:
logbook.info(
"Setting milestone %s due to comment %s by %s" %
(new_milestone_proper, comment.id, comment.user.login))
self.set_milestone(new_milestone_proper, issue_working_state)
def set_assignee(self, new_assignee, issue_working_state):
new_assignee_proper = self.get_assignee_login_by_name(new_assignee)
if new_assignee_proper == issue_working_state['assignee']:
return
issue_working_state['assignee'] = new_assignee_proper
def set_assignee_due_to_comment(self, new_assignee, comment,
issue_working_state):
if new_assignee:
new_assignee_proper = self.get_assignee_login_by_name(new_assignee)
if not new_assignee_proper:
logbook.info(
u'Ignoring unknown assignee %s in comment %s by %s.' %
(new_assignee, comment.id, comment.user.login))
self.send_message(
comment.user, u'Unknown assignee',
u'(Your comment)[%s] appears to request that the assignee `%s` is set for the issue but this does not seems to be a repository collaborator.'
% (comment.url, new_assignee))
return
else:
# You can clear the assignee.
new_assignee_proper = None
if not self.user_may_set_assignee(comment.user):
logbook.warning(
u"Ignoring unathorised attempt to alter assignee by %s through comment %s."
% (comment.user.login, comment.url))
self.send_message(
comment.user, u'Unable to alter assignee',
u'(Your comment)[%s] appears to request that the assignee `%s` is set for the issue but you do not have the required authorisation.'
% (comment.url, new_assignee_proper))
else:
logbook.info("Setting assignee %s due to comment %s by %s" %
(new_assignee_proper, comment.id, comment.user.login))
self.set_assignee(new_assignee_proper, issue_working_state)
def updated_state_by_interpreting_new_comments(self, issue,
issue_working_state):
issue_working_state = issue_working_state.copy()
new_comments = self.get_new_comments(issue)
# Make sure we have the right label capitalisation.
issue_working_state['labels'] = [
self.get_label_by_name(l) for l in issue_working_state['labels']
]
logbook.debug(u"Examining %d new comment(s) for %s" %
(len(new_comments), issue))
for comment in new_comments:
if not comment.body:
continue
for line in comment.body.split('\n'):
line = line.strip()
# Votes look just like +<label> or -<label> where the label is the number 1 or 0.
if VOTE_REGEX.match(line):
continue
m = ADD_LABEL_REGEX.match(line)
if m:
new_label = (m.group(1) or m.group(2)).lower()
self.add_label_due_to_comment(new_label, comment,
issue_working_state)
continue
m = REMOVE_LABEL_REGEX.match(line)
if m:
remove_label = m.group(1).lower()
self.remove_label_due_to_comment(remove_label, comment,
issue_working_state)
continue
m = SET_MILESTONE_REGEX.match(line)
if m:
new_milestone = m.group(1).lower()
self.set_milestone_due_to_comment(new_milestone, comment,
issue_working_state)
continue
m = SET_ASSIGNEE_REGEX.match(line)
if m:
new_assignee = m.group(1).lower()
self.set_assignee_due_to_comment(new_assignee, comment,
issue_working_state)
continue
return issue_working_state
def updated_state_per_label_removal_rules(self, issue,
issue_working_state):
issue_working_state = issue_working_state.copy()
for trigger_label, labels_to_remove in self.settings.WHEN_LABEL_REMOVE_LABELS.items(
):
if trigger_label in issue_working_state['labels']:
for label in labels_to_remove:
if label in issue_working_state['labels']:
logbook.info(
"Removing label %s due to label %s being set." %
(label, trigger_label))
# This ensures that side effects of removing the label kick in.
self.remove_label(label, issue_working_state)
# Remove conflicting labels.
backwards = list(reversed(issue_working_state['labels']))
for n, label in enumerate(backwards):
if label in self.settings.MUTUALLY_EXCLUSIVE_LABELS:
for other_label in backwards[n + 1:]:
if other_label in self.settings.MUTUALLY_EXCLUSIVE_LABELS:
logbook.info(
"Removing label %s due to label %s being set." %
(other_label, label))
# This ensures that side effects of removing the label kick in.
self.remove_label(other_label, issue_working_state)
# We've removed all conflicting labels at this stage so we're done.
break
return issue_working_state
def recount_votes(self, issue):
"""Search for comments with +1 or -1 on a line by itself, and count the last such line as the commenting
user's vote. Record the total in the database and return whether it changed since the previous recording.
The special syntax 0, +0 or -0 is also allowed to reset a previously made vote or to express a non counted
opinion.
"""
votes = {}
for comment in issue._comments:
if not comment.body:
continue
for line in comment.body.split('\n'):
line = line.strip()
if VOTE_REGEX.match(line):
# If a user votes more than once, the final vote is what will count.
votes[comment.user.login] = int(line)
# Differentiate between a vote of 0 (e.g. +1, -1) and no votes.
score = sum(votes.values()) if len(votes) else None
record = self.database['issues'][unicode(issue.id)]
if score != record['votes']:
record['votes'] = score
return True
return False
def get_vote_count(self, issue):
"""Return the vote tally for the issue."""
record = self.database['issues'][unicode(issue.id)]
return record['votes']
def did_comment_on(self, issue):
"""Return true if we've commented previously on this issue."""
return issue.comments > 0 and any(
comment for comment in issue._comments
if comment.user.login == self.current_user.login)
def ensure_referenced_labels_exist(self):
"""Ensure all labels we might use exist."""
defs = self.settings.NEW_ISSUE_DEFAULTS
for label in defs.get('labels', []):
self.github.Labels.get_or_create_in_repository(
self.repo_user, self.repo_name, label)
def delay_after_update(self):
"""Cause a delay after each paper trail message is posted to limit the maximum rate of
paper trail messages per minute.
"""
if self.settings.UPDATE_DELAY:
time.sleep(self.settings.UPDATE_DELAY)
def check_prepare_issue(self, issue):
"""Phase 1 issue work: record new issues, install issue defaults, mark déjà vu issues,
and retrieve the issue comments.
"""
issue._should_ignore = False
issue._force_paper_trail = False
if self.settings.IGNORE_CLOSED_ISSUES_NOT_UPDATED_SINCE_FIRST_RUN and issue.state == 'closed' and iso8601.parse_date(
issue.updated_at) < self.first_run_date:
logbook.debug(
"Issue %d has been closed since %s, before first run at %s. Ignoring."
% (issue.number, issue.updated_at,
self.first_run_date.isoformat()))
issue._should_ignore = True
return
if self.has_seen_issue(issue) and self.last_seen_issue_update(
issue
) == issue.updated_at and not self.get_issue_changes(issue):
# Note that we need to check both get_issue_changes and updated_at. The updated_at field doesn't update for every
# change, but it does update for comment changes which is what we need.
logbook.debug(
"Issue %d has not changed since last seen update at %s. Ignoring."
% (issue.number, issue.updated_at))
# The important part here is that we don't download the Comments. Downloading all the comments for every
# issue, on every run, is not very efficient.
issue._should_ignore = True
return
# We'll need this now or later, or both.
issue._comments = self.github.Comments.by_issue(issue,
per_page=100,
all_pages=True)
if self.settings.AVOID_RATE_LIMIT:
remaining = issue._comments.get_rate_limit_remaining()
# Remaining will be None if the 'empty comments' optimisation kicked in.
if not remaining is None:
delay = 3600.0 / max(1, remaining)
if delay > 1:
logbook.debug(
"Approaching rate limit (%d requests remaining). Sleeping for %.1fs."
% (remaining, delay))
time.sleep(delay)
if self.has_seen_issue(issue):
# It's not a new issue if we have recorded it previously.
return
# Check for comments we've made to this issue previously. Any such comment would indicate
# there's a problem since we believe !has_seen_issue(issue).
if self.did_comment_on(issue):
if self.memorise_forgotten:
logbook.warning(
u"Déjà vu: it looks like CappBot has interacted with %s but it's not in the database. Recording it now."
% issue)
self.record_issue(issue)
self.recount_votes(issue)
self.record_latest_seen_comment(issue)
issue._should_ignore = True
return
logbook.warning(
u"Déjà vu: it looks like CappBot has interacted with %s but it's not in the database. Ignoring the issue."
% issue)
issue._should_ignore = True
return
if is_issue_new(issue):
logbook.info(u"Issue %s is new." % issue)
# Assign default labels and milestone.
self.install_issue_defaults(issue)
else:
logbook.info(u"Recording manually triaged %s." % issue)
# Even if the issue has been manually triaged, we still want to insert a paper trail starting now.
issue._force_paper_trail = True
self.record_issue(issue)
def handle_issue_changes(self, issue):
if not self.did_comment_on(issue):
# This issue might not have been changed since we first saw it, but we've never commented
# on it so there's no paper trail yet.
issue._force_paper_trail = True
self.should_close_issue = False
self.should_open_issue = False
changes = self.get_issue_changes(issue)
if not changes:
# Make sure we capture the update time so we don't need to run the expensive
# comments check again in the future while this issue remains unchanged.
if self.last_seen_issue_update(issue) is None:
self.record_issue(issue)
logbook.debug(u"No changes for %s" % issue)
return
original_labels = [label.name for label in issue.labels]
issue_working_state = {
'labels': original_labels[:],
'milestone': get_milestone_title(issue.milestone),
'assignee': get_user_login(issue.assignee)
}
did_change_votes = False
if 'comments' in changes:
# Check for action comments which change labels, milestones or assigngee.
issue_working_state = self.updated_state_by_interpreting_new_comments(
issue, issue_working_state)
self.record_latest_seen_comment(issue)
# Count votes.
did_change_votes = self.recount_votes(issue)
# Remove labels superseded by new labels.
issue_working_state = self.updated_state_per_label_removal_rules(
issue, issue_working_state)
# Perform each patch separately so that an error with one does not disrupt the others.
if set(issue_working_state['labels']) != set(original_labels):
changes.add('labels')
if not self.dry_run:
try:
issue.patch(labels=sorted(
map(unicode, issue_working_state['labels'])))
except:
logbook.error(
u"Unable to set %s labels to %s" %
(issue,
sorted(map(unicode, issue_working_state['labels']))))
raise
if issue_working_state['milestone'] != get_milestone_title(
issue.milestone):
changes.add('milestone')
if not self.dry_run:
try:
milestone = self.github.Milestones.get_or_create_in_repository(
self.repo_user, self.repo_name,
issue_working_state['milestone'])
issue.patch(
milestone=milestone.number if milestone else None)
except:
logbook.error(u"Unable to set %s milestone to %s" %
(issue, issue_working_state['milestone']))
raise
if issue_working_state['assignee'] != get_user_login(issue.assignee):
changes.add('assignee')
if not self.dry_run:
try:
issue.patch(assignee=issue_working_state['assignee'])
except:
logbook.error(u"Unable to set %s assignee to %s" %
(issue, issue_working_state['assignee']))
raise
# Post paper trail.
changes = changes.difference(set(['comments']))
if did_change_votes:
changes.add('votes')
# Add the vote count to the issue title.
issue_title = issue.title
m = TITLE_VOTE_REGEX.search(issue_title)
if m:
issue_title = issue_title[:-len(m.group(0))]
vote_count = self.get_vote_count(issue)
if vote_count:
issue_title += ' [%+d]' % self.get_vote_count(issue)
logbook.info(u"Recording vote in title of %s: '%s'" %
(issue, issue_title))
elif m:
logbook.info(u"Clearing vote from title of %s: '%s'" %
(issue, issue_title))
if not self.dry_run:
try:
issue.patch(title=issue_title)
except:
logbook.error(u"Unable to set the title of %s to %s" %
(issue, issue_title))
raise
if issue_working_state['labels'] != original_labels:
changes.add('labels')
if len(changes):
# If we're going to reopen the issue, do that before leaving the paper trail.
if self.should_open_issue and issue.state != 'open':
logbook.info(u'Reopening %s due to label %s being removed' %
(issue, self.should_open_issue))
if not self.dry_run:
try:
issue.patch(state="open")
except:
logbook.error(u"Unable to open %s" % issue)
raise
# Note that we assume the issue_working_state has been properly installed into the issue. This
# makes the messages appear right in dry-run mode. However, if say the assignee wasn't successfully
# changed, CappBot's message might suggest it was. I think that's fine.
msg = self.settings.getPaperTrailMessage(
issue_working_state['assignee'],
issue_working_state['milestone'],
issue_working_state['labels'], self.get_vote_count(issue))
comment = self.github.Comment()
comment.body = msg
logbook.info(u"Adding paper trail for %s (changes: %s): '%s'" %
(issue, ", ".join(changes), msg))
if not self.dry_run:
try:
issue._comments.post(comment)
except:
logbook.error(u"Unable to comment on %s" % issue)
raise
self.record_latest_seen_comment(issue)
self.delay_after_update()
# Close the issue after leaving the paper trail. It looks more natural.
if self.should_close_issue and issue.state != 'closed':
logbook.info(u'Closing %s due to label %s being added' %
(issue, self.should_close_issue))
if not self.dry_run:
try:
issue.patch(state="closed")
except:
logbook.error(u"Unable to close %s" % issue)
raise
# Now record the latest labels etc so we don't react to these same changes the next time.
self.record_issue(issue)
def run(self):
logbook.debug("Logged in as %s." % self.current_user.login)
self.ensure_referenced_labels_exist()
self.known_labels = set(
label.name for label in self.github.Labels.by_repository(
self.repo_user, self.repo_name, per_page=100, all_pages=True))
self.known_milestones = set(
milestone.title
for milestone in self.github.Milestones.by_repository_all(
self.repo_user, self.repo_name, per_page=100, all_pages=True))
# Everyone who's a collborator automatically has permissions to do everything.
self.collaborator_logins = set(
c.login for c in self.github.Collaborators.by_repository(
self.repo_user, self.repo_name, per_page=100, all_pages=True))
for login in self.collaborator_logins:
self.settings.PERMISSIONS[login] = [
'labels', 'assignee', 'milestone'
]
# Find all issues.
issues = self.github.Issues.by_repository_all(self.repo_user,
self.repo_name,
per_page=100,
all_pages=True)
logbook.debug("Found %d issue(s)." % len(issues))
# Phase 1: check, prepare and record issues.
for issue in issues:
if issue.number in self.ignore:
continue
self.check_prepare_issue(issue)
# Phase 2: react to changed issues.
for issue in issues:
if issue.number in self.ignore or issue._should_ignore:
continue
self.handle_issue_changes(issue)
class CappBot(object):
def __init__(self, settings, database, dry_run=False, memorise_forgotten=False, ignore=None):
self.settings = settings
self.github = GitHub(api_token=settings.GITHUB_TOKEN)
self.repo_user, self.repo_name = settings.GITHUB_REPOSITORY.split("/")
self.database = database
self.dry_run = dry_run
self.memorise_forgotten = memorise_forgotten
self.ignore = set(ignore) if ignore else set()
def get_current_user(self):
if not getattr(self, '_current_user', None):
self._current_user = self.github.current_user()
return self._current_user
current_user = property(get_current_user)
def has_seen_issue(self, issue):
"""Return true if the issue is in our database."""
db = self.database
return 'issues' in db and db['issues'].get(unicode(issue.id)) is not None
def last_seen_issue_update(self, issue):
"""Return the last seen updated_at time in YYYY-MM-DDTHH:MM:SSZ string format.
Note that updated_at might only change when there is a new comment. It does not
seem to change when there is a new label.
"""
if not self.has_seen_issue(issue):
return None
return self.database['issues'][unicode(issue.id)].get('updated_at')
def get_first_run_date(self):
if not self.database.get('first_run'):
self.database['first_run'] = datetime.datetime.now().isoformat()
return iso8601.parse_date(self.database['first_run'])
first_run_date = property(get_first_run_date)
def record_issue(self, issue):
"""Record the information we need to detect whether an issue has been changed."""
db = self.database
if not 'issues' in db:
db['issues'] = {}
db_issue = {
'id': int(issue.id),
'number': int(issue.number),
'comments_count': int(issue.comments),
'milestone_number': int(issue.milestone.number) if issue.milestone else None,
'assignee_id': int(issue.assignee.id) if issue.assignee else None,
'labels': sorted(label.name for label in issue.labels),
'updated_at': issue.updated_at # (as a string)
}
# Note we need to use string keys for our JSON database's sake.
key = unicode(issue.id)
if key in db['issues']:
db['issues'][key].update(db_issue)
else:
db_issue['votes'] = None
db_issue['latest_seen_comment_id'] = None
db['issues'][key] = db_issue
def record_latest_seen_comment(self, issue):
"""Record the id of the newest comment so we can recognise new comments in the future,
and the time of the last update so that we can skip
"""
db = self.database
db['issues'][unicode(issue.id)]['latest_seen_comment_id'] = issue._comments[-1].id if issue._comments else None
def get_issue_changes(self, issue):
"""Examine the given issue against what is stored in the database to see how it's been changed, if it has."""
# Issue must be recorded at this point.
record = self.database['issues'][unicode(issue.id)]
r = set()
if set(record['labels']) != set(label.name for label in issue.labels):
r.add('labels')
if record['assignee_id'] != (int(issue.assignee.id) if issue.assignee else None):
r.add('assignee')
if record['milestone_number'] != (int(issue.milestone.number) if issue.milestone else None):
r.add('milestone')
# _comments might not have been loaded yet in which case we can't detect changes there.
if hasattr(issue, '_comments') and issue.comments and (record['latest_seen_comment_id'] is None or record['latest_seen_comment_id'] != int(issue._comments[-1].id)):
r.add('comments')
if issue._force_paper_trail:
r.add('new')
return r
def install_issue_defaults(self, issue):
"""Assign default issue labels, milestone and assignee, if any."""
defs = self.settings.NEW_ISSUE_DEFAULTS
patch = {}
milestone_title = defs.get('milestone')
if milestone_title:
milestone = self.github.Milestones.get_or_create_in_repository(self.repo_user, self.repo_name, milestone_title)
patch['milestone'] = milestone.number
if defs.get('labels') is not None:
patch['labels'] = map(unicode, defs['labels'])
if defs.get('assignee') is not None:
patch['assignee'] = defs['assignee']
if len(patch):
if not self.dry_run:
try:
issue.patch(**patch)
except:
logbook.error(u"Unable to change issue %s with attributes %r" % (issue, patch))
raise
logbook.info(u"Installed defaults %r for issue %s." % (patch, issue))
def get_new_comments(self, issue):
"""Get all comments which are new since the last call to record_latest_seen_comment."""
record = self.database['issues'][unicode(issue.id)]
latest_seen_comment_id = record['latest_seen_comment_id']
comments = issue._comments
if latest_seen_comment_id is None:
return comments
for n, comment in enumerate(sorted(comments, key=attrgetter('id'))):
if comment.id == latest_seen_comment_id:
return comments[n + 1:]
elif comment.id > latest_seen_comment_id:
# Assume comment ids always go up, so if the last seen comment has been deleted,
# we'll react to the next one.
return comments[n:]
return []
def send_message(self, user, subject, body):
# TODO
return
if not user.email:
logbook.info("No email address found. Unable to send to %s: %s" % (user.login, body))
return
logbook.info("Sending message to %s (%s): %s" % (user.login, user.email, body))
if not self.dry_run:
# TODO
pass
def user_may_alter_labels(self, user):
return 'labels' in self.settings.PERMISSIONS.get(user.login, ())
def user_may_set_assignee(self, user):
return 'assignee' in self.settings.PERMISSIONS.get(user.login, ())
def user_may_set_milestone(self, user):
return 'milestone' in self.settings.PERMISSIONS.get(user.login, ())
def get_label_by_name(self, aLabel):
"""Get the label with the proper capitalisation among those available, or None if the label is not available."""
aLabel = aLabel.lower()
for label in self.known_labels:
if label.lower() == aLabel:
return label
return None
def get_milestone_title_by_title(self, aMilestone):
"""Get the milestone title with the proper capitalisation among those available, or None if the milestone is not available."""
if not aMilestone or not aMilestone.strip():
return None
aMilestone = aMilestone.lower()
for milestone in self.known_milestones:
if milestone.lower() == aMilestone:
return milestone
return None
def get_assignee_login_by_name(self, anAssignee):
"""Get the assignee login with the proper capitalisation among those available, or None if the assignee is not available.
Note that only repository collaborators can become assigned to an issue.
"""
if not anAssignee or not anAssignee.strip():
return None
anAssignee = anAssignee.lower()
for assignee in self.collaborator_logins:
if assignee.lower() == anAssignee:
return assignee
return None
def add_label(self, new_label, issue_working_state):
new_label_proper = self.get_label_by_name(new_label)
if new_label_proper in issue_working_state['labels']:
# Ensure we move this new label to the end of the list. We need to know which
# label was added last later.
issue_working_state['labels'].remove(new_label_proper)
issue_working_state['labels'].append(new_label_proper)
if any(l.lower() == new_label_proper.lower() for l in self.settings.CLOSE_ISSUE_WHEN_CAPPBOT_ADDS_LABEL) or self.should_open_issue is new_label_proper:
self.should_open_issue = False
self.should_close_issue = new_label_proper
def add_label_due_to_comment(self, new_label, comment, issue_working_state):
new_label_proper = self.get_label_by_name(new_label)
if not new_label_proper:
logbook.info(u'Ignoring unknown label %s in comment %s by %s.' % (new_label, comment.url, comment.user.login))
self.send_message(comment.user, u'Unknown label', u'(Your comment)[%s] appears to request that the label `%s` is added to the issue but this does not seems to be a valid label.' % (comment.url, new_label))
return
if not self.user_may_alter_labels(comment.user):
logbook.warning(u"Ignoring unathorised attempt to alter labels by %s through comment %s." % (comment.user.login, comment.url))
self.send_message(comment.user, u'Unable to alter label', u'(Your comment)[%s] appears to request that the label `%s` is added to the issue but you do not have the required authorisation.' % (comment.url, new_label_proper))
else:
logbook.info("Adding label %s due to comment %s by %s" % (new_label_proper, comment.url, comment.user.login))
self.add_label(new_label_proper, issue_working_state)
def remove_label(self, remove_label, issue_working_state):
remove_label_proper = self.get_label_by_name(remove_label)
if not remove_label_proper in issue_working_state['labels']:
return
issue_working_state['labels'].remove(remove_label_proper)
if any(l.lower() == remove_label_proper.lower() for l in self.settings.OPEN_ISSUE_WHEN_CAPPBOT_REMOVES_LABEL) or self.should_close_issue is remove_label_proper:
self.should_open_issue = remove_label_proper
self.should_close_issue = False
def remove_label_due_to_comment(self, remove_label, comment, issue_working_state):
remove_label_proper = self.get_label_by_name(remove_label)
if not remove_label_proper in self.known_labels:
logbook.info(u'Ignoring unknown label %s in comment %s by %s.' % (remove_label, comment.id, comment.user.login))
self.send_message(comment.user, u'Unknown label', u'(Your comment)[%s] appears to request that the label `%s` is removed from the issue but this does not seems to be a valid label.' % (comment.url, remove_label))
return
if not self.user_may_alter_labels(comment.user):
logbook.warning(u"Ignoring unathorised attempt to alter labels by %s through comment %s." % (comment.user.login, comment.url))
self.send_message(comment.user, u'Unable to alter label', u'(Your comment)[%s] appears to request that the label `%s` is removed from the issue but you do not have the required authorisation.' % (comment.url, remove_label_proper))
else:
logbook.info("Removing label %s due to comment %s by %s" % (remove_label_proper, comment.id, comment.user.login))
self.remove_label(remove_label_proper, issue_working_state)
def set_milestone(self, new_milestone, issue_working_state):
new_milestone_proper = self.get_milestone_title_by_title(new_milestone)
if new_milestone_proper == issue_working_state['milestone']:
return
issue_working_state['milestone'] = new_milestone_proper
def set_milestone_due_to_comment(self, new_milestone, comment, issue_working_state):
if new_milestone:
new_milestone_proper = self.get_milestone_title_by_title(new_milestone)
if not new_milestone_proper:
logbook.info(u'Ignoring unknown milestone %s in comment %s by %s.' % (new_milestone, comment.id, comment.user.login))
self.send_message(comment.user, u'Unknown milestone', u'(Your comment)[%s] appears to request that the milestone `%s` is set for the issue but this does not seems to be a valid milestone.' % (comment.url, new_milestone))
return
else:
# You can clear the milestone.
new_milestone_proper = None
if not self.user_may_set_milestone(comment.user):
logbook.warning(u"Ignoring unathorised attempt to alter milestone by %s through comment %s." % (comment.user.login, comment.url))
self.send_message(comment.user, u'Unable to alter milestone', u'(Your comment)[%s] appears to request that the milestone `%s` is set for the issue but you do not have the required authorisation.' % (comment.url, new_milestone_proper))
else:
logbook.info("Setting milestone %s due to comment %s by %s" % (new_milestone_proper, comment.id, comment.user.login))
self.set_milestone(new_milestone_proper, issue_working_state)
def set_assignee(self, new_assignee, issue_working_state):
new_assignee_proper = self.get_assignee_login_by_name(new_assignee)
if new_assignee_proper == issue_working_state['assignee']:
return
issue_working_state['assignee'] = new_assignee_proper
def set_assignee_due_to_comment(self, new_assignee, comment, issue_working_state):
if new_assignee:
new_assignee_proper = self.get_assignee_login_by_name(new_assignee)
if not new_assignee_proper:
logbook.info(u'Ignoring unknown assignee %s in comment %s by %s.' % (new_assignee, comment.id, comment.user.login))
self.send_message(comment.user, u'Unknown assignee', u'(Your comment)[%s] appears to request that the assignee `%s` is set for the issue but this does not seems to be a repository collaborator.' % (comment.url, new_assignee))
return
else:
# You can clear the assignee.
new_assignee_proper = None
if not self.user_may_set_assignee(comment.user):
logbook.warning(u"Ignoring unathorised attempt to alter assignee by %s through comment %s." % (comment.user.login, comment.url))
self.send_message(comment.user, u'Unable to alter assignee', u'(Your comment)[%s] appears to request that the assignee `%s` is set for the issue but you do not have the required authorisation.' % (comment.url, new_assignee_proper))
else:
logbook.info("Setting assignee %s due to comment %s by %s" % (new_assignee_proper, comment.id, comment.user.login))
self.set_assignee(new_assignee_proper, issue_working_state)
def updated_state_by_interpreting_new_comments(self, issue, issue_working_state):
issue_working_state = issue_working_state.copy()
new_comments = self.get_new_comments(issue)
# Make sure we have the right label capitalisation.
issue_working_state['labels'] = [self.get_label_by_name(l) for l in issue_working_state['labels']]
logbook.debug(u"Examining %d new comment(s) for %s" % (len(new_comments), issue))
for comment in new_comments:
if not comment.body:
continue
for line in comment.body.split('\n'):
line = line.strip()
# Votes look just like +<label> or -<label> where the label is the number 1 or 0.
if VOTE_REGEX.match(line):
continue
m = ADD_LABEL_REGEX.match(line)
if m:
new_label = (m.group(1) or m.group(2)).lower()
self.add_label_due_to_comment(new_label, comment, issue_working_state)
continue
m = REMOVE_LABEL_REGEX.match(line)
if m:
remove_label = m.group(1).lower()
self.remove_label_due_to_comment(remove_label, comment, issue_working_state)
continue
m = SET_MILESTONE_REGEX.match(line)
if m:
new_milestone = m.group(1).lower()
self.set_milestone_due_to_comment(new_milestone, comment, issue_working_state)
continue
m = SET_ASSIGNEE_REGEX.match(line)
if m:
new_assignee = m.group(1).lower()
self.set_assignee_due_to_comment(new_assignee, comment, issue_working_state)
continue
return issue_working_state
def updated_state_per_label_removal_rules(self, issue, issue_working_state):
issue_working_state = issue_working_state.copy()
for trigger_label, labels_to_remove in self.settings.WHEN_LABEL_REMOVE_LABELS.items():
if trigger_label in issue_working_state['labels']:
for label in labels_to_remove:
if label in issue_working_state['labels']:
logbook.info("Removing label %s due to label %s being set." % (label, trigger_label))
# This ensures that side effects of removing the label kick in.
self.remove_label(label, issue_working_state)
# Remove conflicting labels.
backwards = list(reversed(issue_working_state['labels']))
for n, label in enumerate(backwards):
if label in self.settings.MUTUALLY_EXCLUSIVE_LABELS:
for other_label in backwards[n + 1:]:
if other_label in self.settings.MUTUALLY_EXCLUSIVE_LABELS:
logbook.info("Removing label %s due to label %s being set." % (other_label, label))
# This ensures that side effects of removing the label kick in.
self.remove_label(other_label, issue_working_state)
# We've removed all conflicting labels at this stage so we're done.
break
return issue_working_state
def recount_votes(self, issue):
"""Search for comments with +1 or -1 on a line by itself, and count the last such line as the commenting
user's vote. Record the total in the database and return whether it changed since the previous recording.
The special syntax 0, +0 or -0 is also allowed to reset a previously made vote or to express a non counted
opinion.
"""
votes = {}
for comment in issue._comments:
if not comment.body:
continue
for line in comment.body.split('\n'):
line = line.strip()
if VOTE_REGEX.match(line):
# If a user votes more than once, the final vote is what will count.
votes[comment.user.login] = int(line)
# Differentiate between a vote of 0 (e.g. +1, -1) and no votes.
score = sum(votes.values()) if len(votes) else None
record = self.database['issues'][unicode(issue.id)]
if score != record['votes']:
record['votes'] = score
return True
return False
def get_vote_count(self, issue):
"""Return the vote tally for the issue."""
record = self.database['issues'][unicode(issue.id)]
return record['votes']
def did_comment_on(self, issue):
"""Return true if we've commented previously on this issue."""
return issue.comments > 0 and any(comment for comment in issue._comments if comment.user.login == self.current_user.login)
def ensure_referenced_labels_exist(self):
"""Ensure all labels we might use exist."""
defs = self.settings.NEW_ISSUE_DEFAULTS
for label in defs.get('labels', []):
self.github.Labels.get_or_create_in_repository(self.repo_user, self.repo_name, label)
def delay_after_update(self):
"""Cause a delay after each paper trail message is posted to limit the maximum rate of
paper trail messages per minute.
"""
if self.settings.UPDATE_DELAY:
time.sleep(self.settings.UPDATE_DELAY)
def check_prepare_issue(self, issue):
"""Phase 1 issue work: record new issues, install issue defaults, mark déjà vu issues,
and retrieve the issue comments.
"""
issue._should_ignore = False
issue._force_paper_trail = False
if self.settings.IGNORE_CLOSED_ISSUES_NOT_UPDATED_SINCE_FIRST_RUN and issue.state == 'closed' and iso8601.parse_date(issue.updated_at) < self.first_run_date:
logbook.debug("Issue %d has been closed since %s, before first run at %s. Ignoring." % (issue.number, issue.updated_at, self.first_run_date.isoformat()))
issue._should_ignore = True
return
if self.has_seen_issue(issue) and self.last_seen_issue_update(issue) == issue.updated_at and not self.get_issue_changes(issue):
# Note that we need to check both get_issue_changes and updated_at. The updated_at field doesn't update for every
# change, but it does update for comment changes which is what we need.
logbook.debug("Issue %d has not changed since last seen update at %s. Ignoring." % (issue.number, issue.updated_at))
# The important part here is that we don't download the Comments. Downloading all the comments for every
# issue, on every run, is not very efficient.
issue._should_ignore = True
return
# We'll need this now or later, or both.
issue._comments = self.github.Comments.by_issue(issue, per_page=100, all_pages=True)
if self.settings.AVOID_RATE_LIMIT:
remaining = issue._comments.get_rate_limit_remaining()
# Remaining will be None if the 'empty comments' optimisation kicked in.
if not remaining is None:
delay = 3600.0 / max(1, remaining)
if delay > 1:
logbook.debug("Approaching rate limit (%d requests remaining). Sleeping for %.1fs." % (remaining, delay))
time.sleep(delay)
if self.has_seen_issue(issue):
# It's not a new issue if we have recorded it previously.
return
# Check for comments we've made to this issue previously. Any such comment would indicate
# there's a problem since we believe !has_seen_issue(issue).
if self.did_comment_on(issue):
if self.memorise_forgotten:
logbook.warning(u"Déjà vu: it looks like CappBot has interacted with %s but it's not in the database. Recording it now." % issue)
self.record_issue(issue)
self.recount_votes(issue)
self.record_latest_seen_comment(issue)
issue._should_ignore = True
return
logbook.warning(u"Déjà vu: it looks like CappBot has interacted with %s but it's not in the database. Ignoring the issue." % issue)
issue._should_ignore = True
return
if is_issue_new(issue):
logbook.info(u"Issue %s is new." % issue)
# Assign default labels and milestone.
self.install_issue_defaults(issue)
else:
logbook.info(u"Recording manually triaged %s." % issue)
# Even if the issue has been manually triaged, we still want to insert a paper trail starting now.
issue._force_paper_trail = True
self.record_issue(issue)
def handle_issue_changes(self, issue):
if not self.did_comment_on(issue):
# This issue might not have been changed since we first saw it, but we've never commented
# on it so there's no paper trail yet.
issue._force_paper_trail = True
self.should_close_issue = False
self.should_open_issue = False
changes = self.get_issue_changes(issue)
if not changes:
# Make sure we capture the update time so we don't need to run the expensive
# comments check again in the future while this issue remains unchanged.
if self.last_seen_issue_update(issue) is None:
self.record_issue(issue)
logbook.debug(u"No changes for %s" % issue)
return
original_labels = [label.name for label in issue.labels]
issue_working_state = {'labels': original_labels[:], 'milestone': get_milestone_title(issue.milestone), 'assignee': get_user_login(issue.assignee)}
did_change_votes = False
if 'comments' in changes:
# Check for action comments which change labels, milestones or assigngee.
issue_working_state = self.updated_state_by_interpreting_new_comments(issue, issue_working_state)
self.record_latest_seen_comment(issue)
# Count votes.
did_change_votes = self.recount_votes(issue)
# Remove labels superseded by new labels.
issue_working_state = self.updated_state_per_label_removal_rules(issue, issue_working_state)
# Perform each patch separately so that an error with one does not disrupt the others.
if set(issue_working_state['labels']) != set(original_labels):
changes.add('labels')
if not self.dry_run:
try:
issue.patch(labels=sorted(map(unicode, issue_working_state['labels'])))
except:
logbook.error(u"Unable to set %s labels to %s" % (issue, sorted(map(unicode, issue_working_state['labels']))))
raise
if issue_working_state['milestone'] != get_milestone_title(issue.milestone):
changes.add('milestone')
if not self.dry_run:
try:
milestone = self.github.Milestones.get_or_create_in_repository(self.repo_user, self.repo_name, issue_working_state['milestone'])
issue.patch(milestone=milestone.number if milestone else None)
except:
logbook.error(u"Unable to set %s milestone to %s" % (issue, issue_working_state['milestone']))
raise
if issue_working_state['assignee'] != get_user_login(issue.assignee):
changes.add('assignee')
if not self.dry_run:
try:
issue.patch(assignee=issue_working_state['assignee'])
except:
logbook.error(u"Unable to set %s assignee to %s" % (issue, issue_working_state['assignee']))
raise
# Post paper trail.
changes = changes.difference(set(['comments']))
if did_change_votes:
changes.add('votes')
# Add the vote count to the issue title.
issue_title = issue.title
m = TITLE_VOTE_REGEX.search(issue_title)
if m:
issue_title = issue_title[:-len(m.group(0))]
vote_count = self.get_vote_count(issue)
if vote_count:
issue_title += ' [%+d]' % self.get_vote_count(issue)
logbook.info(u"Recording vote in title of %s: '%s'" % (issue, issue_title))
elif m:
logbook.info(u"Clearing vote from title of %s: '%s'" % (issue, issue_title))
if not self.dry_run:
try:
issue.patch(title=issue_title)
except:
logbook.error(u"Unable to set the title of %s to %s" % (issue, issue_title))
raise
if issue_working_state['labels'] != original_labels:
changes.add('labels')
if len(changes):
# If we're going to reopen the issue, do that before leaving the paper trail.
if self.should_open_issue and issue.state != 'open':
logbook.info(u'Reopening %s due to label %s being removed' % (issue, self.should_open_issue))
if not self.dry_run:
try:
issue.patch(state="open")
except:
logbook.error(u"Unable to open %s" % issue)
raise
# Note that we assume the issue_working_state has been properly installed into the issue. This
# makes the messages appear right in dry-run mode. However, if say the assignee wasn't successfully
# changed, CappBot's message might suggest it was. I think that's fine.
msg = self.settings.getPaperTrailMessage(issue_working_state['assignee'], issue_working_state['milestone'], issue_working_state['labels'], self.get_vote_count(issue))
comment = self.github.Comment()
comment.body = msg
logbook.info(u"Adding paper trail for %s (changes: %s): '%s'" % (issue, ", ".join(changes), msg))
if not self.dry_run:
try:
issue._comments.post(comment)
except:
logbook.error(u"Unable to comment on %s" % issue)
raise
self.record_latest_seen_comment(issue)
self.delay_after_update()
# Close the issue after leaving the paper trail. It looks more natural.
if self.should_close_issue and issue.state != 'closed':
logbook.info(u'Closing %s due to label %s being added' % (issue, self.should_close_issue))
if not self.dry_run:
try:
issue.patch(state="closed")
except:
logbook.error(u"Unable to close %s" % issue)
raise
# Now record the latest labels etc so we don't react to these same changes the next time.
self.record_issue(issue)
def run(self):
logbook.debug("Logged in as %s." % self.current_user.login)
self.ensure_referenced_labels_exist()
self.known_labels = set(label.name for label in self.github.Labels.by_repository(self.repo_user, self.repo_name, per_page=100, all_pages=True))
self.known_milestones = set(milestone.title for milestone in self.github.Milestones.by_repository_all(self.repo_user, self.repo_name, per_page=100, all_pages=True))
# Everyone who's a collaborator automatically has permissions to do everything.
self.collaborator_logins = set(c.login for c in self.github.Collaborators.by_repository(self.repo_user, self.repo_name, per_page=100, all_pages=True))
for login in self.collaborator_logins:
self.settings.PERMISSIONS[login] = ['labels', 'assignee', 'milestone']
# Find all issues.
issues = self.github.Issues.by_repository_all(self.repo_user, self.repo_name, per_page=100, all_pages=True)
logbook.debug("Found %d issue(s)." % len(issues))
# Phase 1: check, prepare and record issues.
for issue in issues:
if issue.number in self.ignore:
continue
self.check_prepare_issue(issue)
# Phase 2: react to changed issues.
for issue in issues:
if issue.number in self.ignore or issue._should_ignore:
continue
self.handle_issue_changes(issue)
