Updated spec

Author: rob

dropbox/base.py

@@ -140,7 +140,7 @@ def file_properties_properties_remove(self,
                                           property_template_ids):
         """
         Remove the specified property group from the file. To remove specific
-        property field key value pairs, see route
+        property field key value pairs, see
         :meth:`file_properties_properties_update`. To update a template, see
         :meth:`file_properties_templates_update_for_user` or
         :meth:`file_properties_templates_update_for_team`. Templates can't be
@@ -228,7 +228,7 @@ def file_properties_templates_add_for_team(self,
                                                description,
                                                fields):
         """
-        Add a template associated with a team. See route
+        Add a template associated with a team. See
         :meth:`file_properties_properties_add` to add properties to a file or
         folder.
 
@@ -254,8 +254,9 @@ def file_properties_templates_add_for_user(self,
                                                description,
                                                fields):
         """
-        Add a template associated with a user. See route
-        :meth:`file_properties_properties_add` to add properties to a file.
+        Add a template associated with a user. See
+        :meth:`file_properties_properties_add` to add properties to a file. This
+        endpoint can't be called on a team member or admin's behalf.
 
         :rtype: :class:`dropbox.file_properties.AddTemplateResult`
         :raises: :class:`dropbox.exceptions.ApiError`
@@ -300,7 +301,8 @@ def file_properties_templates_get_for_team(self,
     def file_properties_templates_get_for_user(self,
                                                template_id):
         """
-        Get the schema for a specified template.
+        Get the schema for a specified template. This endpoint can't be called
+        on a team member or admin's behalf.
 
         :param str template_id: An identifier for template added by route  See
             :meth:`file_properties_templates_add_for_user` or
@@ -343,7 +345,8 @@ def file_properties_templates_list_for_team(self):
     def file_properties_templates_list_for_user(self):
         """
         Get the template identifiers for a team. To get the schema of each
-        template use :meth:`file_properties_templates_get_for_user`.
+        template use :meth:`file_properties_templates_get_for_user`. This
+        endpoint can't be called on a team member or admin's behalf.
 
         :rtype: :class:`dropbox.file_properties.ListTemplateResult`
         :raises: :class:`dropbox.exceptions.ApiError`
@@ -406,7 +409,8 @@ def file_properties_templates_update_for_user(self,
         """
         Update a template associated with a user. This route can update the
         template name, the template description and add optional properties to
-        templates.
+        templates. This endpoint can't be called on a team member or admin's
+        behalf.
 
         :param str template_id: An identifier for template added by  See
             :meth:`file_properties_templates_add_for_user` or
