Merge pull request atlassian-api#197 from ysfiqbl/feature/update-project

Feature/update project

Author: gonchik

atlassian/jira.py

@@ -290,6 +290,21 @@ def add_project_actor_in_role(self, project_key, role_id, actor, actor_type):
 
         return self.post(url, data=data)
 
+    def update_project(self, project_key, data, expand=None):
+        """
+        Updates a project.
+        Update project: /rest/api/2/project/{projectIdOrKey}
+
+        :param project_key: project key of project that needs to be updated
+        :param data: dictionary containing the data to be updated
+        :param expand: the parameters to expand
+        """
+        if expand:
+            url = '/rest/api/2/project/{projectIdOrKey}?expand={expand}'.format(projectIdOrKey=project_key, expand=expand)
+        else:
+            url = '/rest/api/2/project/{projectIdOrKey}'.format(projectIdOrKey=project_key)
+        return self.put(url, data)
+
     def issue(self, key, fields='*all'):
         return self.get('rest/api/2/issue/{0}?fields={1}'.format(key, fields))
 

docs/jira.rst

@@ -118,6 +118,9 @@ Manage projects
     # Get all assignable users for project
     jira.get_all_assignable_users_for_project(project_key, start=0, limit=50)
 
+    # Update a project
+    jira.update_project(project_key, data, expand='lead,description')
+
 Manage issues
 -------------
 

examples/jira-update-project.py

@@ -0,0 +1,15 @@
+# coding: utf8
+from atlassian import Jira
+
+jira = Jira(
+    url='https://jira.example.com/',
+    username='admin',
+    password='admin'
+)
+
+data = {
+    'permissionScheme': 10001
+}
+
+result = jira.update_project('RD', data)
+print(result)