Feature/update user (#369)

* added user update function

* Updated README with new user update function

Co-authored-by: Davie De Smet <[email protected]>

Author: ddesmet

README.md

@@ -179,6 +179,7 @@ $iss = new IssueService(new ArrayConfiguration(
 - [Find Assignable Users](#find-assignable-users)
 - [Find Users by query](#find-users-by-query)
 - [Delete User](#delete-user)
+- [Update User](#update-user)
 
 ### Group
 - [Create Group](#create-group)
@@ -1903,6 +1904,42 @@ try {
 
 ```
 
+#### update User
+
+[See Jira API reference](https://docs.atlassian.com/software/jira/docs/api/REST/latest/#api/2/user-updateUser)
+
+Updates user.
+
+```php
+<?php
+require 'vendor/autoload.php';
+
+use JiraRestApi\JiraException;
+use JiraRestApi\User\UserService;
+
+try {
+    $us = new UserService();
+
+    $paramArray = ['username' => '[email protected]'];
+
+    // create new user
+    $user = [
+            'name'=>'charli',
+            'password' => 'abracada',
+            'emailAddress' => '[email protected]',
+            'displayName' => 'Charli of Atlassian',
+        ];
+
+    $updatedUser = $us->update($paramArray, $user)
+
+    var_dump($updatedUser);
+
+} catch (JiraRestApi\JiraException $e) {
+    print("Error Occured! " . $e->getMessage());
+}
+
+```
+
 #### Create Group
 
 [See Jira API reference](https://docs.atlassian.com/software/jira/docs/api/REST/latest/#api/2/group-createGroup)

src/User/UserService.php

@@ -222,4 +222,31 @@ public function getUsers($paramArray)
 
         return $users;
     }
+
+    /**
+     * Function to update an existing user.
+     *
+     * @param array $paramArray
+     * @param User|array $user
+     *
+     * @throws \JiraRestApi\JiraException
+     * @throws \JsonMapper_Exception
+     *
+     * @return User User class
+     */
+    public function update($paramArray, $user)
+    {
+        $queryParam = '?'.http_build_query($paramArray);
+
+        $data = json_encode($user);
+
+        $this->log->info("Update User (".$queryParam.") =\n".$data);
+
+        $ret = $this->exec($this->uri.$queryParam, $data, 'PUT');
+
+        return $this->json_mapper->map(
+            json_decode($ret),
+            new User()
+        );
+    }
 }