@@ -1256,6 +1260,7 @@ def files_get_thumbnail_batch(self,
 
     def files_list_folder(self,
                           path,
+                          shared_link=None,
                           recursive=False,
                           include_media_info=False,
                           include_deleted=False,
@@ -1289,6 +1294,10 @@ def files_list_folder(self,
         until the previous request finishes.
 
         :param str path: A unique identifier for the file.
+        :param Nullable shared_link: A shared link to list the contents of, if
+            the link is protected provide the password. if this field is
+            present, ``ListFolderArg.path`` will be relative to root of the
+            shared link. Only non-recursive mode is supported for shared link.
         :param bool recursive: If true, the list folder operation will be
             applied recursively to all subfolders and the response will contain
             contents of all subfolders.
@@ -1312,6 +1321,7 @@ def files_list_folder(self,
             :class:`dropbox.files.ListFolderError`
         """
         arg = files.ListFolderArg(path,
+                                  shared_link,
                                   recursive,
                                   include_media_info,
                                   include_deleted,
@@ -1352,6 +1362,7 @@ def files_list_folder_continue(self,
 
     def files_list_folder_get_latest_cursor(self,
                                             path,
+                                            shared_link=None,
                                             recursive=False,
                                             include_media_info=False,
                                             include_deleted=False,
@@ -1366,6 +1377,10 @@ def files_list_folder_get_latest_cursor(self,
         files that already exist in Dropbox.
 
         :param str path: A unique identifier for the file.
+        :param Nullable shared_link: A shared link to list the contents of, if
+            the link is protected provide the password. if this field is
+            present, ``ListFolderArg.path`` will be relative to root of the
+            shared link. Only non-recursive mode is supported for shared link.
         :param bool recursive: If true, the list folder operation will be
             applied recursively to all subfolders and the response will contain
             contents of all subfolders.
@@ -1389,6 +1404,7 @@ def files_list_folder_get_latest_cursor(self,
             :class:`dropbox.files.ListFolderError`
         """
         arg = files.ListFolderArg(path,
+                                  shared_link,
                                   recursive,
                                   include_media_info,
                                   include_deleted,

dropbox/base_team.py

@@ -1418,8 +1418,8 @@ def team_team_folder_archive_check(self,
     def team_team_folder_create(self,
                                 name):
         """
-        Creates a new, active, team folder. Permission : Team member file
-        access.
+        Creates a new, active, team folder with no members. Permission : Team
+        member file access.
 
         :param str name: Name for the new team folder.
         :rtype: :class:`dropbox.team.TeamFolderMetadata`

dropbox/common.py

@@ -274,6 +274,8 @@ def __repr__(self):
 DisplayNameLegacy_validator = bv.String(min_length=1)
 DropboxTimestamp_validator = bv.Timestamp(u'%Y-%m-%dT%H:%M:%SZ')
 EmailAddress_validator = bv.String(max_length=255, pattern=u"^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
+# A ISO639-1 code.
+LanguageCode_validator = bv.String(min_length=2)
 NamePart_validator = bv.String(min_length=1, max_length=100, pattern=u'[^/:?*<>"|]*')
 NamespaceId_validator = bv.String(pattern=u'[-_0-9a-zA-Z:]+')
 OptionalNamePart_validator = bv.String(max_length=100, pattern=u'[^/:?*<>"|]*')

dropbox/file_properties.py

@@ -183,8 +183,8 @@ class PropertiesError(TemplateError):
     return true. To get the associated value of a tag (if one exists), use the
     corresponding ``get_*`` method.
 
-    :ivar unsupported_folder: This folder cannot be tagged. Shared folders and
-        team folders are not supported for team-owned tags.
+    :ivar unsupported_folder: This folder cannot be tagged. Tagging folders is
+        not supported for team-owned templates.
     """
 
     # Attribute is overwritten below the class definition

dropbox/file_requests.py

@@ -4,7 +4,6 @@
 # pylint: skip-file
 """
 This namespace contains endpoints and data types for file request operations.
-Warning: This namespace is in beta and is subject to backwards-incompatible changes.
 """
 
 try:

dropbox/files.py

@@ -3471,6 +3471,10 @@ def __repr__(self):
 class ListFolderArg(object):
     """
     :ivar path: A unique identifier for the file.
+    :ivar shared_link: A shared link to list the contents of, if the link is
+        protected provide the password. if this field is present,
+        ``ListFolderArg.path`` will be relative to root of the shared link. Only
+        non-recursive mode is supported for shared link.
     :ivar recursive: If true, the list folder operation will be applied
         recursively to all subfolders and the response will contain contents of
         all subfolders.
@@ -3492,6 +3496,8 @@ class ListFolderArg(object):
     __slots__ = [
         '_path_value',
         '_path_present',
+        '_shared_link_value',
+        '_shared_link_present',
         '_recursive_value',
         '_recursive_present',
         '_include_media_info_value',
@@ -3510,6 +3516,7 @@ class ListFolderArg(object):
 
     def __init__(self,
                  path=None,
+                 shared_link=None,
                  recursive=None,
                  include_media_info=None,
                  include_deleted=None,
@@ -3518,6 +3525,8 @@ def __init__(self,
                  limit=None):
         self._path_value = None
         self._path_present = False
+        self._shared_link_value = None
+        self._shared_link_present = False
         self._recursive_value = None
         self._recursive_present = False
         self._include_media_info_value = None
@@ -3532,6 +3541,8 @@ def __init__(self,
         self._limit_present = False
         if path is not None:
             self.path = path
+        if shared_link is not None:
+            self.shared_link = shared_link
         if recursive is not None:
             self.recursive = recursive
         if include_media_info is not None:
@@ -3568,6 +3579,35 @@ def path(self):
         self._path_value = None
         self._path_present = False
 
+    @property
+    def shared_link(self):
+        """
+        A shared link to list the contents of, if the link is protected provide
+        the password. if this field is present, ``ListFolderArg.path`` will be
+        relative to root of the shared link. Only non-recursive mode is
+        supported for shared link.
+
+        :rtype: SharedLink
+        """
+        if self._shared_link_present:
+            return self._shared_link_value
+        else:
+            return None
+
+    @shared_link.setter
+    def shared_link(self, val):
+        if val is None:
+            del self.shared_link
+            return
+        self._shared_link_validator.validate_type_only(val)
+        self._shared_link_value = val
+        self._shared_link_present = True
+
+    @shared_link.deleter
+    def shared_link(self):
+        self._shared_link_value = None
+        self._shared_link_present = False
+
     @property
     def recursive(self):
         """
@@ -3716,8 +3756,9 @@ def limit(self):
         self._limit_present = False
 
     def __repr__(self):
-        return 'ListFolderArg(path={!r}, recursive={!r}, include_media_info={!r}, include_deleted={!r}, include_has_explicit_shared_members={!r}, include_mounted_folders={!r}, limit={!r})'.format(
+        return 'ListFolderArg(path={!r}, shared_link={!r}, recursive={!r}, include_media_info={!r}, include_deleted={!r}, include_has_explicit_shared_members={!r}, include_mounted_folders={!r}, limit={!r})'.format(
             self._path_value,
+            self._shared_link_value,
             self._recursive_value,
             self._include_media_info_value,
             self._include_deleted_value,
@@ -7141,6 +7182,90 @@ def __repr__(self):
 
 SearchResult_validator = bv.Struct(SearchResult)
 
+class SharedLink(object):
+    """
+    :ivar url: Shared link url.
+    :ivar password: Password for the shared link.
+    """
+
+    __slots__ = [
+        '_url_value',
+        '_url_present',
+        '_password_value',
+        '_password_present',
+    ]
+
+    _has_required_fields = True
+
+    def __init__(self,
+                 url=None,
+                 password=None):
+        self._url_value = None
+        self._url_present = False
+        self._password_value = None
+        self._password_present = False
+        if url is not None:
+            self.url = url
+        if password is not None:
+            self.password = password
+
+    @property
+    def url(self):
+        """
+        Shared link url.
+
+        :rtype: str
+        """
+        if self._url_present:
+            return self._url_value
+        else:
+            raise AttributeError("missing required field 'url'")
+
+    @url.setter
+    def url(self, val):
+        val = self._url_validator.validate(val)
+        self._url_value = val
+        self._url_present = True
+
+    @url.deleter
+    def url(self):
+        self._url_value = None
+        self._url_present = False
+
+    @property
+    def password(self):
+        """
+        Password for the shared link.
+
+        :rtype: str
+        """
+        if self._password_present:
+            return self._password_value
+        else:
+            return None
+
+    @password.setter
+    def password(self, val):
+        if val is None:
+            del self.password
+            return
+        val = self._password_validator.validate(val)
+        self._password_value = val
+        self._password_present = True
+
+    @password.deleter
+    def password(self):
+        self._password_value = None
+        self._password_present = False
+
+    def __repr__(self):
+        return 'SharedLink(url={!r}, password={!r})'.format(
+            self._url_value,
+            self._password_value,
+        )
+
+SharedLink_validator = bv.Struct(SharedLink)
+
 class ThumbnailArg(object):
     """
     :ivar path: The path to the image file you want to thumbnail.
@@ -8662,7 +8787,7 @@ class WriteError(bb.Union):
         (bytes) to write more data.
     :ivar disallowed_name: Dropbox will not save the file or folder because of
         its name.
-    :ivar team_folder: This endpoint cannot modify or delete team folders.
+    :ivar team_folder: This endpoint cannot move or delete team folders.
     """
 
     _catch_all = 'other'
@@ -8881,6 +9006,7 @@ def __repr__(self):
 ReadPath_validator = bv.String(pattern=u'(/(.|[\\r\\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)')
 Rev_validator = bv.String(min_length=9, pattern=u'[0-9a-f]+')
 Sha256HexHash_validator = bv.String(min_length=64, max_length=64)
+SharedLinkUrl_validator = bv.String()
 WritePath_validator = bv.String(pattern=u'(/(.|[\\r\\n])*)|(ns:[0-9]+(/.*)?)')
 WritePathOrId_validator = bv.String(pattern=u'(/(.|[\\r\\n])*)|(ns:[0-9]+(/.*)?)|(id:.*)')
 GetMetadataArg._path_validator = ReadPath_validator
@@ -9296,6 +9422,7 @@ def __repr__(self):
 ]
 
 ListFolderArg._path_validator = PathROrId_validator
+ListFolderArg._shared_link_validator = bv.Nullable(SharedLink_validator)
 ListFolderArg._recursive_validator = bv.Boolean()
 ListFolderArg._include_media_info_validator = bv.Boolean()
 ListFolderArg._include_deleted_validator = bv.Boolean()
@@ -9304,6 +9431,7 @@ def __repr__(self):
 ListFolderArg._limit_validator = bv.Nullable(bv.UInt32(min_value=1, max_value=2000))
 ListFolderArg._all_field_names_ = set([
     'path',
+    'shared_link',
     'recursive',
     'include_media_info',
     'include_deleted',
@@ -9313,6 +9441,7 @@ def __repr__(self):
 ])
 ListFolderArg._all_fields_ = [
     ('path', ListFolderArg._path_validator),
+    ('shared_link', ListFolderArg._shared_link_validator),
     ('recursive', ListFolderArg._recursive_validator),
     ('include_media_info', ListFolderArg._include_media_info_validator),
     ('include_deleted', ListFolderArg._include_deleted_validator),
@@ -9812,6 +9941,17 @@ def __repr__(self):
     ('start', SearchResult._start_validator),
 ]
 
+SharedLink._url_validator = SharedLinkUrl_validator
+SharedLink._password_validator = bv.Nullable(bv.String())
+SharedLink._all_field_names_ = set([
+    'url',
+    'password',
+])
+SharedLink._all_fields_ = [
+    ('url', SharedLink._url_validator),
+    ('password', SharedLink._password_validator),
+]
+
 ThumbnailArg._path_validator = ReadPath_validator
 ThumbnailArg._format_validator = ThumbnailFormat_validator
 ThumbnailArg._size_validator = ThumbnailSize_validator