[Jira] Implement jira.update_version (atlassian-api#878)

* [Jira] Implement jira.update_version

* [Jira] Fix formatting on jira.update_version

Author: ludviz

atlassian/jira.py

@@ -1786,6 +1786,36 @@ def delete_version(self, version, moved_fixed=None, move_affected=None):
         payload = {"moveFixIssuesTo": moved_fixed, "moveAffectedIssuesTo": move_affected}
         return self.delete("rest/api/2/version/{}".format(version), data=payload)
 
+    def update_version(
+        self,
+        version,
+        name=None,
+        description=None,
+        is_archived=None,
+        is_released=None,
+        start_date=None,
+        release_date=None,
+    ):
+        """
+        Update a project version
+        :param version: The version id to update
+        :param name: The version name
+        :param description: The version description
+        :param is_archived:
+        :param is_released:
+        :param startDate: The Start Date in isoformat. Example value is "2015-04-11T15:22:00.000+10:00"
+        :param releaseDate: The Release Date in isoformat. Example value is "2015-04-11T15:22:00.000+10:00"
+        """
+        payload = {
+            "name": name,
+            "description": description,
+            "archived": is_archived,
+            "released": is_released,
+            "startDate": start_date,
+            "releaseDate": release_date,
+        }
+        return self.put("rest/api/3/version/{}".format(version), data=payload)
+
     def get_project_roles(self, project_key):
         """
         Provide associated project roles

docs/jira.rst

@@ -104,6 +104,9 @@ Manage projects
     # Add missing version to project
     jira.add_version(key, project_id, version, is_archived=False, is_released=False)
 
+    # Update an existing version
+    jira.update_version(version, name=None, description=None, is_archived=None, is_released=None, start_date=None, release_date=None)
+
     # Get project leaders
     jira.project_leaders()