Index: third_party/gsutil/README |
diff --git a/third_party/gsutil/README b/third_party/gsutil/README |
new file mode 100644 |
index 0000000000000000000000000000000000000000..709dc9a5a7b128e0555e2249b6c85b50dadf01cd |
--- /dev/null |
+++ b/third_party/gsutil/README |
@@ -0,0 +1,38 @@ |
+This directory contains the Python command line tool gsutil, which Google |
+has released as open source, to demonstrate the Google Storage API and to |
+provide a tool for manipulating data in the system. |
+ |
+Prerequisites: |
+ |
+Gsutil requires Python 2.6 or later. |
+ |
+To install gsutil take the following steps: |
+ |
+1. Pick a place where you want to install the software. You can |
+ install the code wherever you prefer; for brevity the instructions below |
+ assume you want to install in $HOME/gsutil. |
+ |
+2. To install gsutil on Linux/Unix or MacOS, open a shell window, change |
+ directories to where you downloaded the gsutil.tar.gz file, and do this: |
+ % tar xfz gsutil.tar.gz -C $HOME |
+ |
+ Then add the following line to your $HOME/.bashrc shell initialization |
+ file: |
+ export PATH=${PATH}:$HOME/gsutil |
+ |
+ The next time you start a shell you should be able to run gsutil from |
+ the command line. |
+ |
+3. To install gsutil on Windows, install cygwin (http://www.cygwin.com/), |
+ with at least version 2.6.5 of Python. Once you have that, start a shell |
+ and follow the Linux instructions above for unpacking and installing gsutil. |
+ |
+4. The first time you try to run gsutil, it will detect that you have no |
+ configuration file containing your credentials, interactively prompt you, |
+ and create the file. |
+ |
+ After this you can use the tool. Running gsutil with with no arguments |
+ will print a help summary. |
+ |
+For more information on installing and using gsutil, see |
+<http://code.google.com/apis/storage/docs/gsutil.html>. |