Bitbucket: add get_users; add example; add to documentation (#429)

Author: djachkov

atlassian/bitbucket.py

@@ -1657,3 +1657,9 @@ def get_lfs_repo_status(self, project_key, repo):
             projectKey=project_key,
             repositorySlug=repo)
         return self.get(url)
+
+    def get_users(self, user_filter=None):
+        url = "/rest/api/1.0/users"
+        if user_filter: 
+            url += "?filter={}".format(user_filter)
+        return self.get(url)

docs/bitbucket.rst

@@ -100,6 +100,9 @@ Groups and admins
     # All project administrators
     bitbucket.all_project_administrators()
 
+    # Get users. Use 'user_filter' parameter to get specific users. 
+    bitbucket.get_users(user_filter="username")
+
 Manage code
 -----------
 

examples/bitbucket-users.py

@@ -0,0 +1,11 @@
+# coding=utf-8
+from atlassian import Bitbucket
+
+
+bitbucket = Bitbucket(
+    url='http://localhost:7990',
+    username='admin',
+    password='admin')
+
+data = bitbucket.get_users(user_filter="username")
+print(data)