Skip to main content

Download Google documents to files

Project description

PyPI package Documentation Test results Test coverage Code analysis License Analytics

gdoc_down

API and command line program to save Google documents, presentations, and worksheets in a local Google Drive / Backup & Sync directory to to local files.

gdoc_down supports several formats:

  • CSV (.csv)
  • EPUB (.epub)
  • Excel workbook (.xlsx)
  • HTML (.html)
  • Image (.png, .jpg, .svg)
  • LaTeX (.tex)
  • Open Office document (.odt)
  • Open Office presentation (.odp)
  • Open Office workbook (.ods)
  • Plain text file (.txt)
  • Portable document format (.pdf)
  • Powerpoint presentation (.pptx)
  • Rich text document (.rtf)
  • TSV (.tsv)
  • Word document (.docx)

gdoc_down also has special features for handling .gdoc files that contain LaTeX:

  • gdoc_down ignores all images. This allows the user to place images inside the Google document for convenience and to use \includegraphics to embed images in compile PDF files.
  • gdoc_down will convert all Google document comments to PDF comments.
  • gdoc_down ignores all page breaks.

The first time gdoc_down is called, gdoc_down will request access to the user’s Google account. This will create a client.json file in the users home directory (~/.gdoc_down/client.json).

Installation

  • Latest release from PyPI pip install gdoc_down
  • Latest revision from GitHub pip install git+https://github.com/KarrLab/gdoc_down.git#egg=gdoc_down

Command line usage

usage: gdoc_down (sub-commands ...) [options ...] {arguments ...}

Download a Google document, presentation, or workbook to a local file

positional arguments:
  google_file           path to Google document, presentation, or workbook

optional arguments:
  -h, --help            show this help message and exit
  --debug               toggle debug output
  --quiet               suppress all output
  --format FORMAT, -f FORMAT
                        output format (csv, docx, epub, html, jpg, odft, odp,
                        ods, pdf, pptx, png, rtf, svg, tsv, tex, txt, xlsx)
  --out_path OUT_PATH, -o OUT_PATH
                        path where Google document, presentation, or workbook
                        should be downloaded
  --extension EXTENSION, -e EXTENSION
                        output extension

Examples

gdoc_down -f docx /path/to/Google \Drive/file.gdoc
gdoc_down -f pptx /path/to/Google \Drive/file.gslides
gdoc_down -f xlsx /path/to/Google \Drive/file.gsheet

Documentation

Please see the documentation at Read the Docs.

Tests

pytest can be used to run the tests:

pytest tests

Please note that several additional packages are required for testing (see tests/requirements.txt).

License

The example model is released under the MIT license.

Development team

gdoc_down was developed by Jonathan Karr at the Icahn School of Medicine at Mount Sinai in New York, USA.

Questions and comments

Please contact the Jonathan Karr with any questions or comments.

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 gdoc-down, version 0.0.8
Filename, size File type Python version Upload date Hashes
Filename, size gdoc_down-0.0.8-py2.py3-none-any.whl (8.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size gdoc_down-0.0.8.tar.gz (8.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page