Command line programs to save Google documents to text and LaTeX files
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.circleci
docs
gdoc_down
tests
.gitignore
.karr_lab_build_utils.yml
LICENSE
MANIFEST.in
README.md
requirements.txt
setup.cfg
setup.py

README.md

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

pip install 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.