Remove Stone Submodule (#217)

* Remove Stone Submodule

- Remove Stone as submodule and pin in requirements.txt
- Pin Stone to major version 1.* until work can be done to upgrade to 2.*
- Update Spec

Files Namespace

Add internal_error to SearchError union.
Add locked to LookupError union.
Add cant_move_into_vault to RelocationError union.
Add MoveIntoVaultError union.
Add SearchMatchFieldOptions struct.
Add optional match_field_options to SearchV2Arg struct.
Doc/example changes.
Sharing Namespace

Add is_vault to SharePathError union.
Add invalid_shared_folder to AddFolderMemberError union.
Team Namespace

Make members field of LegalHoldsPolicyUpdateArg struct optional.
Add app_folder_removal_not_supported to RevokeLinkedAppError union.
Doc/example changes.
Team Log Namespace

Add auto_approve to InviteMethod union.
Add moved_from_another_team to InviteMethod union.
Add moved_from_another_team to MemberStatus union.
Add no_one to SharedLinkVisibility union.
Add optional new_team to MemberChangeStatusDetails struct.
Add optional previous_team to MemberChangeStatusDetails struct.
Add external_sharing_create_report_details to EventDetails union.
Add external_sharing_report_failed to EventDetails union.
Add content_administration_policy_changed_details to EventDetails
Add external_sharing_create_report to EventType.
Add external_sharing_report_failed to EventType.
Add content_administration_policy_changed to EventType.
union.
Add send_for_signature_policy_changed_details to EventDetails union.
Add external_sharing_create_report to EventTypeArgs union.
Add external_sharing_report_failed to EventTypeArgs union.
Add content_administration_policy_changed to EventTypeArgs union.
Add send_for_signature_policy_changed to EventTypeArgs union.
Add SendForSignaturePolicy union.
Add ExternalSharingCreateReportDetails struct.
Add ExternalSharingReportFailedDetails struct.
Add ContentAdministrationPolicyChangedDetails struct.
Add SendForSignaturePolicyChangedDetails struct.
Add ExternalSharingCreateReportType struct.
Add ExternalSharingReportFailedType struct.
Add ContentAdministrationPolicyChangedType struct.
Add SendForSignaturePolicyChangedType struct.

* Remove stone folder

Author: rogebrd

.gitmodules

@@ -1,6 +1,3 @@
-[submodule "stone"]
-	path = stone
-	url = https://github.com/dropbox/stone.git
 [submodule "spec"]
 	path = spec
 	url = https://github.com/dropbox/dropbox-api-spec.git

dropbox/base.py

@@ -1799,7 +1799,7 @@ def files_get_temporary_upload_link(self,
         upload path at any given time.  The POST request on the temporary upload
         link must have its Content-Type set to "application/octet-stream".
         Example temporary upload link consumption request:  curl -X POST
-        https://dl.dropboxusercontent.com/apitul/1/bNi2uIYF51cVBND --header
+        https://content.dropboxapi.com/apitul/1/bNi2uIYF51cVBND --header
         "Content-Type: application/octet-stream" --data-binary @local_file.txt
         A successful temporary upload link consumption request returns the
         content hash of the uploaded data in JSON format.  Example succesful
@@ -2776,8 +2776,9 @@ def files_search(self,
                      max_results=100,
                      mode=files.SearchMode.filename):
         """
-        Searches for files and folders. Note: Recent changes may not immediately
-        be reflected in search results due to a short delay in indexing.
+        Searches for files and folders. Note: Recent changes will be reflected
+        in search results within a few seconds and older revisions of existing
+        files may still match your query for up to a few days.
 
         :param str path: The path in the user's Dropbox to search. Should
             probably be a folder.
@@ -2819,6 +2820,7 @@ def files_search(self,
     def files_search_v2(self,
                         query,
                         options=None,
+                        match_field_options=None,
                         include_highlights=False):
         """
         Searches for files and folders. Note: :meth:`files_search_v2` along with
@@ -2831,7 +2833,10 @@ def files_search_v2(self,
             fields based on the request arguments. Query string may be rewritten
             to improve relevance of results.
         :param Nullable options: Options for more targeted search results.
-        :type include_highlights: bool
+        :param Nullable match_field_options: Options for search results match
+            fields.
+        :param bool include_highlights: Deprecated and moved this option to
+            SearchMatchFieldOptions.
         :rtype: :class:`dropbox.files.SearchV2Result`
         :raises: :class:`.exceptions.ApiError`
 
@@ -2840,6 +2845,7 @@ def files_search_v2(self,
         """
         arg = files.SearchV2Arg(query,
                                 options,
+                                match_field_options,
                                 include_highlights)
         r = self.request(
             files.search_v2,

dropbox/base_team.py

@@ -736,11 +736,12 @@ def team_legal_holds_create_policy(self,
                                        start_date=None,
                                        end_date=None):
         """
-        Creates new legal hold policy. Permission : Team member file access.
+        Creates new legal hold policy. Note: Legal Holds is a paid add-on. Not
+        all teams have the feature. Permission : Team member file access.
 
         :param str name: Policy name.
         :param Nullable description: A description of the legal hold policy.
-        :param list members: List of team members added to the hold.
+        :param list members: List of team member IDs added to the hold.
         :param Nullable start_date: start date of the legal hold policy.
         :param Nullable end_date: end date of the legal hold policy.
         :rtype: :class:`dropbox.team.LegalHoldPolicy`
@@ -765,7 +766,8 @@ def team_legal_holds_create_policy(self,
     def team_legal_holds_get_policy(self,
                                     id):
         """
-        Gets a legal hold by Id. Permission : Team member file access.
+        Gets a legal hold by Id. Note: Legal Holds is a paid add-on. Not all
+        teams have the feature. Permission : Team member file access.
 
         :param str id: The legal hold Id.
         :rtype: :class:`dropbox.team.LegalHoldPolicy`
@@ -786,7 +788,8 @@ def team_legal_holds_get_policy(self,
     def team_legal_holds_list_held_revisions(self,
                                              id):
         """
-        List the file metadata that's under the hold. Permission : Team member
+        List the file metadata that's under the hold. Note: Legal Holds is a
+        paid add-on. Not all teams have the feature. Permission : Team member
         file access.
 
         :param str id: The legal hold Id.
@@ -809,7 +812,8 @@ def team_legal_holds_list_held_revisions_continue(self,
                                                       id,
                                                       cursor=None):
         """
-        Continue listing the file metadata that's under the hold. Permission :
+        Continue listing the file metadata that's under the hold. Note: Legal
+        Holds is a paid add-on. Not all teams have the feature. Permission :
         Team member file access.
 
         :param str id: The legal hold Id.
@@ -835,7 +839,8 @@ def team_legal_holds_list_held_revisions_continue(self,
     def team_legal_holds_list_policies(self,
                                        include_released=False):
         """
-        Lists legal holds on a team. Permission : Team member file access.
+        Lists legal holds on a team. Note: Legal Holds is a paid add-on. Not all
+        teams have the feature. Permission : Team member file access.
 
         :param bool include_released: Whether to return holds that were
             released.
@@ -857,7 +862,8 @@ def team_legal_holds_list_policies(self,
     def team_legal_holds_release_policy(self,
                                         id):
         """
-        Releases a legal hold by Id. Permission : Team member file access.
+        Releases a legal hold by Id. Note: Legal Holds is a paid add-on. Not all
+        teams have the feature. Permission : Team member file access.
 
         :param str id: The legal hold Id.
         :rtype: None
@@ -877,26 +883,27 @@ def team_legal_holds_release_policy(self,
 
     def team_legal_holds_update_policy(self,
                                        id,
-                                       members,
                                        name=None,
-                                       description=None):
+                                       description=None,
+                                       members=None):
         """
-        Updates a legal hold. Permission : Team member file access.
+        Updates a legal hold. Note: Legal Holds is a paid add-on. Not all teams
+        have the feature. Permission : Team member file access.
 
         :param str id: The legal hold Id.
         :param Nullable name: Policy new name.
         :param Nullable description: Policy new description.
-        :param list members: List of team members to apply the policy on.
+        :param Nullable members: List of team member IDs to apply the policy on.
         :rtype: :class:`dropbox.team.LegalHoldPolicy`
         :raises: :class:`.exceptions.ApiError`
 
         If this raises, ApiError will contain:
             :class:`dropbox.team.LegalHoldsPolicyUpdateError`
         """
         arg = team.LegalHoldsPolicyUpdateArg(id,
-                                             members,
                                              name,
-                                             description)
+                                             description,
+                                             members)
         r = self.request(
             team.legal_holds_update_policy,
             'team',
@@ -993,8 +1000,9 @@ def team_linked_apps_revoke_linked_app(self,
         :param str app_id: The application's unique id.
         :param str team_member_id: The unique id of the member owning the
             device.
-        :param bool keep_app_folder: Whether to keep the application dedicated
-            folder (in case the application uses  one).
+        :param bool keep_app_folder: This flag is not longer supported, the
+            application dedicated folder (in case the application uses  one)
+            will be kept.
         :rtype: None
         :raises: :class:`.exceptions.ApiError`
 
@@ -2282,7 +2290,8 @@ def team_log_get_events(self,
             Participants.
         :param Nullable time: Filter by time range.
         :param Nullable category: Filter the returned events to a single
-            category.
+            category. Note that category shouldn't be provided together with
+            event_type.
         :param Nullable event_type: Filter the returned events to a single event
             type. Note that event_type shouldn't be provided together with
             category.