Skip to content

Commit

Permalink
Support github timeline events.
Browse files Browse the repository at this point in the history
Adds support for retrieval of Github timeline events.

Signed-off-by: Nick Campbell <nicholas.j.campbell@gmail.com>
  • Loading branch information
ncb000gt committed Nov 26, 2019
1 parent 3170caf commit f6f1eda
Show file tree
Hide file tree
Showing 6 changed files with 261 additions and 2 deletions.
4 changes: 4 additions & 0 deletions github/Consts.py
Expand Up @@ -10,6 +10,7 @@
# Copyright 2018 Maarten Fonville <mfonville@users.noreply.github.com> #
# Copyright 2018 Wan Liuyang <tsfdye@gmail.com> #
# Copyright 2018 sfdye <tsfdye@gmail.com> #
# Copyright 2019 Nick Campbell <nicholas.j.campbell@gmail.com> #
# #
# This file is part of PyGithub. #
# http://pygithub.readthedocs.io/ #
Expand Down Expand Up @@ -108,3 +109,6 @@

# https://developer.github.com/changes/2019-06-04-automated-security-fixes/
automatedSecurityFixes = "application/vnd.github.london-preview+json"

# https://developer.github.com/changes/2016-05-23-timeline-preview-api/
issueTimelineEventsPreview = "application/vnd.github.mockingbird-preview"
17 changes: 16 additions & 1 deletion github/Issue.py
Expand Up @@ -16,13 +16,14 @@
# Copyright 2016 Jannis Gebauer <ja.geb@me.com> #
# Copyright 2016 Matt Babineau <babineaum@users.noreply.github.com> #
# Copyright 2016 Peter Buckley <dx-pbuckley@users.noreply.github.com> #
# Copyright 2017 Nicolas Agustín Torres <nicolastrres@gmail.com> #
# Copyright 2017 Nicolas Agustín Torres <nicolastrres@gmail.com> #
# Copyright 2017 Simon <spam@esemi.ru> #
# Copyright 2018 Shinichi TAMURA <shnch.tmr@gmail.com> #
# Copyright 2018 Steve Kowalik <steven@wedontsleep.org> #
# Copyright 2018 Wan Liuyang <tsfdye@gmail.com> #
# Copyright 2018 per1234 <accounts@perglass.com> #
# Copyright 2018 sfdye <tsfdye@gmail.com> #
# Copyright 2019 Nick Campbell <nicholas.j.campbell@gmail.com> #
# #
# This file is part of PyGithub. #
# http://pygithub.readthedocs.io/ #
Expand Down Expand Up @@ -50,6 +51,7 @@

import github.Repository
import github.IssueEvent
import github.TimelineEvent
import github.Label
import github.NamedUser
import github.Milestone
Expand Down Expand Up @@ -536,6 +538,19 @@ def create_reaction(self, reaction_type):
)
return github.Reaction.Reaction(self._requester, headers, data, completed=True)

def get_timeline(self):
"""
:calls: `GET /repos/:owner/:repo/issues/:number/timeline <https://developer.github.com/v3/issues/timeline/#list-events-for-an-issue>`_
:return: :class: :class:`github.PaginatedList.PaginatedList` of :class:`github.TimelineEvent.TimelineEvent`
"""
return github.PaginatedList.PaginatedList(
github.TimelineEvent.TimelineEvent,
self._requester,
self.url + "/timeline",
None,
headers={'Accept': Consts.issueTimelineEventsPreview}
)

@property
def _identity(self):
return self.number
Expand Down
156 changes: 156 additions & 0 deletions github/TimelineEvent.py
@@ -0,0 +1,156 @@
# -*- coding: utf-8 -*-

############################ Copyrights and license ############################
# #
# Copyright 2019 Nick Campbell <nicholas.j.campbell@gmail.com> #
# #
# This file is part of PyGithub. #
# http://pygithub.readthedocs.io/ #
# #
# PyGithub is free software: you can redistribute it and/or modify it under #
# the terms of the GNU Lesser General Public License as published by the Free #
# Software Foundation, either version 3 of the License, or (at your option) #
# any later version. #
# #
# PyGithub is distributed in the hope that it will be useful, but WITHOUT ANY #
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS #
# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more #
# details. #
# #
# You should have received a copy of the GNU Lesser General Public License #
# along with PyGithub. If not, see <http://www.gnu.org/licenses/>. #
# #
################################################################################

from __future__ import absolute_import
import github.GithubObject

import github.NamedUser
import github.TimelineEventSource


class TimelineEvent(github.GithubObject.CompletableGithubObject):
"""
This class represents IssueTimelineEvents. The reference can be found here https://developer.github.com/v3/issues/timeline/
"""

def __repr__(self):
return self.get__repr__({"id": self._id.value})

@property
def actor(self):
"""
:type: :class:`github.NamedUser.NamedUser`
"""
self._completeIfNotSet(self._actor)
return self._actor.value

@property
def commit_id(self):
"""
:type: string
"""
self._completeIfNotSet(self._commit_id)
return self._commit_id.value

@property
def created_at(self):
"""
:type: datetime.datetime
"""
self._completeIfNotSet(self._created_at)
return self._created_at.value

@property
def event(self):
"""
:type: string
"""
self._completeIfNotSet(self._event)
return self._event.value

@property
def id(self):
"""
:type: integer
"""
self._completeIfNotSet(self._id)
return self._id.value

@property
def node_id(self):
"""
:type: string
"""
self._completeIfNotSet(self._node_id)
return self._node_id.value

@property
def commit_url(self):
"""
:type: string
"""
self._completeIfNotSet(self._commit_url)
return self._commit_url.value

