dropbox 12.2.2__tar.gz → 12.2.3__tar.gz

{dropbox-12.2.2 → dropbox-12.2.3}/.github/workflows/ci.yml

@@ -109,7 +109,6 @@ jobs:
       contents: read
     strategy:
       fail-fast: false
-      max-parallel: 1
       matrix:
         os: [macos-15-intel, macos-latest, windows-latest, ubuntu-latest]
         python-version: ["3.11", "3.12", "3.13"]

{dropbox-12.2.2/dropbox.egg-info → dropbox-12.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dropbox
-Version: 12.2.2
+Version: 12.2.3
 Summary: Official Dropbox API Client
 Author-email: Dropbox <dev-platform@dropbox.com>
 License-Expression: MIT
@@ -24,7 +24,6 @@ Requires-Dist: requests>=2.16.2
 Requires-Dist: stone<4,>=3.5.3
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
-Requires-Dist: mock; extra == "test"
 Requires-Dist: pytest-mock; extra == "test"
 Requires-Dist: coverage; extra == "test"
 Requires-Dist: stone<4,>=3.5.3; extra == "test"

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '12.2.2'
-__version_tuple__ = version_tuple = (12, 2, 2)
+__version__ = version = '12.2.3'
+__version_tuple__ = version_tuple = (12, 2, 3)
 
-__commit_id__ = commit_id = 'g4f28257c5'
+__commit_id__ = commit_id = 'g3dfe03e64'

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/base.py

@@ -4505,6 +4505,79 @@ class DropboxBase(object):
     # ------------------------------------------
     # Routes in riviera namespace
 
+    def riviera_download_transform_output(self, output_handle):
+        """
+        Download the output of a completed `get_transform_async` job. Pass the
+        `output_handle` from the job's `complete` result. The body is the
+        produced file, and the `Dropbox-API-Result` header describes it. A
+        handle can only be redeemed by the user who requested the transform, and
+        only until its `expires_ts`; after that this route fails with
+        `expired_handle_error`, and the transform has to be requested again. A
+        handle that was never valid, or that belongs to another user, fails with
+        `user_error`.
+
+        Route attributes:
+            scope: files.content.read
+
+        :param output_handle: The `output_handle` from a `complete`
+            `get_transform_async/check` result.
+        :type output_handle: str
+        :rtype: (:class:`dropbox.riviera.DownloadTransformOutputResult`,
+                 :class:`requests.models.Response`)
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.riviera.TransformApiV2Error`
+
+        If you do not consume the entire response body, then you must call close
+        on the response object, otherwise you will max out your available
+        connections. We recommend using the `contextlib.closing
+        <https://docs.python.org/2/library/contextlib.html#contextlib.closing>`_
+        context manager to ensure this.
+        """
+        arg = riviera.DownloadTransformOutputArgs(output_handle)
+        r = self.request(
+            riviera.download_transform_output,
+            "riviera",
+            arg,
+            None,
+        )
+        return r
+
+    def riviera_download_transform_output_to_file(self, download_path, output_handle):
+        """
+        Download the output of a completed `get_transform_async` job. Pass the
+        `output_handle` from the job's `complete` result. The body is the
+        produced file, and the `Dropbox-API-Result` header describes it. A
+        handle can only be redeemed by the user who requested the transform, and
+        only until its `expires_ts`; after that this route fails with
+        `expired_handle_error`, and the transform has to be requested again. A
+        handle that was never valid, or that belongs to another user, fails with
+        `user_error`.
+
+        Route attributes:
+            scope: files.content.read
+
+        :param str download_path: Path on local machine to save file.
+        :param output_handle: The `output_handle` from a `complete`
+            `get_transform_async/check` result.
+        :type output_handle: str
+        :rtype: :class:`dropbox.riviera.DownloadTransformOutputResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.riviera.TransformApiV2Error`
+        """
+        arg = riviera.DownloadTransformOutputArgs(output_handle)
+        r = self.request(
+            riviera.download_transform_output,
+            "riviera",
+            arg,
+            None,
+        )
+        self._save_body_to_file(download_path, r[1])
+        return r[0]
+
     def riviera_get_keyframes_async(
         self, file_id_or_url=None, scene_change_threshold=0.0, include_images=False
     ):
@@ -4927,6 +5000,105 @@ class DropboxBase(object):
         )
         return r
 
