Automated Spec Update (dropbox#424)

ef6b1680d9a05ec7475f503149d771e44db913a2 Change Notes: files Namespace - Add upload_session/start_batch routes - Add UploadSessionStartBatchArg, UploadSessionStartBatchResult structs team_log_generated Namespace - Add ExternalDriveBackupEligibilityStatusCheckedDetails, ExternalDriveBackupStatusChangedDetails, ExternalDriveBackupEligibilityStatusCheckedType, ExternalDriveBackupStatusChangedType structs - Add ExternalDriveBackupEligibilityStatus, ExternalDriveBackupStatus unions Co-authored-by: DropboxBot <DropboxBot@users.noreply.github.com> Co-authored-by: Brent Bumann <bbumann@dropbox.com>

Author: DropboxBot

dropbox/base.py

@@ -3526,6 +3526,32 @@ def files_upload_session_start(self,
  )
  return r
 
+ def files_upload_session_start_batch(self,
+ num_sessions,
+ session_type=None):
+ """
+ This route starts batch of upload_sessions. Please refer to
+ `upload_session/start` usage.
+
+ Route attributes:
+ scope: files.content.write
+
+ :param Nullable[:class:`dropbox.files.UploadSessionType`] session_type:
+ Type of upload session you want to start. If not specified, default
+ is ``UploadSessionType.sequential``.
+ :param int num_sessions: The number of upload sessions to start.
+ :rtype: :class:`dropbox.files.UploadSessionStartBatchResult`
+ """
+ arg = files.UploadSessionStartBatchArg(num_sessions,
+ session_type)
+ r = self.request(
+ files.upload_session_start_batch,
+ 'files',
+ arg,
+ None,
+ )
+ return r
+
  # ------------------------------------------
  # Routes in paper namespace
 

dropbox/files.py

@@ -10204,6 +10204,71 @@ def _process_custom_annotations(self, annotation_type, field_path, processor):
 
 UploadSessionStartArg_validator = bv.Struct(UploadSessionStartArg)
 
+class UploadSessionStartBatchArg(bb.Struct):
+ """
+ :ivar files.UploadSessionStartBatchArg.session_type: Type of upload session
+ you want to start. If not specified, default is
+ ``UploadSessionType.sequential``.
+ :ivar files.UploadSessionStartBatchArg.num_sessions: The number of upload
+ sessions to start.
+ """
+
+ __slots__ = [
+ '_session_type_value',
+ '_num_sessions_value',
+ ]
+
+ _has_required_fields = True
+
+ def __init__(self,
+ num_sessions=None,
+ session_type=None):
+ self._session_type_value = bb.NOT_SET
+ self._num_sessions_value = bb.NOT_SET
+ if session_type is not None:
+ self.session_type = session_type
+ if num_sessions is not None:
+ self.num_sessions = num_sessions
+
+ # Instance attribute type: UploadSessionType (validator is set below)
+ session_type = bb.Attribute("session_type", nullable=True, user_defined=True)
+
+ # Instance attribute type: int (validator is set below)
+ num_sessions = bb.Attribute("num_sessions")
+
+ def _process_custom_annotations(self, annotation_type, field_path, processor):
+ super(UploadSessionStartBatchArg, self)._process_custom_annotations(annotation_type, field_path, processor)
+
+UploadSessionStartBatchArg_validator = bv.Struct(UploadSessionStartBatchArg)
+
+class UploadSessionStartBatchResult(bb.Struct):
+ """
+ :ivar files.UploadSessionStartBatchResult.session_ids: A List of unique
+ identifiers for the upload session. Pass each session_id to
+ :meth:`dropbox.dropbox_client.Dropbox.files_upload_session_append` and
+ :meth:`dropbox.dropbox_client.Dropbox.files_upload_session_finish`.
+ """
+
+ __slots__ = [
+ '_session_ids_value',
+ ]
+
+ _has_required_fields = True
+
+ def __init__(self,
+ session_ids=None):
+ self._session_ids_value = bb.NOT_SET
+ if session_ids is not None:
+ self.session_ids = session_ids
+
+ # Instance attribute type: list of [str] (validator is set below)
+ session_ids = bb.Attribute("session_ids")
+
+ def _process_custom_annotations(self, annotation_type, field_path, processor):
+ super(UploadSessionStartBatchResult, self)._process_custom_annotations(annotation_type, field_path, processor)
+
+UploadSessionStartBatchResult_validator = bv.Struct(UploadSessionStartBatchResult)
+
 class UploadSessionStartError(bb.Union):
  """
  This class acts as a tagged union. Only one of the ``is_*`` methods will
@@ -13015,6 +13080,21 @@ def _process_custom_annotations(self, annotation_type, field_path, processor):
  ('content_hash', UploadSessionStartArg.content_hash.validator),
 ]
 
+UploadSessionStartBatchArg.session_type.validator = bv.Nullable(UploadSessionType_validator)
+UploadSessionStartBatchArg.num_sessions.validator = bv.UInt64(min_value=1, max_value=1000)
+UploadSessionStartBatchArg._all_field_names_ = set([
+ 'session_type',
+ 'num_sessions',
+])
+UploadSessionStartBatchArg._all_fields_ = [
+ ('session_type', UploadSessionStartBatchArg.session_type.validator),
+ ('num_sessions', UploadSessionStartBatchArg.num_sessions.validator),
+]
+
+UploadSessionStartBatchResult.session_ids.validator = bv.List(bv.String())
+UploadSessionStartBatchResult._all_field_names_ = set(['session_ids'])
+UploadSessionStartBatchResult._all_fields_ = [('session_ids', UploadSessionStartBatchResult.session_ids.validator)]
+
 UploadSessionStartError._concurrent_session_data_not_allowed_validator = bv.Void()
 UploadSessionStartError._concurrent_session_close_not_allowed_validator = bv.Void()
 UploadSessionStartError._payload_too_large_validator = bv.Void()
@@ -13922,6 +14002,17 @@ def _process_custom_annotations(self, annotation_type, field_path, processor):
  'host': 'content',
  'style': 'upload'},
 )
+upload_session_start_batch = bb.Route(
+ 'upload_session/start_batch',
+ 1,
+ False,
+ UploadSessionStartBatchArg_validator,
+ UploadSessionStartBatchResult_validator,
+ bv.Void(),
+ {'auth': 'user',
+ 'host': 'api',
+ 'style': 'rpc'},
+)
 
 ROUTES = {
  'alpha/get_metadata': alpha_get_metadata,
@@ -13992,5 +14083,6 @@ def _process_custom_annotations(self, annotation_type, field_path, processor):
  'upload_session/finish_batch:2': upload_session_finish_batch_v2,
  'upload_session/finish_batch/check': upload_session_finish_batch_check,
  'upload_session/start': upload_session_start,
+ 'upload_session/start_batch': upload_session_start_batch,
 }