# Welcome to PyDrive’s documentation!

PyDrive is a wrapper library of google-api-python-client that simplifies many common Google Drive API tasks.

# Project Info

- Homepage: https://pypi.python.org/pypi/PyDrive

- Documentation:
    - Version 1.0.0 (PyPI): http://pythonhosted.org/PyDrive
    - Version 1.2.1: GitHub pages

- Github: https://github.com/googledrive/PyDrive

# How to install

You can install PyDrive with regular `pip` command.

    $ pip install PyDrive

To install the most up-to-date version from GitHub, use:

    $ pip install git+https://github.com/googledrive/PyDrive.git#egg=PyDrive

# Table of Contents

- Quickstart
  - Authentication
  - Creating and updating file
  - Getting list of files
- OAuth made easy
  - Authentication in two lines
  - Automatic and custom authentication with settings.yaml
  - Building your own authentication flow
- File management made easy
  - Upload a new file
  - Delete, Trash and un-Trash files
  - Update file metadata
  - Download file metadata from file ID
  - Handling special metadata
  - Upload and update file content
  - Download file content
- File listing made easy
  - Get all files which matches the query
  - Paginate and iterate through files
- pydrive package
  - pydrive.apiattr module
  - pydrive.auth module
  - pydrive.drive module
  - pydrive.files module
  - pydrive.settings module

# Indices and tables

- Index
- Search Page