Readme
.. image:: https://cfl.dropboxstatic.com/static/images/sdk/python_banner.png :target: https://github.com/dropbox/dropbox-sdk-python
.. image:: https://img.shields.io/pypi/pyversions/dropbox.svg :target: https://pypi.python.org/pypi/dropbox
.. image:: https://img.shields.io/pypi/v/dropbox.svg :target: https://pypi.python.org/pypi/dropbox
.. image:: https://codecov.io/gh/dropbox/dropbox-sdk-python/branch/main/graph/badge.svg :target: https://codecov.io/gh/dropbox/dropbox-sdk-python
The offical Dropbox SDK for Python.
Documentation can be found on Read The Docs_.
Create an app via the Developer Console_.
Install via pip <https://pip.pypa.io/>_:
.. code-block:: console
$ pip install dropbox
Install from source:
.. code-block:: console
$ git clone git://github.com/dropbox/dropbox-sdk-python.git
$ cd dropbox-sdk-python
$ python setup.py install
After installation, follow one of our Examples_ or read the documentation on Read The Docs_.
You can also view our OAuth Guide_.
We provide Examples_ to help get you started with a lot of the basic functionality in the SDK.
Commandline OAuth Basic <https://github.com/dropbox/dropbox-sdk-python/blob/main/example/oauth/commandline-oauth.py>_ - Shows a simple example of commandline oauth (no redirect).Commandline OAuth Scopes <https://github.com/dropbox/dropbox-sdk-python/blob/main/example/oauth/commandline-oauth-scopes.py>_ - Shows a simple example of commandline oauth using scopes.Commandline OAuth PKCE <https://github.com/dropbox/dropbox-sdk-python/blob/main/example/oauth/commandline-oauth-pkce.py>_ - Shows a simple example of commandline oauth using PKCE.Updown <https://github.com/dropbox/dropbox-sdk-python/blob/main/example/updown.py>_ - Sample application that uploads the contents of your Downloads folder to Dropbox.Backup and Restore <https://github.com/dropbox/dropbox-sdk-python/tree/main/example/back-up-and-restore>_ - Sample application that shows how you can backup a file and restore previous versions if the file was modified/corrupted in any way.If you find a bug, please see CONTRIBUTING.md_ for information on how to report it.
If you need help that is not specific to this SDK, please reach out to Dropbox Support_.
This SDK is distributed under the MIT license, please see LICENSE_ for more information.
.. _logo: {logo_link}
.. _repo: https://github.com/dropbox/dropbox-sdk-python
.. _Read The Docs: http://dropbox-sdk-python.readthedocs.org
.. _Examples: https://github.com/dropbox/dropbox-sdk-python/tree/main/example
.. _LICENSE: https://github.com/dropbox/dropbox-sdk-python/blob/main/LICENSE
.. _CONTRIBUTING.md: https://github.com/dropbox/dropbox-sdk-python/blob/main/CONTRIBUTING.md
.. _Developer Console: https://dropbox.com/developers/apps
.. _OAuth Guide: https://www.dropbox.com/lp/developers/reference/oauth-guide
.. _Dropbox Support: https://www.dropbox.com/developers/contact
FAQs
Official Dropbox API Client
We found that dropbox demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Socket is joining forces with CISA and other industry leaders at the RSA Conference to sign the Secure by Design pledge, committing to uphold the highest security standards in our products.
Research
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.
Security News
Socket CEO Feross Aboukhadijeh joins a16z partners to discuss how modern, sophisticated supply chain attacks require AI-driven defenses and explore the challenges and solutions in leveraging AI for threat detection early in the development life cycle.