adding support for shared_link password parameter

Author: Frencil

boxsdk/object/item.py

@@ -159,7 +159,7 @@ def move(self, parent_folder):
         }
         return self.update_info(data)
 
-    def get_shared_link(self, access=None, etag=None, unshared_at=None, allow_download=None, allow_preview=None):
+    def get_shared_link(self, access=None, etag=None, unshared_at=None, password=None, allow_download=None, allow_preview=None):
         """Get a shared link for the item with the given access permissions.
 
         :param access:
@@ -176,6 +176,10 @@ def get_shared_link(self, access=None, etag=None, unshared_at=None, allow_downlo
             and has permission to set expiration dates.
         :type unshared_at:
             :class:`datetime.date` or None
+        :param password:
+            The password required to view this link. If no password is specified, the default password will be used.
+        :type password:
+            `unicode` or None
         :param allow_download:
             Whether or not the item being shared can be downloaded when accessed via the shared link.
             If this parameter is None, the default setting will be used.
@@ -201,6 +205,9 @@ def get_shared_link(self, access=None, etag=None, unshared_at=None, allow_downlo
         if unshared_at is not None:
             data['shared_link']['unshared_at'] = unshared_at.isoformat()
 
+        if password is not None:
+            data['shared_link']['password'] = password
+
         if allow_download is not None or allow_preview is not None:
             data['shared_link']['permissions'] = permissions = {}
             if allow_download is not None:

test/unit/object/test_item.py

@@ -71,6 +71,11 @@ def shared_link_access(request):
     return request.param
 
 
+@pytest.fixture(params=('hunter2', None))
+def shared_link_password(request):
+    return request.param
+
+
 @pytest.fixture(params=(date(2015, 5, 5), None))
 def shared_link_unshared_at(request):
     return request.param
@@ -81,6 +86,7 @@ def test_get_shared_link(
         mock_box_session,
         shared_link_access,
         shared_link_unshared_at,
+        shared_link_password,
         shared_link_can_download,
         shared_link_can_preview,
         test_url,
@@ -96,6 +102,8 @@ def test_get_shared_link(
         expected_data['shared_link']['access'] = shared_link_access
     if shared_link_unshared_at is not None:
         expected_data['shared_link']['unshared_at'] = shared_link_unshared_at.isoformat()
+    if shared_link_password is not None:
+        expected_data['shared_link']['password'] = shared_link_password
     if shared_link_can_download is not None or shared_link_can_preview is not None:
         expected_data['shared_link']['permissions'] = permissions = {}
         if shared_link_can_download is not None:
@@ -106,6 +114,7 @@ def test_get_shared_link(
         etag=etag,
         access=shared_link_access,
         unshared_at=shared_link_unshared_at,
+        password=shared_link_password,
         allow_download=shared_link_can_download,
         allow_preview=shared_link_can_preview,
     )