simahawk
diff --git a/‎github3/events.py
Lines changed: 72 additions & 2 deletions b/‎github3/events.py
Lines changed: 72 additions & 2 deletions
diff --git a/‎github3/issues/comment.py
Lines changed: 92 additions & 24 deletions b/‎github3/issues/comment.py
Lines changed: 92 additions & 24 deletions
diff --git a/‎tests/cassettes/PullRequest_create_comment.json
Lines changed: 1 addition & 1 deletion b/‎tests/cassettes/PullRequest_create_comment.json
Lines changed: 1 addition & 1 deletion
@@ -292,6 +292,77 @@ def to_issue(self):
     refresh = to_issue
 
 
+class EventIssueComment(models.GitHubCore):
+    """Representation of a comment left on an issue.
+
+    See also: http://developer.github.com/v3/issues/comments/
+
+    This object has the following attributes:
+
+    .. attribute:: author_association
+
+        The association of the author (:attr:`user`) with the repository
+        this issue belongs to.
+
+    .. attribute:: body
+
+        The markdown formatted original text written by the author.
+
+    .. attribute:: created_at
+
+        A :class:`~datetime.datetime` object representing the date and time
+        when this comment was created.
+
+    .. attribute:: html_url
+
+        The URL to view this comment in a browser.
+
+    .. attribute:: id
+
+        The unique identifier for this comment.
+
+    .. attribute:: issue_url
+
+        The URL of the parent issue in the API.
+
+    .. attribute:: updated_at
+
+        A :class:`~datetime.datetime` object representing the date and time
+        when this comment was most recently updated.
+
+    .. attribute:: user
+
+        A :class:`~github3.users.ShortUser` representing the author of this
+        comment.
+    """
+
+    def _update_attributes(self, comment):
+        from . import users
+        self._api = comment['url']
+        self.author_association = comment['author_association']
+        self.body = comment['body']
+        self.created_at = self._strptime(comment['created_at'])
+        self.html_url = comment['html_url']
+        self.id = comment['id']
+        self.issue_url = comment['issue_url']
+        self.updated_at = self._strptime(comment['updated_at'])
+        self.user = users.ShortUser(comment['user'], self)
+
+    def to_issue_comment(self):
+        """Retrieve the full IssueComment object for this comment.
+
+        :returns:
+            All the information about an IssueComment.
+        :rtype:
+            :class:`~github3.issues.comment.IssueComment`
+        """
+        from .issues import comment
+        json = self._json(self._get(self.url), 200)
+        return self._instance_or_null(comment.IssueComment, json)
+
+    refresh = to_issue_comment
+
+
 class Event(models.GitHubCore):
     """Represents an event as returned by the API.
 
@@ -411,11 +482,10 @@ def _gist(payload, session):
 
 
 def _issuecomm(payload, session):
-    from .issues.comment import IssueComment
     if payload.get('issue'):
         payload['issue'] = EventIssue(payload['issue'], session)
     if payload.get('comment'):
-        payload['comment'] = IssueComment(payload['comment'], session)
+        payload['comment'] = EventIssueComment(payload['comment'], session)
     return payload
 
 
 
@@ -1,46 +1,114 @@
 # -*- coding: utf-8 -*-
+"""Module with class(es) representing issue comments."""
 from __future__ import unicode_literals
 
+from .. import decorators
+from .. import models
 from .. import users
-from ..utils import timestamp_parameter
-from ..models import BaseComment
+from .. import utils
 
 
-class IssueComment(BaseComment):
-    """The :class:`IssueComment <IssueComment>` object. This structures and
-    handles the comments on issues specifically.
+class IssueComment(models.GitHubCore):
+    """Representation of a comment left on an issue.
 
-    Two comment instances can be checked like so::
+    See also: http://developer.github.com/v3/issues/comments/
 
-        c1 == c2
-        c1 != c2
+    This object has the following attributes:
 
-    And is equivalent to::
+    .. attribute:: author_association
 
-        c1.id == c2.id
-        c1.id != c2.id
+        The association of the author (:attr:`user`) with the repository
+        this issue belongs to.
 
-    See also: http://developer.github.com/v3/issues/comments/
+    .. attribute:: body
+
+        The markdown formatted original text written by the author.
+
+    .. attribute:: body_html
+
+        The HTML formatted comment body.
+
+    .. attribute:: body_text
+
+        The plain-text formatted comment body.
+
+    .. attribute:: created_at
+
+        A :class:`~datetime.datetime` object representing the date and time
+        when this comment was created.
+
+    .. attribute:: html_url
+
+        The URL to view this comment in a browser.
+
+    .. attribute:: id
+
+        The unique identifier for this comment.
+
+    .. attribute:: issue_url
+
+        The URL of the parent issue in the API.
+
+    .. attribute:: updated_at
+
+        A :class:`~datetime.datetime` object representing the date and time
+        when this comment was most recently updated.
+
+    .. attribute:: user
+
+        A :class:`~github3.users.ShortUser` representing the author of this
+        comment.
     """
+
     def _update_attributes(self, comment):
-        super(IssueComment, self)._update_attributes(comment)
+        self._api = comment['url']
+        self.author_association = comment['author_association']
+        self.body = comment['body']
+        self.body_html = comment['body_html']
+        self.body_text = comment['body_text']
+        self.created_at = self._strptime(comment['created_at'])
+        self.html_url = comment['html_url']
+        self.id = comment['id']
+        self.issue_url = comment['issue_url']
+        self.updated_at = self._strptime(comment['updated_at'])
+        self.user = users.ShortUser(comment['user'], self)
 
-        #: :class:`User <github3.users.User>` who made the comment
-        self.user = self._class_attribute(
-            comment, 'user', users.ShortUser, self,
-        )
+    def _repr(self):
+        return '<IssueComment [{0}]>'.format(self.user.login)
 
-        #: Issue url (not a template)
-        self.issue_url = self._get_attribute(comment, 'issue_url')
+    @decorators.requires_auth
+    def delete(self):
+        """Delete this comment.
 
-        #: Html url (not a template)
-        self.html_url = self._get_attribute(comment, 'html_url')
+        :returns: bool
+        """
+        return self._boolean(self._delete(self._api), 204, 404)
 
-    def _repr(self):
-        return '<Issue Comment [{0}]>'.format(self.user.login)
+    @decorators.requires_auth
+    def edit(self, body):
+        """Edit this comment.
+
+        :param str body: (required), new body of the comment, Markdown
+            formatted
+        :returns: bool
+        """
+        if body:
+            json = self._json(self._patch(self._api,
+                                          json={'body': body}), 200)
+            if json:
+                self._update_attributes(json)
+                return True
+        return False
 
 
 def issue_comment_params(sort, direction, since):
+    """Properly format parameters for issue comments.
+
+    .. warning::
+
+        This is not a public API designed for users of github3.py.
+
+    """
     params = {}
 
     if sort in ('created', 'updated'):
@@ -49,7 +117,7 @@ def issue_comment_params(sort, direction, since):
     if direction in ('asc', 'desc'):
         params['direction'] = direction
 
-    since = timestamp_parameter(since)
+    since = utils.timestamp_parameter(since)
     if since:
         params['since'] = since