Updated spec

starforever · starforever · commit 86d1c55f1e90 · 2018-11-20T17:13:08.000-08:00
diff --git a/docs/moduledoc.rst b/docs/moduledoc.rst
@@ -26,6 +26,14 @@ SDK Documentation
    :special-members: __init__
    :undoc-members:
 
+:mod:`dropbox.contacts` -- Contacts
+============================================
+.. automodule:: dropbox.contacts
+   :members:
+   :show-inheritance:
+   :special-members: __init__
+   :undoc-members:
+
 :mod:`dropbox.dropbox` -- Dropbox
 ============================================
 .. automodule:: dropbox.dropbox
diff --git a/dropbox/base.py b/dropbox/base.py
@@ -10,6 +10,7 @@
     async_,
     auth,
     common,
+    contacts,
     file_properties,
     file_requests,
     files,
@@ -76,6 +77,48 @@ def auth_token_revoke(self):
         )
         return None
 
+    # ------------------------------------------
+    # Routes in contacts namespace
+
+    def contacts_delete_manual_contacts(self):
+        """
+        Removes all manually added contacts. You'll still keep contacts who are
+        on your team or who you imported. New contacts will be added when you
+        share.
+
+        :rtype: None
+        """
+        arg = None
+        r = self.request(
+            contacts.delete_manual_contacts,
+            'contacts',
+            arg,
+            None,
+        )
+        return None
+
+    def contacts_delete_manual_contacts_batch(self,
+                                              email_addresses):
+        """
+        Removes manually added contacts from the given list.
+
+        :param list email_addresses: List of manually added contacts to be
+            deleted.
+        :rtype: None
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.contacts.DeleteManualContactsError`
+        """
+        arg = contacts.DeleteManualContactsArg(email_addresses)
+        r = self.request(
+            contacts.delete_manual_contacts_batch,
+            'contacts',
+            arg,
+            None,
+        )
+        return None
+
     # ------------------------------------------
     # Routes in file_properties namespace
 
diff --git a/dropbox/base_team.py b/dropbox/base_team.py
@@ -10,6 +10,7 @@
     async_,
     auth,
     common,
+    contacts,
     file_properties,
     file_requests,
     files,
@@ -35,6 +36,9 @@ def request(self, route, namespace, arg, arg_binary=None):
     # ------------------------------------------
     # Routes in auth namespace
 
+    # ------------------------------------------
+    # Routes in contacts namespace
+
     # ------------------------------------------
     # Routes in file_properties namespace
 