@property
def source(self):
"""
:type: :class:`github.TimelineEventSource.TimelineEventSource`
"""
# only available on `cross-referenced` events.
if self.event == 'cross-referenced' and hasattr(self, '_source') and self._source is not None:
return self._source.value
return None

@property
def body(self):
"""
:type string
"""
if self.event == 'commented' and hasattr(self, '_body') and self._body is not None:
return self._body.value
return None

@property
def author_association(self):
"""
:type string
"""
if self.event == 'commented' and hasattr(self, '_author_association') and self._author_association is not None:
return self._author_association.value
return None

def _initAttributes(self):
self._actor = github.GithubObject.NotSet
self._commit_id = github.GithubObject.NotSet
self._created_at = github.GithubObject.NotSet
self._event = github.GithubObject.NotSet
self._id = github.GithubObject.NotSet
self._node_id = github.GithubObject.NotSet
self._commit_url = github.GithubObject.NotSet
self._source = github.GithubObject.NotSet
self._body = github.GithubObject.NotSet
self._author_association = github.GithubObject.NotSet

def _useAttributes(self, attributes):
if "actor" in attributes: # pragma no branch
self._actor = self._makeClassAttribute(github.NamedUser.NamedUser, attributes["actor"])
if "commit_id" in attributes: # pragma no branch
self._commit_id = self._makeStringAttribute(attributes["commit_id"])
if "created_at" in attributes: # pragma no branch
self._created_at = self._makeDatetimeAttribute(attributes["created_at"])
if "event" in attributes: # pragma no branch
self._event = self._makeStringAttribute(attributes["event"])
if "id" in attributes: # pragma no branch
self._id = self._makeIntAttribute(attributes["id"])
if "node_id" in attributes: # pragma no branch
self._node_id = self._makeStringAttribute(attributes["node_id"])
if "commit_url" in attributes: # pragma no branch
self._commit_url = self._makeStringAttribute(attributes["commit_url"])
if "source" in attributes: # pragma no branch
self._source = self._makeClassAttribute(github.TimelineEventSource.TimelineEventSource, attributes["source"])
if "body" in attributes: # pragma no branch
self._body = self._makeStringAttribute(attributes["body"])
if "author_association" in attributes: # pragma no branch
self._author_association = self._makeStringAttribute(attributes["author_association"])
63 changes: 63 additions & 0 deletions github/TimelineEventSource.py
@@ -0,0 +1,63 @@
# -*- coding: utf-8 -*-

############################ Copyrights and license ############################
# #
# Copyright 2019 Nick Campbell <nicholas.j.campbell@gmail.com> #
# #
# This file is part of PyGithub. #
# http://pygithub.readthedocs.io/ #
# #
# PyGithub is free software: you can redistribute it and/or modify it under #
# the terms of the GNU Lesser General Public License as published by the Free #
# Software Foundation, either version 3 of the License, or (at your option) #
# any later version. #
# #
# PyGithub is distributed in the hope that it will be useful, but WITHOUT ANY #
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS #
# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more #
# details. #
# #
# You should have received a copy of the GNU Lesser General Public License #
# along with PyGithub. If not, see <http://www.gnu.org/licenses/>. #
# #
################################################################################

from __future__ import absolute_import
import github.GithubObject

import github.Issue


class TimelineEventSource(github.GithubObject.CompletableGithubObject):
"""
This class represents IssueTimelineEventSource. The reference can be found here https://developer.github.com/v3/issues/timeline/
"""

def __repr__(self):
return self.get__repr__({"type": self._type.value})

@property
def type(self):
"""
:type: string
"""
self._completeIfNotSet(self._type)
return self._type.value

@property
def issue(self):
"""
:type: :class:`github.Issue.Issue`
"""
self._completeIfNotSet(self._issue)
return self._issue.value

def _initAttributes(self):
self._type = github.GithubObject.NotSet
self._issue = github.GithubObject.NotSet

def _useAttributes(self, attributes):
if "type" in attributes: # pragma no branch
self._type = self._makeStringAttribute(attributes["type"])
if "issue" in attributes: # pragma no branch
self._issue = self._makeClassAttribute(github.Issue.Issue, attributes["issue"])
13 changes: 12 additions & 1 deletion tests/Issue.py
Expand Up @@ -11,8 +11,9 @@
# Copyright 2016 Jannis Gebauer <ja.geb@me.com> #
# Copyright 2016 Matt Babineau <babineaum@users.noreply.github.com> #
# Copyright 2016 Peter Buckley <dx-pbuckley@users.noreply.github.com> #
# Copyright 2017 Nicolas Agustín Torres <nicolastrres@gmail.com> #
# Copyright 2017 Nicolas Agustín Torres <nicolastrres@gmail.com> #
# Copyright 2018 sfdye <tsfdye@gmail.com> #
# Copyright 2019 Nick Campbell <nicholas.j.campbell@gmail.com> #
# #
# This file is part of PyGithub. #
# http://pygithub.readthedocs.io/ #
Expand Down Expand Up @@ -174,3 +175,13 @@ def testCreateReaction(self):

self.assertEqual(reaction.id, 16917472)
self.assertEqual(reaction.content, "hooray")

def testGetTimeline(self):
events = self.issue.get_timeline()
self.assertIn(events[0].event, ['cross-referenced', 'locked', 'unlocked', 'closed', 'assigned', 'commented', 'subscribed', 'labeled'])
for event in events:
if event.event != "cross-referenced":
self.assertIsNone(event.source)
else:
self.assertIsNotNone(event.source)
self.assertEqual(event.source.type, 'issue')
10 changes: 10 additions & 0 deletions tests/ReplayData/Issue.testGetTimeline.txt

Large diffs are not rendered by default.

0 comments on commit f6f1eda

Please sign in to comment.