+    def riviera_get_transform_async(
+        self, transform_type, file_id_or_url=None, thumbnail=None, image=None, video_frame=None
+    ):
+        """
+        Asynchronous file transformation: produces a new file from an existing
+        one. One route covers many conversions. Name the source file in
+        `file_id_or_url`, say what you want back in `transform_type`, and supply
+        that type's options message if it needs one: - `pdf`: documents and
+        images, to PDF. - `html`: spreadsheets, to HTML, preserving the sheet
+        layout. - `image`: images and single document pages, to JPEG or PNG. -
+        `thumbnail`: any thumbnailable source, resized to a named size bucket. -
+        `image_pdf`: documents, to a page image rendered by way of PDF. -
+        `video_frame`: one still frame from a video, at a requested offset. The
+        accepted input formats differ per transform -- they are not one shared
+        list -- and each is the intersection of the source format with the
+        pipeline that transform uses: - `pdf` and `image_pdf`: word-processing,
+        presentation and spreadsheet documents (.doc, .docx, .ppt, .pptx, .xls,
+        .xlsx, .odt, .odp, .ods, .rtf, .epub, .gdoc, .gslides, .hwp, .ai, .eps,
+        .dwg among others). Images are not accepted. - `html`: spreadsheets only
+        -- .xls, .xlsm, .xlsx, .ods, .gsheet. This is the complete list. Note
+        that .csv and .txt are *not* accepted here. - `image`: the documents
+        above, plus .pdf and .html, plus the iWork and design formats .pages,
+        .key, .numbers, .sketch, .xd, .indd and .psd, plus .avif, .heic, .svg
+        and camera RAW, plus fonts (.otf, .ttf), plus video. Formats a browser
+        can already display (.bmp, .gif, .ico, .jpeg, .png, .tif, .tiff, .webp)
+        are not accepted; use `thumbnail` for those. - `thumbnail`: everything
+        `image` accepts, plus .bmp, .gif, .ico, .jpeg, .png, .tif, .tiff, .webp
+        and JPEG 2000. - `video_frame`: .3g2, .3gp, .3gpp, .3gpp2, .asf, .avi,
+        .dv, .flv, .m2t, .m2ts, .m4v, .mkv, .mov, .mp4, .mpeg, .mpg, .mts, .mxf,
+        .ogv, .rm, .ts, .vob, .webm, .wmv. This is the complete list. These
+        lists track Riviera's capability registry
+        (`dropbox/riviera/supported_types/previews_supported_types.yaml`), which
+        is generated and authoritative; treat it rather than this comment as the
+        final word. Formats the requested transform does not support fail with
+        `unsupported_format_error`. Options belonging to a different transform
+        type than the one requested fail with `invalid_options_error`. The
+        produced bytes are not returned by this route, and not by its `/check`
+        poll either. Poll `get_transform_async/check` with the returned async
+        job ID until it reports `complete` or `failed`; a `complete` result
+        carries a `TransformOutput` whose `output_handle`
+        `download_transform_output` exchanges for the bytes. Splitting retrieval
+        out this way is what lets the route return outputs larger than an async
+        result can carry.
+
+        Route attributes:
+            scope: files.content.read
+
+        :param file_id_or_url: Identifier of the source file to transform.
+            Callers must set exactly one of the `FileIdOrUrl` variants. The
+            referenced file must be in a format the requested `transform_type`
+            supports; see the route description for the per-transform format
+            lists. Requests against unsupported formats fail with
+            `unsupported_format_error`.
+        :type file_id_or_url: Nullable[:class:`dropbox.riviera.FileIdOrUrl`]
+        :param transform_type: What to produce from the source file. Required.
+        :type transform_type: :class:`dropbox.riviera.TransformType`
+        :param thumbnail: Options for `TransformType.thumbnail`.
+        :type thumbnail: Nullable[:class:`dropbox.riviera.ThumbnailOptions`]
+        :param image: Options for `TransformType.image` and
+            `TransformType.image_pdf`.
+        :type image: Nullable[:class:`dropbox.riviera.ImageOptions`]
+        :param video_frame: Options for `TransformType.video_frame`.
+        :type video_frame: Nullable[:class:`dropbox.riviera.VideoFrameOptions`]
+        :rtype: :class:`dropbox.async_.LaunchResultBase`
+        """
+        arg = riviera.TransformArgs(transform_type, file_id_or_url, thumbnail, image, video_frame)
+        r = self.request(
+            riviera.get_transform_async,
+            "riviera",
+            arg,
+            None,
+        )
+        return r
+
+    def riviera_get_transform_async_check(self, async_job_id):
+        """
+        Returns the status or result of specified get_transform_async task.
+
+        Route attributes:
+            scope: files.content.read
+
+        :param async_job_id: Id of the asynchronous job. This is the value of a
+            response returned from the method that launched the job.
+        :type async_job_id: str
+        :rtype: :class:`dropbox.riviera.GetTransformAsyncCheckResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.async_.PollError`
+        """
+        arg = async_.PollArg(async_job_id)
+        r = self.request(
+            riviera.get_transform_async_check,
+            "riviera",
+            arg,
+            None,
+        )
+        return r
+
     # ------------------------------------------
     # Routes in sharing namespace
 

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/base_team.py

