google_storage 0.1.1 → 0.1.2

data/README.textile

@@ -1,12 +1,35 @@
 h1. Google Storage using API v2
 
-I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the old
+I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the original
 version of Google's API or they were dependent on Gems that don't run properly on... dare I say it... windows.. :)  Apologies, I'm without choice
 at the moment, but anyways, this gem should run fine on all platforms and I've tried to keep dependencies to a minimum. Let me know if you find
 any bugs though ok and feel free to contribute.
 
-Google Storage is still a little experimental at the moment and the responses back from google differ quite a bit from each other.
-I've tried to parse all of these different responses and turn them into a fairly common type of response object though.
+h2. Response Object
+
+A lot of the responses from GS on the backend are a little bit inconsistent, sometimes returning response codes, sometimes returning heavily
+nested xml data and sometimes just returning information in the response header. I've tried to parse all responses that are returned from GS into a fairly
+consistent type of response Hash object. Usually this is in the form of something like this:
+
+<pre>
+#successful responses will always include a :success => true key/value pair
+
+client.list_buckets
+=> {:success=>true,
+        :buckets=>[ {"Name"=>"bucket_1_example", "CreationDate"=>"2011-06-07T07:11:18.480Z"},
+                    {"Name"=>"bucket_2_example", "CreationDate"=>"2011-05-31T10:58:08.097Z"},
+                    {"Name"=>"bucket_3_example", "CreationDate"=>"2011-06-06T22:47:10.728Z"}],
+        :raw=>{ THIS :raw FIELD WILL RETURN A HASH OF THE UNPARSED RESPONSE IN CASE YOU NEED IT }
+    }
+
+#Unsuccessful responses will return an "Error" Hash
+
+client.get_bucket("bucket_4_example")
+=> {"Error"=>{
+        "Code"=>"NoSuchBucket",
+        "Message"=>"The specified bucket does not exist."
+    }}
+</pre>
 
 h2. Setup Guide
 
@@ -22,7 +45,7 @@ But it's also possible to run this gem from the command line if you want.
 h2. Install the google_storage Gem
 
 Include the google_storage gem in your Gemfile and install config files
-<pre>gem "google_storage"
+<pre>gem 'google_storage'
 bundle install
 </pre>
 Then in your Rails application directory run:
@@ -107,4 +130,65 @@ web_applications:
 #    Google Storage API
 </pre>
 
-Once you've acquired your refresh_token you can now make calls to the API. Refer to the examples dir on how to use.
+Once you've acquired your refresh_token you can now make calls to the API.
+
+
+h2. Examples
+
+h3. Configuration
+
+   <pre>require 'google_storage'</pre>
+
+   The following will look for google_storage.yml in your rails config directory
+     <pre>client = GoogleStorage::Client.new</pre>
+
+   Otherwise you can pass in the path to the google_storage.yml
+     <pre>client = GoogleStorage::Client.new(:config_yml => 'C:/github/highvoltage/config/google_storage.yml')
+     </pre>
+
+h3. Service Requests
+
+   GET Service
+     <pre>client.list_buckets</pre>
+
+h3. Bucket Requests
+
+   GET Access Control List for Bucket
+     <pre>client.bucket_acls('bucket_name')</pre>
+
+   PUT Bucket
+     <pre>client.create_bucket('bucket_name')                                # < private bucket
+     client.create_bucket('bucket_name', :x_goog_acl => 'public-read')  # < public bucket  </pre>
+
+   GET Bucket
+     <pre>client.get_bucket('bucket_name')</pre>
+
+   DELETE Bucket
+     <pre>client.delete_bucket('bucket_name')</pre>
+
+h3. Object Requests
+
+   GET Access Control List for Object
+     <pre>client.object_acls('bucket_name', 'filename.jpg')</pre>
+
+   GET Object
+     <pre>client.get_object('bucket_name', 'filename.jpg')
+     client.get_object('bucket_name', 'filename.jpg', :write_to_file => 'c:/temp/new_file_name.jpg')</pre>
+
+   POST Object
+    <pre>Sorry, not including a 'post' object method as it still requires use of the old legacy access,
+    Please use the 'put' object method below instead to upload files to a bucket.</pre>
+
+   PUT Object
+     <pre>client.put_object('bucket_name', 'filename.jpg', :data => File.read('c:/temp/file.jpg'), :x_goog_acl => 'public-read')
+     client.upload_object('bucket_name', 'filename.jpg', :path_to_file => 'c:/temp/file.jpg')</pre>
+
+   HEAD Object
+     <pre>client.object_head('bucket_name', 'filename.jpg')</pre>
+
+   DELETE Object
+     <pre>client.delete_object('bucket_name', 'filename.jpg')</pre>
+
+
+
+

