gdatacopier

Debian and Ubuntu Users: Please note that the Python GData API distributed via apt is not 2.0.2, you may need to download and install this manually from the Google project hosting site. Please donot lodge this as an issue, it is not a defect in GDataCopier.

Enterprise Linux Distributions with Python 2.4 If you are using Enterprise Linux distributions and are stuck with Python 2.4 you will need to use GDataCopier 2.0.2 and GData Library 2.0.

GDataCopier provides a complete set command line utilities (the syntax of which largely resembles scp) that allow users to

gls - list documents on the Google document system gcp - export and import documents on the Google document system gmkdir - make directories on the Google docs system grm - remove documents and folders on the Google docs system gmv - move documents in and out of folder on the Google docs system Our target audience are system administrators (on Unix like platforms) who are looking to automate off site backups of their Google documents.

GDataCopier is currently considered stable and is an active project. Please report any issues to us by emailing the authors or posting it on the Google group or issue tracker.

Stable release: gdatacopier-2.1

Development release: gdatacopier-2.1.1, pending release on 1st April 2010

Note: GDataCopier is not affiliated with Google in anyway.

Featuresscp like syntax to list and copy documents filter documents based on folders, file names supports hosted and gmail accounts syncs date stamps with server download updated files only (great for offsite backup implementations) warn on overwrite (can override with parameters) summary of operations update document content using gcp move, remove, or make directories and organise your documents choose export format using command line parameter (defaults to OpenDocument formats) Who maintains GDataCopier?Devraj Mukherjee develops and maintains GDataCopier with feedback from it's users. Devraj works as the principal consultant for Eternity Technologies, an Open Source solutions company located in regional New South Wales, Australia and developed GDataCopier.

SponsorshipsIf you found GDataCopier useful and are feeling extremely generous, you might consider donating a small amount to fund the future development of this project. If you willing to fund a specific feature, please write to us to discuss.

You can also buy official merchandise from our Cafepress shop. All prices are listed in Australian Dollars.

De Bortoli Wines is one of the largest family owned wineries in Australia and is committed to Open Source and Open Standards. Amongst other projects they funded the initial development of GDataCopier. Read their Wikipedia article to learn more. The continue to fund the development of various features in GDataCopier Universiteitsbiliotheek Gent for sponsoring the development of the update document feature in gcp (released in 2.1) Unique Logo Design designed and contributed the GDataCopier Logo (available for free download as well), we highly recommend their graphic design services. Requirements for v2.xYou will need the following components to run GDataCopier v2.1. If you are using Enterprise Linux distributions and are stuck with Python 2.4 you will need to use GDataCopier 2.0.2 and GData Library 2.0.

Python 2.5 GData Python API 2.0.7+ Proxy support is provided via the Google GData Python API.

GData API currently has references to cryptology libraries that have been deprecated in Python 2.6. If you are using Python 2.6 you will receive warning messages.

If you use a Proxy in your environment, please consult the ProxySupport article as GData API requires a few extra environment variables.

v2.x Usage ExamplesHere's a quick overview of how you would typically use GDataCopier utilities. The wiki has a detailed manual page for each utility.

gcpExport all documents for username@gmail that have changed since the last sync, and overwrite them if they already exists on the local system

./gcp.py -o -u username@gmail.com:/sheets /tmpExport all documents where title matches Over for username@gmail.com as PDF

./gcp.py -f pdf username@gmail.com:/docs/all/Over* /tmp/Export all presentations for username@gmail.com to /tmp

./gcp.py username@gmail.com:/slides /tmpImports all accepted files from /home/devraj to username@gmail.com. All unsupported formats will be ignored. gcp doesn't support recursively reading directories.

./gcp.py /home/devraj/ username@gmail.com:/Imports Manual.doc to the Documentation folder for username@gmail.com, ensure that the folder exists on the Google document system.

./gcp.py /home/devraj/Manual.doc username@gmail.com:/DocumentationglsList all documents for username@gmail.com in the Documentation folder

./gls.py username@gmail.com:/docs/DocumentationList all documents for username@gmail.com where the title contains the string GTE

./gls.py username@gmail.com:/docs/Documentation/GTE*List all objects in the folder Documentation for username@gmail.com

./gls.py username@gmail.com:/all/DocumentationgmkdirMake a folder called Documentation on the Google docs system

./gmkdir.py username@gmail.com:/DocumentationgrmRemove all documents that match GTE in the title

./grm.py username@gmail.com:/docs/all/GTES*

Tags

  utility backup gdata python

Share