@@ -1424,7 +1424,7 @@ class DropboxTeamBase(object):
 
     def team_members_bulk_suspend(self, members):
         """
-        Launch a bulk suspend job. The server enforces a maximum of 500 members.
+        Deprecated compatibility alias for MembersSuspendBatch.
 
         Route attributes:
             scope: members.write
@@ -1432,14 +1432,18 @@ class DropboxTeamBase(object):
         :param members: Must contain between 1 and 500 targets. The launch
             handler also rejects duplicate client item IDs and duplicate member
             selectors.
-        :type members: List[:class:`dropbox.team.BulkSuspendMemberTarget`]
+        :type members: List[:class:`dropbox.team.MembersSuspendBatchTarget`]
         :rtype: :class:`dropbox.async_.LaunchResultBase`
         :raises: :class:`.exceptions.ApiError`
 
         If this raises, ApiError will contain:
-            :class:`dropbox.team.BulkSuspendError`
+            :class:`dropbox.team.MembersSuspendBatchError`
         """
-        arg = team.BulkSuspendArg(members)
+        warnings.warn(
+            "members/bulk_suspend is deprecated.",
+            DeprecationWarning,
+        )
+        arg = team.MembersSuspendBatchArg(members)
         r = self.request(
             team.members_bulk_suspend,
             "team",
@@ -1450,7 +1454,7 @@ class DropboxTeamBase(object):
 
     def team_members_bulk_suspend_job_status_check(self, async_job_id):
         """
-        Poll a previously launched bulk suspend job.
+        Deprecated compatibility alias for MembersSuspendBatchJobStatusCheck.
 
         Route attributes:
             scope: members.write
@@ -1458,12 +1462,16 @@ class DropboxTeamBase(object):
         :param async_job_id: Id of the asynchronous job. This is the value of a
             response returned from the method that launched the job.
         :type async_job_id: str
-        :rtype: :class:`dropbox.team.BulkSuspendJobStatus`
+        :rtype: :class:`dropbox.team.MembersSuspendBatchJobStatus`
         :raises: :class:`.exceptions.ApiError`
 
         If this raises, ApiError will contain:
             :class:`dropbox.async_.PollError`
         """
+        warnings.warn(
+            "members/bulk_suspend/job_status/check is deprecated.",
+            DeprecationWarning,
+        )
         arg = async_.PollArg(async_job_id)
         r = self.request(
             team.members_bulk_suspend_job_status_check,
@@ -2264,6 +2272,58 @@ class DropboxTeamBase(object):
         )
         return None
 
+    def team_members_suspend_batch(self, members):
+        """
+        Launch a member suspension batch. The server enforces a maximum of 500
+        members.
+
+        Route attributes:
+            scope: members.write
+
+        :param members: Must contain between 1 and 500 targets. The launch
+            handler also rejects duplicate client item IDs and duplicate member
+            selectors.
+        :type members: List[:class:`dropbox.team.MembersSuspendBatchTarget`]
+        :rtype: :class:`dropbox.async_.LaunchResultBase`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.team.MembersSuspendBatchError`
+        """
+        arg = team.MembersSuspendBatchArg(members)
+        r = self.request(
+            team.members_suspend_batch,
+            "team",
+            arg,
+            None,
+        )
+        return r
+
+    def team_members_suspend_batch_job_status_check(self, async_job_id):
+        """
+        Poll a previously launched member suspension batch job.
+
+        Route attributes:
+            scope: members.write
+
+        :param async_job_id: Id of the asynchronous job. This is the value of a
+            response returned from the method that launched the job.
+        :type async_job_id: str
+        :rtype: :class:`dropbox.team.MembersSuspendBatchJobStatus`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.async_.PollError`
+        """
+        arg = async_.PollArg(async_job_id)
+        r = self.request(
+            team.members_suspend_batch_job_status_check,
+            "team",
+            arg,
+            None,
+        )
+        return r
+
     def team_members_unsuspend(self, user):
         """
         Unsuspend a member from a team. Permission : Team member management

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/content_hash.py

@@ -128,8 +128,10 @@ class StreamHasher(object):
         return b
 
     def write(self, b):
-        self._hasher.update(b)
-        return self._f.write(b)
+        written = self._f.write(b)
+        if written:
+            self._hasher.update(b[:written])
+        return written
 
     def __iter__(self):
         return self

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/dropbox_client.py

@@ -268,8 +268,12 @@ class _DropboxTransport(object):
 
         return self.__class__(
             oauth2_access_token or self._oauth2_access_token,
-            max_retries_on_error or self._max_retries_on_error,
-            max_retries_on_rate_limit or self._max_retries_on_rate_limit,
+            self._max_retries_on_error if max_retries_on_error is None else max_retries_on_error,
+            (
+                self._max_retries_on_rate_limit
+                if max_retries_on_rate_limit is None
+                else max_retries_on_rate_limit
+            ),
             user_agent or self._raw_user_agent,
             session or self._session,
             headers or self._headers,
@@ -444,13 +448,9 @@ class _DropboxTransport(object):
             scope = " ".join(scope)
             body["scope"] = scope
 
-        timeout = DEFAULT_TIMEOUT
-        if self._timeout:
-            timeout = self._timeout
-
         attempt = 0
         while True:
-            res = self._session.post(url, data=body, timeout=timeout)
+            res = self._session.post(url, data=body, timeout=self._timeout)
             try:
                 self.raise_dropbox_error_for_resp(res)
                 break
@@ -775,8 +775,8 @@ class _DropboxTransport(object):
         :type http_resp: :class:`requests.models.Response`
         :rtype: None
         """
-        with open(download_path, "wb") as f:
-            with contextlib.closing(http_resp):
+        with contextlib.closing(http_resp):
+            with open(download_path, "wb") as f:
                 for c in http_resp.iter_content(chunksize):
                     f.write(c)
 

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/files.py

@@ -2912,6 +2912,13 @@ class FileStatus(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 FileStatus.deleted:
+        Field is deprecated. Deprecated. Deleted-file search does not work and
+        should not be used. Use
+        :meth:`dropbox.dropbox_client.Dropbox.files_list_folder` with
+        ``ListFolderArg.include_deleted`` set to ``True`` to enumerate deleted
+        entries; this does not provide equivalent full-text search.
     """
 
     _catch_all = "other"
@@ -5620,6 +5627,8 @@ MoveIntoFamilyError_validator = bv.Union(MoveIntoFamilyError)
 
 class MoveIntoVaultError(bb.Union):
     """
+    Deprecated: the server no longer emits this error.
+
     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.
@@ -6628,8 +6637,9 @@ class RelocationError(bb.Union):
     :ivar RelocationError.cant_move_shared_folder:
         Can't move the shared folder to the given destination.
     :ivar RelocationError.cant_move_into_vault:
-        Some content cannot be moved into Vault under certain circumstances, see
-        detailed error.
+        Field is deprecated. Some content cannot be moved into Vault under
+        certain circumstances, see detailed error. Deprecated: the server no
+        longer emits this error.
     :vartype RelocationError.cant_move_into_vault: MoveIntoVaultError
     :ivar RelocationError.cant_move_into_family:
         Some content cannot be moved into the Family Room folder under certain
@@ -6890,8 +6900,9 @@ class RelocationError(bb.Union):
 
     def get_cant_move_into_vault(self):
         """
-        Some content cannot be moved into Vault under certain circumstances, see
-        detailed error.
+        Field is deprecated. Some content cannot be moved into Vault under
+        certain circumstances, see detailed error. Deprecated: the server no
+        longer emits this error.
 
         Only call this if :meth:`is_cant_move_into_vault` is true.
 
@@ -8650,7 +8661,10 @@ class SearchOptions(bb.Struct):
         Specified property of the order of search results. By default, results
         are sorted by relevance.
     :ivar SearchOptions.file_status:
-        Restricts search to the given file status.
+        Restricts search to the given file status. The ``FileStatus.deleted``
+        value is deprecated and should not be used. This also applies to
+        searches continued with
+        :meth:`dropbox.dropbox_client.Dropbox.files_search_continue`.
     :ivar SearchOptions.filename_only:
         Restricts search to only match on filenames.
     :ivar SearchOptions.file_extensions:

{dropbox-12.2.2 → dropbox-12.2.3}/dropbox/openid.py

@@ -128,18 +128,24 @@ UserInfoError_validator = bv.Union(UserInfoError)
 class UserInfoResult(bb.Struct):
     """
     :ivar UserInfoResult.family_name:
-        Last name of user.
+        Last name of the user.
     :ivar UserInfoResult.given_name:
-        First name of user.
+        First name of the user.
     :ivar UserInfoResult.email:
-        Email address of user.
+        The user's email address. Be aware it's possible that the user has since
+        lost access to their email. Note: email is not a unique or stable
+        identifier for a Dropbox account. Users can change their email, and
+        emails can be reused by different accounts. Apps should not use email as
+        a key for account identification; use ``sub`` instead.
     :ivar UserInfoResult.email_verified:
-        If user is email verified.
+        If the user's email address is verified.
     :ivar UserInfoResult.iss:
-        Issuer of token (in this case Dropbox).
+        Issuer of the token (in this case Dropbox).
     :ivar UserInfoResult.sub:
         An identifier for the user. This is the Dropbox account_id, a string
-        value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc.
+        value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. The account_id
+        is a unique and stable identifier for a Dropbox account, suitable for
+        use as a key in authentication and account management.
     """
 
     __slots__ = [