data/doc/GoogleStorage/Client.html

@@ -971,18 +971,18 @@ Example:
       <pre class="lines">
 
 
-172
-173
-174
 175
 176
 177
 178
 179
-180</pre>
+180
+181
+182
+183</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 172</span>
+      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 175</span>
 
 <span class='kw'>def</span> <span class='id delete_object'>delete_object</span><span class='lparen'>(</span><span class='id bucket_name'>bucket_name</span><span class='comma'>,</span> <span class='id filename'>filename</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id filename'>filename</span><span class='period'>.</span><span class='id gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\/</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1133,7 +1133,10 @@ Example:
 44
 45
 46
-47</pre>
+47
+48
+49
+50</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 23</span>
@@ -1147,7 +1150,7 @@ Example:
     <span class='kw'>begin</span>
       <span class='const'>File</span><span class='period'>.</span><span class='id open'>open</span><span class='lparen'>(</span><span class='id options'>options</span><span class='lbracket'>[</span><span class='symbol'>:write_to_file</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>wb</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id f'>f</span><span class='op'>|</span> <span class='id f'>f</span><span class='period'>.</span><span class='id write'>write</span><span class='lparen'>(</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id body'>body</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
     <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span>
-      <span class='kw'>return</span> <span class='lbrace'>{</span><span class='symbol'>:error</span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span><span class='rbrace'>}</span>
+      <span class='kw'>return</span> <span class='lbrace'>{</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error</span><span class='tstring_end'>&quot;</span></span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span><span class='rbrace'>}</span>
     <span class='kw'>end</span>
     <span class='id resp_obj'>resp_obj</span><span class='period'>.</span><span class='id clear'>clear</span>
     <span class='id resp_obj'>resp_obj</span><span class='lbracket'>[</span><span class='symbol'>:success</span><span class='rbracket'>]</span>      <span class='op'>=</span> <span class='kw'>true</span>
@@ -1162,6 +1165,9 @@ Example:
   <span class='id resp_obj'>resp_obj</span><span class='lbracket'>[</span><span class='symbol'>:size</span><span class='rbracket'>]</span>     <span class='op'>=</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id header'>header</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>content-length</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span>
 
   <span class='kw'>return</span> <span class='id resp_obj'>resp_obj</span>
+
+
+
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1264,9 +1270,6 @@ Example:
       <pre class="lines">
 
 
-118
-119
-120
 121
 122
 123
@@ -1276,10 +1279,13 @@ Example:
 127
 128
 129
-130</pre>
+130
+131
+132
+133</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 118</span>
+      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 121</span>
 
 <span class='kw'>def</span> <span class='id object_acls'>object_acls</span><span class='lparen'>(</span><span class='id bucket_name'>bucket_name</span><span class='comma'>,</span> <span class='id filename'>filename</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id filename'>filename</span><span class='period'>.</span><span class='id gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\/</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1332,9 +1338,6 @@ Example:
       <pre class="lines">
 
 
-144
-145
-146
 147
 148
 149
@@ -1346,10 +1349,13 @@ Example:
 155
 156
 157
-158</pre>
+158
+159
+160
+161</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 144</span>
+      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 147</span>
 
 <span class='kw'>def</span> <span class='id object_head'>object_head</span><span class='lparen'>(</span><span class='id bucket_name'>bucket_name</span><span class='comma'>,</span> <span class='id filename'>filename</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id filename'>filename</span><span class='period'>.</span><span class='id gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\/</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1427,9 +1433,6 @@ Available Options:
       <pre class="lines">
 
 
-74
-75
-76
 77
 78
 79
@@ -1455,10 +1458,13 @@ Available Options:
 99
 100
 101
-102</pre>
+102
+103
+104
+105</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 74</span>
+      <pre class="code"><span class="info file"># File 'lib/google_storage/object.rb', line 77</span>
 
 <span class='kw'>def</span> <span class='id put_object'>put_object</span><span class='lparen'>(</span><span class='id bucket_name'>bucket_name</span><span class='comma'>,</span> <span class='id filename'>filename</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id filename'>filename</span><span class='period'>.</span><span class='id gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\/</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1472,7 +1478,7 @@ Available Options:
         <span class='ivar'>@data</span> <span class='op'>=</span> <span class='id uploaded_file'>uploaded_file</span><span class='period'>.</span><span class='id read'>read</span>
       <span class='kw'>end</span>
     <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span>
-      <span class='kw'>return</span> <span class='lbrace'>{</span><span class='symbol'>:error</span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span><span class='rbrace'>}</span>
+      <span class='kw'>return</span> <span class='lbrace'>{</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error</span><span class='tstring_end'>&quot;</span></span> <span class='op'>=&gt;</span> <span class='id msg'>msg</span><span class='rbrace'>}</span>
     <span class='kw'>end</span>
     <span class='id options'>options</span><span class='lbracket'>[</span><span class='symbol'>:data</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='ivar'>@data</span>
   <span class='kw'>end</span>
@@ -1499,7 +1505,7 @@ Available Options:
 </div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/GoogleStorage/InstallGenerator.html

@@ -211,7 +211,7 @@ Example:
 </div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/GoogleStorage.html

@@ -97,7 +97,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.0.4</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.1.1</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -111,7 +111,7 @@
 </div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/_index.html

@@ -127,7 +127,7 @@
 </div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:24 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/file.README.html

@@ -55,12 +55,33 @@
     <iframe id="search_frame"></iframe>
     
     <div id="content"><div id='filecontents'><h1>Google Storage using <span class="caps">API</span> v2</h1>
-<p>I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the old
+<p>I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the original
 version of Google&#8217;s <span class="caps">API</span> or they were dependent on Gems that don&#8217;t run properly on&#8230; dare I say it&#8230; windows.. :)  Apologies, I&#8217;m without choice
 at the moment, but anyways, this gem should run fine on all platforms and I&#8217;ve tried to keep dependencies to a minimum. Let me know if you find
 any bugs though ok and feel free to contribute.</p>
-<p>Google Storage is still a little experimental at the moment and the responses back from google differ quite a bit from each other.
-I&#8217;ve tried to parse all of these different responses and turn them into a fairly common type of response object though.</p>
+<h2>Response Object</h2>
+<p>A lot of the responses from GS on the backend are a little bit inconsistent, sometimes returning response codes, sometimes returning heavily
+nested xml data and sometimes just returning information in the response header. I&#8217;ve tried to parse all responses that are returned from GS into a fairly
+consistent type of response Hash object. Usually this is in the form of something like this:</p>
+<pre class="code">
+#successful responses will always include a :success =&gt; true key/value pair
+
+client.list_buckets
+=&gt; {:success=&gt;true,
+        :buckets=&gt;[ {&quot;Name&quot;=&gt;&quot;bucket_1_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-06-07T07:11:18.480Z&quot;},
+                    {&quot;Name&quot;=&gt;&quot;bucket_2_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-05-31T10:58:08.097Z&quot;},
+                    {&quot;Name&quot;=&gt;&quot;bucket_3_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-06-06T22:47:10.728Z&quot;}],
+        :raw=&gt;{ THIS :raw FIELD WILL RETURN A HASH OF THE UNPARSED RESPONSE IN CASE YOU NEED IT }
+    }
+
+#Unsuccessful responses will return an &quot;Error&quot; Hash
+
+client.get_bucket(&quot;bucket_4_example&quot;)
+=&gt; {&quot;Error&quot;=&gt;{
+        &quot;Code&quot;=&gt;&quot;NoSuchBucket&quot;,
+        &quot;Message&quot;=&gt;&quot;The specified bucket does not exist.&quot;
+    }}
+</pre>
 <h2>Setup Guide</h2>
 <p>There&#8217;s a couple of steps to follow in order to setup this gem. The new Google Storage APIv2 uses OAuth 2.0 to authenticate requests, you can read up
 more on the nitty gritty if you like here: <a href="http://code.google.com/apis/accounts/docs/OAuth2.html">Google&#8217;s OAuth2 Guide</a></p>
@@ -141,10 +162,47 @@ web_applications:
 # 7. Copy and paste the refresh_token into this file. Your application should now be able to make calls to your
 #    Google Storage API
 </pre>
-<p>Once you&#8217;ve acquired your refresh_token you can now make calls to the <span class="caps">API</span>. Refer to the examples dir on how to use.</p></div></div>
+<p>Once you&#8217;ve acquired your refresh_token you can now make calls to the <span class="caps">API</span>.</p>
+<h2>Examples</h2>
+<h3>Configuration</h3>
+<pre class="code"><span class='id require'>require</span> <span class='id “google_storage”'>“google_storage”</span></pre>
+The following will look for google_storage.yml in your rails config directory
+<pre class="code"><span class='id client'>client</span> <span class='op'>=</span> <span class='const'>GoogleStorage</span><span class='op'>::</span><span class='const'>Client</span><span class='period'>.</span><span class='id new'>new</span></pre>
+Otherwise you can pass in the path to the google_storage.yml
+<pre class="code">client = GoogleStorage::Client.new(:config_yml =&gt; ‘C:/github/highvoltage/config/google_storage.yml’)
+</pre>
+<h3>Service Requests</h3>
+<span class="caps">GET</span> Service
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id list_buckets'>list_buckets</span></pre>
+<h3>Bucket Requests</h3>
+<span class="caps">GET</span> Access Control List for Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id bucket_acls'>bucket_acls</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<span class="caps">PUT</span> Bucket
+<pre class="code">client.create_bucket(‘bucket_name’)                                &lt;— private bucket
+client.create_bucket(‘bucket_name’, :x_goog_acl =&gt; ‘public-read’)  &lt;— public bucket  </pre>
+<span class="caps">GET</span> Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id get_bucket'>get_bucket</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<span class="caps">DELETE</span> Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id delete_bucket'>delete_bucket</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<h3>Object Requests</h3>
+<span class="caps">GET</span> Access Control List for Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id object_acls'>object_acls</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre>
+<span class="caps">GET</span> Object
+<pre class="code">client.get_object(‘bucket_name’, ‘filename.jpg’)
+client.get_object(‘bucket_name’, ‘filename.jpg’, :write_to_file =&gt; ‘c:/temp/new_file_name.jpg’)</pre>
+<span class="caps">POST</span> Object
+<pre class="code">Sorry, not including a ‘post’ object method as it still requires use of the old legacy access,
+Please use the ‘put’ object method below instead to upload files to a bucket.</pre>
+<span class="caps">PUT</span> Object
+<pre class="code">client.put_object(‘bucket_name’, ‘filename.jpg’, :data =&gt; File.read(‘c:/temp/file.jpg’), :x_goog_acl =&gt; ‘public-read’)
+client.upload_object(‘bucket_name’, ‘filename.jpg’, :path_to_file =&gt; ‘c:/temp/file.jpg’)</pre>
+<span class="caps">HEAD</span> Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id object_head'>object_head</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre>
+<span class="caps">DELETE</span> Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id delete_object'>delete_object</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre></div></div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/index.html

@@ -55,12 +55,33 @@
     <iframe id="search_frame"></iframe>
     
     <div id="content"><div id='filecontents'><h1>Google Storage using <span class="caps">API</span> v2</h1>
-<p>I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the old
+<p>I wrote this gem because the only google storage gems I could find already written were either written a while ago and only set up to use the original
 version of Google&#8217;s <span class="caps">API</span> or they were dependent on Gems that don&#8217;t run properly on&#8230; dare I say it&#8230; windows.. :)  Apologies, I&#8217;m without choice
 at the moment, but anyways, this gem should run fine on all platforms and I&#8217;ve tried to keep dependencies to a minimum. Let me know if you find
 any bugs though ok and feel free to contribute.</p>
-<p>Google Storage is still a little experimental at the moment and the responses back from google differ quite a bit from each other.
-I&#8217;ve tried to parse all of these different responses and turn them into a fairly common type of response object though.</p>
+<h2>Response Object</h2>
+<p>A lot of the responses from GS on the backend are a little bit inconsistent, sometimes returning response codes, sometimes returning heavily
+nested xml data and sometimes just returning information in the response header. I&#8217;ve tried to parse all responses that are returned from GS into a fairly
+consistent type of response Hash object. Usually this is in the form of something like this:</p>
+<pre class="code">
+#successful responses will always include a :success =&gt; true key/value pair
+
+client.list_buckets
+=&gt; {:success=&gt;true,
+        :buckets=&gt;[ {&quot;Name&quot;=&gt;&quot;bucket_1_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-06-07T07:11:18.480Z&quot;},
+                    {&quot;Name&quot;=&gt;&quot;bucket_2_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-05-31T10:58:08.097Z&quot;},
+                    {&quot;Name&quot;=&gt;&quot;bucket_3_example&quot;, &quot;CreationDate&quot;=&gt;&quot;2011-06-06T22:47:10.728Z&quot;}],
+        :raw=&gt;{ THIS :raw FIELD WILL RETURN A HASH OF THE UNPARSED RESPONSE IN CASE YOU NEED IT }
+    }
+
+#Unsuccessful responses will return an &quot;Error&quot; Hash
+
+client.get_bucket(&quot;bucket_4_example&quot;)
+=&gt; {&quot;Error&quot;=&gt;{
+        &quot;Code&quot;=&gt;&quot;NoSuchBucket&quot;,
+        &quot;Message&quot;=&gt;&quot;The specified bucket does not exist.&quot;
+    }}
+</pre>
 <h2>Setup Guide</h2>
 <p>There&#8217;s a couple of steps to follow in order to setup this gem. The new Google Storage APIv2 uses OAuth 2.0 to authenticate requests, you can read up
 more on the nitty gritty if you like here: <a href="http://code.google.com/apis/accounts/docs/OAuth2.html">Google&#8217;s OAuth2 Guide</a></p>
@@ -141,10 +162,47 @@ web_applications:
 # 7. Copy and paste the refresh_token into this file. Your application should now be able to make calls to your
 #    Google Storage API
 </pre>
-<p>Once you&#8217;ve acquired your refresh_token you can now make calls to the <span class="caps">API</span>. Refer to the examples dir on how to use.</p></div></div>
+<p>Once you&#8217;ve acquired your refresh_token you can now make calls to the <span class="caps">API</span>.</p>
+<h2>Examples</h2>
+<h3>Configuration</h3>
+<pre class="code"><span class='id require'>require</span> <span class='id “google_storage”'>“google_storage”</span></pre>
+The following will look for google_storage.yml in your rails config directory
+<pre class="code"><span class='id client'>client</span> <span class='op'>=</span> <span class='const'>GoogleStorage</span><span class='op'>::</span><span class='const'>Client</span><span class='period'>.</span><span class='id new'>new</span></pre>
+Otherwise you can pass in the path to the google_storage.yml
+<pre class="code">client = GoogleStorage::Client.new(:config_yml =&gt; ‘C:/github/highvoltage/config/google_storage.yml’)
+</pre>
+<h3>Service Requests</h3>
+<span class="caps">GET</span> Service
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id list_buckets'>list_buckets</span></pre>
+<h3>Bucket Requests</h3>
+<span class="caps">GET</span> Access Control List for Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id bucket_acls'>bucket_acls</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<span class="caps">PUT</span> Bucket
+<pre class="code">client.create_bucket(‘bucket_name’)                                &lt;— private bucket
+client.create_bucket(‘bucket_name’, :x_goog_acl =&gt; ‘public-read’)  &lt;— public bucket  </pre>
+<span class="caps">GET</span> Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id get_bucket'>get_bucket</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<span class="caps">DELETE</span> Bucket
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id delete_bucket'>delete_bucket</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='rparen'>)</span></pre>
+<h3>Object Requests</h3>
+<span class="caps">GET</span> Access Control List for Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id object_acls'>object_acls</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre>
+<span class="caps">GET</span> Object
+<pre class="code">client.get_object(‘bucket_name’, ‘filename.jpg’)
+client.get_object(‘bucket_name’, ‘filename.jpg’, :write_to_file =&gt; ‘c:/temp/new_file_name.jpg’)</pre>
+<span class="caps">POST</span> Object
+<pre class="code">Sorry, not including a ‘post’ object method as it still requires use of the old legacy access,
+Please use the ‘put’ object method below instead to upload files to a bucket.</pre>
+<span class="caps">PUT</span> Object
+<pre class="code">client.put_object(‘bucket_name’, ‘filename.jpg’, :data =&gt; File.read(‘c:/temp/file.jpg’), :x_goog_acl =&gt; ‘public-read’)
+client.upload_object(‘bucket_name’, ‘filename.jpg’, :path_to_file =&gt; ‘c:/temp/file.jpg’)</pre>
+<span class="caps">HEAD</span> Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id object_head'>object_head</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre>
+<span class="caps">DELETE</span> Object
+<pre class="code"><span class='id client'>client</span><span class='period'>.</span><span class='id delete_object'>delete_object</span><span class='lparen'>(</span><span class='id ‘bucket_name’'>‘bucket_name’</span><span class='comma'>,</span> <span class='id ‘filename'>‘filename</span><span class='period'>.</span><span class='id jpg’'>jpg’</span><span class='rparen'>)</span></pre></div></div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/doc/top-level-namespace.html

@@ -94,7 +94,7 @@
 </div>
     
     <div id="footer">
-  Generated on Tue Jun 28 10:28:04 2011 by 
+  Generated on Fri Jul  1 12:07:25 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.2 (ruby-1.9.2).
 </div>

data/examples/examples.rb

@@ -6,7 +6,7 @@
 #     client = GoogleStorage::Client.new
 #
 #   Otherwise you can pass in the path to the google_storage.yml
-#     client = GoogleStorage::Client.new(:config_yml => 'C:/example_path/config/google_storage.yml')
+#     client = GoogleStorage::Client.new(:config_yml => 'C:/github/highvoltage/config/google_storage.yml')
 #
 ### Service Requests ###
 #

data/lib/google_storage/client.rb

@@ -82,7 +82,7 @@ Example: GoogleStorage::Client.new(:config_yml => 'path to your google storage y
 
       @client_id      = config_yml['web_applications']['client_id']
       @client_secret  = config_yml['web_applications']['client_secret']
-      @client_secret.force_encoding("UTF-8")
+      @client_secret.force_encoding("UTF-8") if @client_secret.respond_to?(:force_encoding)
       @refresh_token  = config_yml['refresh_token'] if config_yml['refresh_token']
 
       #TODO Add support for individual permission types

data/lib/google_storage/object.rb

@@ -29,7 +29,7 @@ module GoogleStorage
         begin
           File.open(options[:write_to_file], 'wb') {|f| f.write(resp.body) }
         rescue Exception => msg
-          return {:error => msg}
+          return {"Error" => msg}
         end
         resp_obj.clear
         resp_obj[:success]      = true
@@ -44,6 +44,9 @@ module GoogleStorage
       resp_obj[:size]     = resp.header["content-length"]
 
       return resp_obj
+
+
+
     end
 
     ###
@@ -83,7 +86,7 @@ module GoogleStorage
             @data = uploaded_file.read
           end
         rescue Exception => msg
-          return {:error => msg}
+          return {"Error" => msg}
         end
         options[:data] = @data
       end

data/lib/google_storage/version.rb

@@ -1,3 +1,3 @@
 module GoogleStorage
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google_storage
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-06-28 00:00:00.000000000Z
+date: 2011-07-29 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: crack
-  requirement: &10204272 !ruby/object:Gem::Requirement
+  requirement: &10174068 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *10204272
+  version_requirements: *10174068
 description: A Ruby client library for using the new Google Storage API v2 using OAuth2.0
 email:
 - lucas@lucashills.com