Skip to main content

A lightweight module to download and upload data to Google Drive contents

Project description

GitHub license PyPI PyPI - Python Version

A lightweight and easy to use Python library to upload and download contents from Google Drive.

Author:Abhinav Anand

1   What is it

[back to top]

Google Drive is the most used cloud storage platform. A need for some minimal yet effective tool to transfer contents to and from Drive is important!

There is a number of such libraries already present with Pydrive being the most amazing. Pydrive has a lot of functionalities but there are certain major things that it lacks. The goal of this library is to address the bulk uploading/downloading functionality in a way that is easy-to-use and yet covers the users’ requirements.

2   Features

[back to top]

  • Upload folders anywhere in the Drive maintaining the same directory structure as present locally.
  • Download folders from anywhere in the Drive to anywhere in the PC maintaining the same directory structure as present in the Drive.
  • Download or Upload whole directory in less than 5 lines of code.
  • Can sustain minor network interruptions.
  • Bulk upload/download made easy.
  • Minimal dependencies.
  • Easy to use.
  • Fast!
  • Returns JSON objects
  • Support
    • OS Support: Linux, Windows, Mac
    • Language Support: Python 2.x, 3.x

3   Installation

[back to top]

3.2   Option 2: Installing from source (Only if you must)

$ git clone
$ cd ZDrive/
$ pip install -r requirements.txt
$ python install

Note: If you get permission denied then $ sudo python install should fix that

4   Usage

[back to top]

4.1   Initial Setup

  • Follow the article to get your drive-api credentials.
  • Once you have the clients-secret.json, rename it to credentials.json and place it in the same folder where you’ll be running the script.

4.2   Downloader

  • Downloader() allows you to download folder/files from the Drive.
  • The output location where the files will get downloaded can be specified too.
  • Downloader() maintains the same directory tree structure while downloading from the Drive thus making it convenient to read.
  • Google Drive is a semantic (also called tag-based) file system meaning it stores files not based on their location, but based on an ID.
  • Semantic file systems allow you to have multiple files with the same name and to have one file appearing in multiple places.
  • Thus for performing any action related to a file/folder in Drive, we would need the IDs of the file/folder.
  • ZDrive allows you to retrieve a list of files/folders present inside the Drive along with their IDs.
  • Downloader() also uses multiprocessing for speeding up the download process.
  • Using the Downloader()
>>> from zdrive import Downloader
>>> output_directory = "/home/abhinav/Documents"
>>> d = Downloader()
>>> folder_id = 'XXXX-YYYY-ZZZZ'
>>> d.downloadFolder(folder_id, destinationFolder=output_directory)
  • If no destinationFolder is specified, then Downloader() would create a default folder named drive_content and it would download the contents there.
  • Also, if the specified destinationFolder doesn’t already exist, Downloader() would create the folder first and the perform the downloading.

4.3   Uploader

  • Uploader() allows you to upload folder/files from the local PC to drive.
  • Uploading can be done from any specified location inside the local PC.
  • Data can be uploaded at the ROOT level of the Drive or inside any specific folder in the Drive.
  • In case of a minor internet interruption(~10-15 secs) the upload would be paused and once the internet connection is stable. The uploading will get resumed.
  • Uploader() also maintains the exact same directory tree structure while uploading from the local PC to Drive.
  • The level of child directories to be uploaded is decided by max_depth parameter as shown in the example below.
  • By default, max_depth = 5
  • Using Uploader()
>>> from zdrive import Uploader
>>> input_directory = "/home/abhinav/Downloads"
>>> u = Uploader()
>>> parent_folder_id = u.createFolder(name="Data")
>>> result = u.uploadFolder(input_directory, max_depth=3, parentId=parent_folder_id)
>>> print(result)

            "/Users/abhinavanand/Downloads/test/def.pdf": "1pJNIu-0oyzaUgjLvnf6-3mk81iwLBXyS"
                    "/Users/abhinavanand/Downloads/test/test-level-1/abc.pdf": "1YwZs__92yzWdM2e7Nc2atF5lzLnyYV9i"
                "folders": {},
                "id": "1zzh_hGImg94SnzrMC8LdH1vgbO3LMksD"
  • If no parentId is specified, then Uploader() would upload the contents from local PC to the ROOT level in Drive.

5   Contributing

[back to top]

Please refer Contributing page for details

6   Bugs

[back to top]

Please report the bugs at the issue tracker

7   License

[back to top]

Built with ♥ by Abhinav Anand under the MIT License ©

You can find a copy of the License at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ZDrive, version 2.1.2
Filename, size File type Python version Upload date Hashes
Filename, size ZDrive-2.1.2-py3-none-any.whl (9.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ZDrive-2.1.2.tar.gz (8.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page