add issues_assigned and issues_authored relations (issue #317)

Author: maxtepkeev

CHANGELOG.rst

@@ -14,6 +14,8 @@ Changelog
 
 - Migrated CI to GitHub Actions, also we now test not only on Linux, but on macOS and Windows as well
 - ``dir(resource)`` and ``list(resource)`` now also show properties of an object
+- Support for ``issues_assigned`` and ``issues_authored`` relations in User object
+  (`Issue #317 <https://github.com/maxtepkeev/python-redmine/issues/317>`__)
 - *Pro Edition:* Added support for RedmineUP DealCategory ``create()``, ``update()``, ``delete()`` operations
   (see `docs <https://python-redmine.com/resources/deal_category.html#create-methods>`__ for details)
 - *Pro Edition:* RedmineUP CrmQuery resource now supports ``invoices`` and ``expenses`` relation attributes

docs/resources/issue.rst

@@ -287,6 +287,21 @@ filter
       >>> project.issues
       <redminelib.resultsets.ResourceSet object with Issue resources>
 
+   .. versionadded:: 2.5.0
+
+   Apart from ``issues`` relation a User resource object provides ``issues_assigned`` which is an alias
+   to ``issues`` relation and ``issues_authored`` relation which returns Issue objects authored by a user:
+
+   .. code-block:: python
+
+      >>> user = redmine.user.get(9)
+      >>> user.issues
+      <redminelib.resultsets.ResourceSet object with Issue resources>
+      >>> user.issues_assigned
+      <redminelib.resultsets.ResourceSet object with Issue resources>
+      >>> user.issues_authored
+      <redminelib.resultsets.ResourceSet object with Issue resources>
+
 Update methods
 --------------
 

docs/resources/user.rst

@@ -154,8 +154,10 @@ get
    resource objects wrapped in a :ref:`ResourceSet` which are somehow related to a User
    resource object. The relations provided by the User resource object are:
 
-   * issues
    * time_entries
+   * issues (alias to issues_assigned)
+   * issues_assigned (requires Python-Redmine v2.5.0)
+   * issues_authored (requires Python-Redmine v2.5.0)
    * deals (requires Pro Edition and `CRM plugin <https://www.redmineup.com/pages/plugins/crm>`_)
    * contacts (requires Pro Edition and `CRM plugin <https://www.redmineup.com/pages/plugins/crm>`_)
    * invoices (requires Pro Edition and `Invoices plugin <https://www.redmineup.com/pages/plugins/invoices>`_

redminelib/resources/standard.py

@@ -419,7 +419,7 @@ class User(BaseResource):
 
     _repr = [['id', 'firstname', 'lastname'], ['id', 'name']]
     _includes = ['memberships', 'groups']
-    _relations = ['issues', 'time_entries']
+    _relations = ['issues', 'issues_assigned', 'issues_authored', 'time_entries']
     _relations_name = 'assigned_to'
     _unconvertible = ['status']
     _create_readonly = BaseResource._create_readonly + ['api_key', 'last_login_on']
@@ -429,12 +429,18 @@ class User(BaseResource):
         'groups': 'Group',
         'memberships': 'ProjectMembership',
         'issues': 'Issue',
+        'issues_assigned': 'Issue',
+        'issues_authored': 'Issue',
         'time_entries': 'TimeEntry',
     }
 
     def __getattr__(self, attr):
-        if attr == 'time_entries' and attr not in self._encoded_attrs:
-            self._relations_name = 'user'
+        if attr in self._relations and attr not in self._encoded_attrs:
+            if attr == 'issues_authored':
+                self._relations_name = 'author'
+            elif attr == 'time_entries':
+                self._relations_name = 'user'
+
             value = super().__getattr__(attr)
             self._relations_name = 'assigned_to'
             return value

tests/test_resources_standard.py

@@ -1409,6 +1409,8 @@ def test_user_relations(self):
         self.response.json.return_value = responses['user']['get']
         user = self.redmine.user.get(1)
         self.assertIsInstance(user.issues, resultsets.ResourceSet)
+        self.assertIsInstance(user.issues_assigned, resultsets.ResourceSet)
+        self.assertIsInstance(user.issues_authored, resultsets.ResourceSet)
         self.assertIsInstance(user.time_entries, resultsets.ResourceSet)
 
     def test_user_includes(self):