Add function for getting watchers (atlassian-api#890)

Provides code and documentation for getting watchers for an issue.

Author: jensvog

atlassian/jira.py

@@ -978,6 +978,15 @@ def issue_delete_watcher(self, issue_key, user):
             data=data,
         )
 
+    def issue_get_watchers(self, issue_key):
+        """
+        Get watchers for an issue
+        :param issue_key: Issue Id or Key
+        :return: List of watchers for issue
+        """
+        base_url = self.resource_url("issue")
+        return self.get("{base_url}/{issue_key}/watchers".format(base_url=base_url, issue_key=issue_key))
+
     def assign_issue(self, issue, account_id=None):
         """Assign an issue to a user. None will set it to unassigned. -1 will set it to Automatic.
         :param issue: the issue ID or key to assign

docs/jira.rst

@@ -239,6 +239,9 @@ Manage issues
     # Remove watcher from an issue
     jira.issue_delete_watcher(issue_key, user)
 
+    # Get watchers for an issue
+    jira.issue_get_watchers(issue_key)
+
 
 Manage Boards
 -------------