@@ -1424,6 +1428,10 @@ def team_namespaces_list(self,
 
         :param long limit: Specifying a value here has no effect.
         :rtype: :class:`dropbox.team.TeamNamespacesListResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.team.TeamNamespacesListError`
         """
         arg = team.TeamNamespacesListArg(limit)
         r = self.request(
diff --git a/dropbox/common.py b/dropbox/common.py
@@ -380,7 +380,7 @@ def __repr__(self):
 
 Date_validator = bv.Timestamp(u'%Y-%m-%d')
 DisplayName_validator = bv.String(min_length=1, pattern=u'[^/:?*<>"|]*')
-DisplayNameLegacy_validator = bv.String(min_length=1)
+DisplayNameLegacy_validator = bv.String()
 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.
diff --git a/dropbox/contacts.py b/dropbox/contacts.py
@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+# Auto-generated by Stone, do not modify.
+# @generated
+# flake8: noqa
+# pylint: skip-file
+try:
+    from . import stone_validators as bv
+    from . import stone_base as bb
+except (ImportError, SystemError, ValueError):
+    # Catch errors raised when importing a relative module when not in a package.
+    # This makes testing this file directly (outside of a package) easier.
+    import stone_validators as bv
+    import stone_base as bb
+
+try:
+    from . import (
+        common,
+    )
+except (ImportError, SystemError, ValueError):
+    import common
+
+class DeleteManualContactsArg(bb.Struct):
+    """
+    :ivar email_addresses: List of manually added contacts to be deleted.
+    """
+
+    __slots__ = [
+        '_email_addresses_value',
+        '_email_addresses_present',
+    ]
+
+    _has_required_fields = True
+
+    def __init__(self,
+                 email_addresses=None):
+        self._email_addresses_value = None
+        self._email_addresses_present = False
+        if email_addresses is not None:
+            self.email_addresses = email_addresses
+
+    @property
+    def email_addresses(self):
+        """
+        List of manually added contacts to be deleted.
+
+        :rtype: list of [str]
+        """
+        if self._email_addresses_present:
+            return self._email_addresses_value
+        else:
+            raise AttributeError("missing required field 'email_addresses'")
+
+    @email_addresses.setter
+    def email_addresses(self, val):
+        val = self._email_addresses_validator.validate(val)
+        self._email_addresses_value = val
+        self._email_addresses_present = True
+
+    @email_addresses.deleter
+    def email_addresses(self):
+        self._email_addresses_value = None
+        self._email_addresses_present = False
+
+    def _process_custom_annotations(self, annotation_type, processor):
+        super(DeleteManualContactsArg, self)._process_custom_annotations(annotation_type, processor)
+
+    def __repr__(self):
+        return 'DeleteManualContactsArg(email_addresses={!r})'.format(
+            self._email_addresses_value,
+        )
+
+DeleteManualContactsArg_validator = bv.Struct(DeleteManualContactsArg)
+
+class DeleteManualContactsError(bb.Union):
+    """
+    This class acts as a tagged union. Only one of the ``is_*`` methods will
+    return true. To get the associated value of a tag (if one exists), use the
+    corresponding ``get_*`` method.
+
+    :ivar list of [str] contacts_not_found: Can't delete contacts from this
+        list. Make sure the list only has manually added contacts. The deletion
+        was cancelled.
+    """
+
+    _catch_all = 'other'
+    # Attribute is overwritten below the class definition
+    other = None
+
+    @classmethod
+    def contacts_not_found(cls, val):
+        """
+        Create an instance of this class set to the ``contacts_not_found`` tag
+        with value ``val``.
+
+        :param list of [str] val:
+        :rtype: DeleteManualContactsError
+        """
+        return cls('contacts_not_found', val)
+
+    def is_contacts_not_found(self):
+        """
+        Check if the union tag is ``contacts_not_found``.
+
+        :rtype: bool
+        """
+        return self._tag == 'contacts_not_found'
+
+    def is_other(self):
+        """
+        Check if the union tag is ``other``.
+
+        :rtype: bool
+        """
+        return self._tag == 'other'
+
+    def get_contacts_not_found(self):
+        """
+        Can't delete contacts from this list. Make sure the list only has
+        manually added contacts. The deletion was cancelled.
+
+        Only call this if :meth:`is_contacts_not_found` is true.
+
+        :rtype: list of [str]
+        """
+        if not self.is_contacts_not_found():
+            raise AttributeError("tag 'contacts_not_found' not set")
+        return self._value
+
+    def _process_custom_annotations(self, annotation_type, processor):
+        super(DeleteManualContactsError, self)._process_custom_annotations(annotation_type, processor)
+
+    def __repr__(self):
+        return 'DeleteManualContactsError(%r, %r)' % (self._tag, self._value)
+
+DeleteManualContactsError_validator = bv.Union(DeleteManualContactsError)
+
+DeleteManualContactsArg._email_addresses_validator = bv.List(common.EmailAddress_validator)
+DeleteManualContactsArg._all_field_names_ = set(['email_addresses'])
+DeleteManualContactsArg._all_fields_ = [('email_addresses', DeleteManualContactsArg._email_addresses_validator)]
+
+DeleteManualContactsError._contacts_not_found_validator = bv.List(common.EmailAddress_validator)
+DeleteManualContactsError._other_validator = bv.Void()
+DeleteManualContactsError._tagmap = {
+    'contacts_not_found': DeleteManualContactsError._contacts_not_found_validator,
+    'other': DeleteManualContactsError._other_validator,
+}
+
+DeleteManualContactsError.other = DeleteManualContactsError('other')
+
+delete_manual_contacts = bb.Route(
+    'delete_manual_contacts',
+    1,
+    False,
+    bv.Void(),
+    bv.Void(),
+    bv.Void(),
+    {'host': u'api',
+     'style': u'rpc'},
+)
+delete_manual_contacts_batch = bb.Route(
+    'delete_manual_contacts_batch',
+    1,
+    False,
+    DeleteManualContactsArg_validator,
+    bv.Void(),
+    DeleteManualContactsError_validator,
+    {'host': u'api',
+     'style': u'rpc'},
+)
+
+ROUTES = {
+    'delete_manual_contacts': delete_manual_contacts,
+    'delete_manual_contacts_batch': delete_manual_contacts_batch,
+}
+
diff --git a/dropbox/sharing.py b/dropbox/sharing.py
@@ -6271,6 +6271,10 @@ class LinkAudience(bb.Union):
 
     :ivar public: Link is accessible by anyone.
     :ivar team: Link is accessible only by team members.
+    :ivar no_one: The link can be used by no one. The link merely points the
+        user to the content, and does not grant additional rights to the user.
+        Members of the content who use this link can only access the content
+        with their pre-existing access rights.
     :ivar members: Link is accessible only by members of the content.
     """
 
@@ -6280,6 +6284,8 @@ class LinkAudience(bb.Union):
     # Attribute is overwritten below the class definition
     team = None
     # Attribute is overwritten below the class definition
+    no_one = None
+    # Attribute is overwritten below the class definition
     members = None
     # Attribute is overwritten below the class definition
     other = None
@@ -6300,6 +6306,14 @@ def is_team(self):
         """
         return self._tag == 'team'
 
+    def is_no_one(self):
+        """
+        Check if the union tag is ``no_one``.
+
+        :rtype: bool
+        """
+        return self._tag == 'no_one'
+
     def is_members(self):
         """
         Check if the union tag is ``members``.
@@ -17339,17 +17353,20 @@ def __repr__(self):
 
 LinkAudience._public_validator = bv.Void()
 LinkAudience._team_validator = bv.Void()
+LinkAudience._no_one_validator = bv.Void()
 LinkAudience._members_validator = bv.Void()
 LinkAudience._other_validator = bv.Void()
 LinkAudience._tagmap = {
     'public': LinkAudience._public_validator,
     'team': LinkAudience._team_validator,
+    'no_one': LinkAudience._no_one_validator,
     'members': LinkAudience._members_validator,
     'other': LinkAudience._other_validator,
 }
 
 LinkAudience.public = LinkAudience('public')
 LinkAudience.team = LinkAudience('team')
+LinkAudience.no_one = LinkAudience('no_one')
 LinkAudience.members = LinkAudience('members')
 LinkAudience.other = LinkAudience('other')
 
diff --git a/dropbox/team.py b/dropbox/team.py
diff --git a/dropbox/team_log.py b/dropbox/team_log.py
diff --git a/spec b/spec
