OLD | NEW |
(Empty) | |
| 1 This directory contains Python code Google is releasing as open source, |
| 2 to demonstrate the Google Storage API and to provide a command line |
| 3 tool for manipulating data in the system. |
| 4 |
| 5 Contents: |
| 6 - gsutil is the command line tool |
| 7 - cloudreader contains an example Google App Engine app that accesses Google |
| 8 storage |
| 9 - both depend on the boto open source Python library, version 2.0b4 or |
| 10 later. The boto repository is mapped into the gsutil svn tree using an |
| 11 svn:externals propset and is distributed with the gsutil tar ball. |
| 12 |
| 13 The cloudreader app is explained in cloudreader/README.google. |
| 14 |
| 15 Prerequisites: |
| 16 |
| 17 Gsutil requires either |
| 18 - Python 2.6 or later, or |
| 19 - Python 2.5 or later, with the 'simplejson' library installed. |
| 20 |
| 21 To install gsutil take the following steps: |
| 22 |
| 23 1. Pick a place where you want to install the software. You can |
| 24 install the code wherever you prefer; for brevity the instructions below |
| 25 assume you want to install in $HOME/gsutil. |
| 26 |
| 27 2. To install gsutil on Linux/Unix or MacOS, open a shell window, change |
| 28 directories to where you downloaded the gsutil.tar.gz file, and do this: |
| 29 % tar xfz gsutil.tar.gz -C $HOME |
| 30 |
| 31 Then add the following line to your $HOME/.bashrc shell initialization |
| 32 file: |
| 33 export PATH=${PATH}:$HOME/gsutil |
| 34 |
| 35 The next time you start a shell you should be able to run gsutil from |
| 36 the command line. |
| 37 |
| 38 3. To install gsutil on Windows, install cygwin (http://www.cygwin.com/), |
| 39 with at least version 2.6.5 of Python. Once you have that, start a shell |
| 40 and follow the Linux instructions above for unpacking and installing gsutil. |
| 41 |
| 42 4. The first time you try to run gsutil, it will detect that you have no |
| 43 configuration file containing your credentials, interactively prompt you, |
| 44 and create the file. |
| 45 |
| 46 After this you can use the tool. Running gsutil with with no arguments |
| 47 will print a help summary. |
| 48 |
| 49 For more information on installing and using gsutil, see |
| 50 <http://code.google.com/apis/storage/docs/gsutil.html>. |
OLD | NEW |