Jira: add parameters to query string i.o. request data. (#585)

* Update jira.py

Bugfix: pass parameters to query string i.o. request data.
Add additional parameters.

* Add 'query' and 'status' filters' to "get project versions paginated"

More info can be found at:
https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-project-versions/#api-rest-api-2-project-projectidorkey-version-get

Author: FrankStappers

atlassian/jira.py

@@ -1438,7 +1438,7 @@ def get_project_versions(self, key, expand=None):
             params['expand'] = expand
         return self.get('rest/api/2/project/{}/versions'.format(key), params=params)
 
-    def get_project_versions_paginated(self, key, start=None, limit=None, order_by=None, expand=None):
+    def get_project_versions_paginated(self, key, start=None, limit=None, order_by=None, expand=None, query=None, status=None):
         """
         Returns all versions for the specified project. Results are paginated.
         Results can be ordered by the following fields:
@@ -1451,6 +1451,8 @@ def get_project_versions_paginated(self, key, start=None, limit=None, order_by=N
         :param limit: how many results on the page should be included. Defaults to 50.
         :param order_by: ordering of the results.
         :param expand: the parameters to expand
+        :param query: Filter the results using a literal string. Versions with matching name or description are returned (case insensitive).
+        :param status: A list of status values used to filter the results by version status. This parameter accepts a comma-separated list. The status values are released, unreleased, and archived..
         :return:
         """
         params = {}
@@ -1462,7 +1464,11 @@ def get_project_versions_paginated(self, key, start=None, limit=None, order_by=N
             params['orderBy'] = order_by
         if expand is not None:
             params['expand'] = expand
-        return self.get('rest/api/2/project/{}/version'.format(key), params)
+        if query is not None:
+            params['query'] = query
+        if status in ['released', 'unreleased', 'archived']:
+            params['status'] = status
+        return self.get('rest/api/2/project/{}/version'.format(key), params=params)
 
     def add_version(self, project_key, project_id, version, is_archived=False, is_released=False):
         """

docs/jira.rst

@@ -98,7 +98,8 @@ Manage projects
 
     # Returns all versions for the specified project. Results are paginated.
     # Results can be ordered by the following fields: sequence, name, startDate, releaseDate.
-    jira.get_project_versions_paginated(key, start=None, limit=None, order_by=None, expand=None)
+    # Results can be filtered by the following fields: query, status.
+    jira.get_project_versions_paginated(key, start=None, limit=None, order_by=None, expand=None, query=None, status=None)
 
     # Add missing version to project
     jira.add_version(key, project_id, version, is_archived=False, is_released=False)