s33r 0.4.1 → 0.4.2

data/html/classes/S33r/LoggingResource.html

@@ -84,9 +84,9 @@ For manipulating logging directives on resources (see <a
 href="http://docs.amazonwebservices.com/AmazonS3/2006-03-01/LoggingHowTo.html">docs.amazonwebservices.com/AmazonS3/2006-03-01/LoggingHowTo.html</a>).
 </p>
 <p>
-Calling <a href="LoggingResource.html#M000085">LoggingResource.new</a> (no
-arguments) will generate a blank instance which can be used to remove
-logging from a resource.
+Creating a <a href="LoggingResource.html">LoggingResource</a> instance
+using new and no arguments will generate a &quot;blank&quot; instance; this
+can be put to the ?logging URL for a resource to remove logging from it.
 </p>
 
     </div>

data/html/classes/S33r/NamedBucket.html

@@ -95,22 +95,23 @@ convenient for use with a single bucket.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000095">[]</a>&nbsp;&nbsp;
-      <a href="#M000105">delete_resource</a>&nbsp;&nbsp;
-      <a href="#M000098">destroy</a>&nbsp;&nbsp;
-      <a href="#M000100">each_item</a>&nbsp;&nbsp;
-      <a href="#M000097">exists?</a>&nbsp;&nbsp;
-      <a href="#M000091">init</a>&nbsp;&nbsp;
-      <a href="#M000101">key_exists?</a>&nbsp;&nbsp;
-      <a href="#M000099">keys</a>&nbsp;&nbsp;
-      <a href="#M000096">listing</a>&nbsp;&nbsp;
-      <a href="#M000092">new</a>&nbsp;&nbsp;
-      <a href="#M000093">public_contents?</a>&nbsp;&nbsp;
-      <a href="#M000103">put_file</a>&nbsp;&nbsp;
-      <a href="#M000104">put_stream</a>&nbsp;&nbsp;
-      <a href="#M000102">put_text</a>&nbsp;&nbsp;
-      <a href="#M000106">s3_authenticated_url</a>&nbsp;&nbsp;
-      <a href="#M000094">strict?</a>&nbsp;&nbsp;
+      <a href="#M000102">[]</a>&nbsp;&nbsp;
+      <a href="#M000113">delete</a>&nbsp;&nbsp;
+      <a href="#M000106">destroy</a>&nbsp;&nbsp;
+      <a href="#M000108">each_object</a>&nbsp;&nbsp;
+      <a href="#M000105">exists?</a>&nbsp;&nbsp;
+      <a href="#M000103">get_raw</a>&nbsp;&nbsp;
+      <a href="#M000098">init</a>&nbsp;&nbsp;
+      <a href="#M000109">key_exists?</a>&nbsp;&nbsp;
+      <a href="#M000107">keys</a>&nbsp;&nbsp;
+      <a href="#M000104">listing</a>&nbsp;&nbsp;
+      <a href="#M000099">new</a>&nbsp;&nbsp;
+      <a href="#M000100">public_contents?</a>&nbsp;&nbsp;
+      <a href="#M000111">put_file</a>&nbsp;&nbsp;
+      <a href="#M000112">put_stream</a>&nbsp;&nbsp;
+      <a href="#M000110">put_text</a>&nbsp;&nbsp;
+      <a href="#M000114">s3_authenticated_url</a>&nbsp;&nbsp;
+      <a href="#M000101">strict?</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -160,11 +161,11 @@ convenient for use with a single bucket.
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000091" class="method-detail">
-        <a name="M000091"></a>
+      <div id="method-M000098" class="method-detail">
+        <a name="M000098"></a>
 
         <div class="method-heading">
-          <a href="#M000091" class="method-signature">
+          <a href="#M000098" class="method-signature">
           <span class="method-name">init</span><span class="method-args">(config_file)</span>
           </a>
         </div>
@@ -175,27 +176,27 @@ Initialize an instance from a config_file. The config. file can include a
 separate <tt>options</tt> section specifying options specific to <a
 href="NamedBucket.html">NamedBucket</a> instances (see the initialize
 method for more details). Other options are as for <a
-href="Client.html#M000115">S33r::Client.init</a>.
+href="Client.html#M000117">S33r::Client.init</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000091-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000091-source">
+            onclick="toggleCode('M000098-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000098-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 15</span>
-15:     <span class="ruby-keyword kw">def</span> <span class="ruby-constant">NamedBucket</span>.<span class="ruby-identifier">init</span>(<span class="ruby-identifier">config_file</span>)
-16:       <span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span> = <span class="ruby-keyword kw">super</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">load_config</span>(<span class="ruby-identifier">config_file</span>)
-17:       <span class="ruby-constant">NamedBucket</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>)
-18:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 17</span>
+17:     <span class="ruby-keyword kw">def</span> <span class="ruby-constant">NamedBucket</span>.<span class="ruby-identifier">init</span>(<span class="ruby-identifier">config_file</span>)
+18:       <span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span> = <span class="ruby-keyword kw">super</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">load_config</span>(<span class="ruby-identifier">config_file</span>)
+19:       <span class="ruby-constant">NamedBucket</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>)
+20:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000092" class="method-detail">
-        <a name="M000092"></a>
+      <div id="method-M000099" class="method-detail">
+        <a name="M000099"></a>
 
         <div class="method-heading">
-          <a href="#M000092" class="method-signature">
+          <a href="#M000099" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(aws_access_key, aws_secret_access_key, options={}) {|self if block_given?| ...}</span>
           </a>
         </div>
@@ -223,33 +224,30 @@ exist
 </li>
 </ul>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000092-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000092-source">
+            onclick="toggleCode('M000099-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000099-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 27</span>
-27:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>={}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)    
-28:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>)
-29:       
-30:       <span class="ruby-ivar">@name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:default_bucket</span>]
-31:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@name</span>.<span class="ruby-identifier">nil?</span>
-32:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">S33rException</span><span class="ruby-operator">::</span><span class="ruby-constant">MissingBucketName</span>, <span class="ruby-value str">&quot;NamedBucket cannot be initialised without specifying\
-33:         a :default_bucket option&quot;</span>
-34:       <span class="ruby-keyword kw">end</span>
-35: 
-36:       <span class="ruby-comment cmt"># holds a BucketListing instance</span>
-37:       <span class="ruby-ivar">@listing</span> = <span class="ruby-keyword kw">nil</span>
-38: 
-39:       <span class="ruby-comment cmt"># all content should be created as public-read</span>
-40:       <span class="ruby-ivar">@public_contents</span> = (<span class="ruby-keyword kw">true</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:public_contents</span>])
-41:       <span class="ruby-ivar">@client_headers</span>.<span class="ruby-identifier">merge!</span>(<span class="ruby-identifier">canned_acl_header</span>(<span class="ruby-value str">'public-read'</span>)) <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@public_contents</span>
-42:       
-43:       <span class="ruby-ivar">@strict</span> = (<span class="ruby-keyword kw">true</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:strict</span>])
-44:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@strict</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">bucket_exists?</span>(<span class="ruby-ivar">@name</span>)
-45:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">S33rException</span><span class="ruby-operator">::</span><span class="ruby-constant">MissingResource</span>, <span class="ruby-node">&quot;Non-existent bucket #{@bucket_name} specified&quot;</span>
-46:       <span class="ruby-keyword kw">end</span>
-47:       
-48:       <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-49:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 29</span>
+29:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>={}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)    
+30:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">aws_access_key</span>, <span class="ruby-identifier">aws_secret_access_key</span>, <span class="ruby-identifier">options</span>)
+31:       
+32:       <span class="ruby-ivar">@name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:default_bucket</span>]
+33:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@name</span>.<span class="ruby-identifier">nil?</span>
+34:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">S33rException</span><span class="ruby-operator">::</span><span class="ruby-constant">MissingBucketName</span>, <span class="ruby-value str">&quot;NamedBucket cannot be initialised without specifying\
+35:         a :default_bucket option&quot;</span>
+36:       <span class="ruby-keyword kw">end</span>
+37: 
+38:       <span class="ruby-comment cmt"># all content inside the bucket should be created as public-read</span>
+39:       <span class="ruby-ivar">@public_contents</span> = (<span class="ruby-keyword kw">true</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:public_contents</span>])
+40:       <span class="ruby-ivar">@client_headers</span>.<span class="ruby-identifier">merge!</span>(<span class="ruby-identifier">canned_acl_header</span>(<span class="ruby-value str">'public-read'</span>)) <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@public_contents</span>
+41:       
+42:       <span class="ruby-ivar">@strict</span> = (<span class="ruby-keyword kw">true</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:strict</span>])
+43:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@strict</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">bucket_exists?</span>(<span class="ruby-ivar">@name</span>)
+44:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">S33rException</span><span class="ruby-operator">::</span><span class="ruby-constant">MissingResource</span>, <span class="ruby-node">&quot;Non-existent bucket #{@bucket_name} specified&quot;</span>
+45:       <span class="ruby-keyword kw">end</span>
+46:       
+47:       <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+48:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
@@ -257,38 +255,54 @@ exist
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000095" class="method-detail">
-        <a name="M000095"></a>
+      <div id="method-M000102" class="method-detail">
+        <a name="M000102"></a>
 
         <div class="method-heading">
-          <a href="#M000095" class="method-signature">
-          <span class="method-name">[]</span><span class="method-args">(key)</span>
+          <a href="#M000102" class="method-signature">
+          <span class="method-name">[]</span><span class="method-args">(key, eager=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Get a single object from a bucket as a blob.
+Get a single object from a bucket as an <a
+href="S3Object.html">S3Object</a>.
+</p>
+<p>
+To get a bare object (with no content):
+</p>
+<pre>
+  bucket['key']
+</pre>
+<p>
+To get the object and load its content:
 </p>
+<pre>
+  bucket['key', :load]
+</pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000095-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000095-source">
+            onclick="toggleCode('M000102-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000102-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 62</span>
-62:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]</span>(<span class="ruby-identifier">key</span>)
-63:       <span class="ruby-identifier">get_resource</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">key</span>).<span class="ruby-identifier">body</span>
-64:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 69</span>
+69:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">eager</span>=<span class="ruby-keyword kw">false</span>)
+70:       <span class="ruby-identifier">obj</span> = <span class="ruby-identifier">listing</span>.<span class="ruby-identifier">contents</span>[<span class="ruby-identifier">key</span>]
+71:       <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">named_bucket</span> = <span class="ruby-keyword kw">self</span>
+72:       <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">load</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">:load</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">eager</span>
+73:       <span class="ruby-identifier">obj</span>
+74:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000105" class="method-detail">
-        <a name="M000105"></a>
+      <div id="method-M000113" class="method-detail">
+        <a name="M000113"></a>
 
         <div class="method-heading">
-          <a href="#M000105" class="method-signature">
-          <span class="method-name">delete_resource</span><span class="method-args">(resource_key, headers={})</span>
+          <a href="#M000113" class="method-signature">
+          <span class="method-name">delete</span><span class="method-args">(key, headers={})</span>
           </a>
         </div>
       
@@ -297,27 +311,26 @@ Get a single object from a bucket as a blob.
 Delete an object from the bucket. NB S3 doesn&#8217;t discriminate between
 successfully deleting a key and trying to delete a non-existent key (both
 return a 204). If you want to test for existence first, use <a
-href="NamedBucket.html#M000101">key_exists?</a>.
+href="NamedBucket.html#M000109">key_exists?</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000105-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000105-source">
+            onclick="toggleCode('M000113-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000113-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 117</span>
-117:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_resource</span>(<span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>={})
-118:       <span class="ruby-keyword kw">super</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>)
-119:       <span class="ruby-identifier">listing</span>
-120:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 136</span>
+136:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">headers</span>={})
+137:       <span class="ruby-identifier">delete_resource</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">key</span>, <span class="ruby-identifier">headers</span>)
+138:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000098" class="method-detail">
-        <a name="M000098"></a>
+      <div id="method-M000106" class="method-detail">
+        <a name="M000106"></a>
 
         <div class="method-heading">
-          <a href="#M000098" class="method-signature">
+          <a href="#M000106" class="method-signature">
           <span class="method-name">destroy</span><span class="method-args">(headers={}, options={})</span>
           </a>
         </div>
@@ -327,50 +340,53 @@ href="NamedBucket.html#M000101">key_exists?</a>.
 Delete the bucket.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000098-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000098-source">
+            onclick="toggleCode('M000106-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000106-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 78</span>
-78:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">destroy</span>(<span class="ruby-identifier">headers</span>={}, <span class="ruby-identifier">options</span>={})
-79:       <span class="ruby-identifier">delete_bucket</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">options</span>)
-80:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 94</span>
+94:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">destroy</span>(<span class="ruby-identifier">headers</span>={}, <span class="ruby-identifier">options</span>={})
+95:       <span class="ruby-identifier">delete_bucket</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">options</span>)
+96:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000100" class="method-detail">
-        <a name="M000100"></a>
+      <div id="method-M000108" class="method-detail">
+        <a name="M000108"></a>
 
         <div class="method-heading">
-          <a href="#M000100" class="method-signature">
-          <span class="method-name">each_item</span><span class="method-args">() {|item| ...}</span>
+          <a href="#M000108" class="method-signature">
+          <span class="method-name">each_object</span><span class="method-args">() {|obj| ...}</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List content of the bucket, and attach each item to this bucket as it is
-yielded.
+List content of the bucket, and attach each item to this <a
+href="NamedBucket.html">NamedBucket</a> instance as it is yielded (to
+enable easier manipulation directly from the <a
+href="S3Object.html">S3Object</a>). Note that the objects are incomplete,
+as the data associated with them has not been &quot;got&quot; from S3 yet.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000100-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000100-source">
+            onclick="toggleCode('M000108-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000108-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 88</span>
-88:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_item</span>
-89:       <span class="ruby-identifier">listing</span>.<span class="ruby-identifier">contents</span>.<span class="ruby-identifier">each_value</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span> <span class="ruby-identifier">item</span>.<span class="ruby-identifier">named_bucket</span> = <span class="ruby-keyword kw">self</span>; <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">item</span> }
-90:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 107</span>
+107:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_object</span>
+108:       <span class="ruby-identifier">listing</span>.<span class="ruby-identifier">contents</span>.<span class="ruby-identifier">each_value</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">obj</span><span class="ruby-operator">|</span> <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">named_bucket</span> = <span class="ruby-keyword kw">self</span>; <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">obj</span> }
+109:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000097" class="method-detail">
-        <a name="M000097"></a>
+      <div id="method-M000105" class="method-detail">
+        <a name="M000105"></a>
 
         <div class="method-heading">
-          <a href="#M000097" class="method-signature">
+          <a href="#M000105" class="method-signature">
           <span class="method-name">exists?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -381,23 +397,49 @@ Does this bucket exist? Returns true if the bucket this <a
 href="NamedBucket.html">NamedBucket</a> is mapped to exists.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000097-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000097-source">
+            onclick="toggleCode('M000105-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000105-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 73</span>
-73:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">exists?</span>
-74:       <span class="ruby-identifier">bucket_exists?</span>(<span class="ruby-ivar">@name</span>)
-75:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 89</span>
+89:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">exists?</span>
+90:       <span class="ruby-identifier">bucket_exists?</span>(<span class="ruby-ivar">@name</span>)
+91:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000101" class="method-detail">
-        <a name="M000101"></a>
+      <div id="method-M000103" class="method-detail">
+        <a name="M000103"></a>
 
         <div class="method-heading">
-          <a href="#M000101" class="method-signature">
+          <a href="#M000103" class="method-signature">
+          <span class="method-name">get_raw</span><span class="method-args">(key, headers={})</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Get a raw response for a key inside the bucket.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000103-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000103-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 77</span>
+77:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_raw</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">headers</span>={})
+78:       <span class="ruby-identifier">get_resource</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">key</span>, <span class="ruby-identifier">headers</span>)
+79:     <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000109" class="method-detail">
+        <a name="M000109"></a>
+
+        <div class="method-heading">
+          <a href="#M000109" class="method-signature">
           <span class="method-name">key_exists?</span><span class="method-args">(key)</span>
           </a>
         </div>
@@ -407,23 +449,23 @@ href="NamedBucket.html">NamedBucket</a> is mapped to exists.
 Does the given key exist in the bucket? Returns boolean
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000101-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000101-source">
+            onclick="toggleCode('M000109-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000109-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 94</span>
-94:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_exists?</span>(<span class="ruby-identifier">key</span>)
-95:       <span class="ruby-identifier">resource_exists?</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">key</span>)
-96:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 113</span>
+113:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_exists?</span>(<span class="ruby-identifier">key</span>)
+114:       <span class="ruby-identifier">resource_exists?</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">key</span>)
+115:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000099" class="method-detail">
-        <a name="M000099"></a>
+      <div id="method-M000107" class="method-detail">
+        <a name="M000107"></a>
 
         <div class="method-heading">
-          <a href="#M000099" class="method-signature">
+          <a href="#M000107" class="method-signature">
           <span class="method-name">keys</span><span class="method-args">()</span>
           </a>
         </div>
@@ -433,23 +475,23 @@ Does the given key exist in the bucket? Returns boolean
 Get a pretty list of the keys in the bucket.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000099-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000099-source">
+            onclick="toggleCode('M000107-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000107-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 83</span>
-83:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys</span>
-84:       <span class="ruby-identifier">listing</span>.<span class="ruby-identifier">pretty</span>
-85:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 99</span>
+ 99:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys</span>
+100:       <span class="ruby-identifier">listing</span>.<span class="ruby-identifier">pretty</span>
+101:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000096" class="method-detail">
-        <a name="M000096"></a>
+      <div id="method-M000104" class="method-detail">
+        <a name="M000104"></a>
 
         <div class="method-heading">
-          <a href="#M000096" class="method-signature">
+          <a href="#M000104" class="method-signature">
           <span class="method-name">listing</span><span class="method-args">()</span>
           </a>
         </div>
@@ -457,26 +499,28 @@ Get a pretty list of the keys in the bucket.
         <div class="method-description">
           <p>
 Get a <a href="BucketListing.html">BucketListing</a> instance for the
-content of this bucket.
+content of this bucket. Uses the <a
+href="Client.html#M000123">Client.list_bucket</a> method to get the
+listing.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000096-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000096-source">
+            onclick="toggleCode('M000104-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000104-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 67</span>
-67:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">listing</span>
-68:       <span class="ruby-identifier">list_bucket</span>(<span class="ruby-ivar">@name</span>)
-69:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 83</span>
+83:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">listing</span>
+84:       <span class="ruby-identifier">list_bucket</span>(<span class="ruby-ivar">@name</span>)[<span class="ruby-value">1</span>]
+85:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000093" class="method-detail">
-        <a name="M000093"></a>
+      <div id="method-M000100" class="method-detail">
+        <a name="M000100"></a>
 
         <div class="method-heading">
-          <a href="#M000093" class="method-signature">
+          <a href="#M000100" class="method-signature">
           <span class="method-name">public_contents?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -486,23 +530,23 @@ content of this bucket.
 Are all objects added to this bucket made public by default?
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000093-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000093-source">
+            onclick="toggleCode('M000100-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000100-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 52</span>
-52:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">public_contents?</span>
-53:       <span class="ruby-ivar">@public_contents</span>
-54:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 51</span>
+51:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">public_contents?</span>
+52:       <span class="ruby-ivar">@public_contents</span>
+53:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000103" class="method-detail">
-        <a name="M000103"></a>
+      <div id="method-M000111" class="method-detail">
+        <a name="M000111"></a>
 
         <div class="method-heading">
-          <a href="#M000103" class="method-signature">
+          <a href="#M000111" class="method-signature">
           <span class="method-name">put_file</span><span class="method-args">(filename, resource_key=nil, headers={}, options={})</span>
           </a>
         </div>
@@ -512,23 +556,23 @@ Are all objects added to this bucket made public by default?
 Put a file into the bucket.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000103-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000103-source">
+            onclick="toggleCode('M000111-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000111-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 104</span>
-104:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_file</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">resource_key</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">headers</span>={}, <span class="ruby-identifier">options</span>={})
-105:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">options</span>)
-106:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 123</span>
+123:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_file</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">resource_key</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">headers</span>={}, <span class="ruby-identifier">options</span>={})
+124:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">options</span>)
+125:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000104" class="method-detail">
-        <a name="M000104"></a>
+      <div id="method-M000112" class="method-detail">
+        <a name="M000112"></a>
 
         <div class="method-heading">
-          <a href="#M000104" class="method-signature">
+          <a href="#M000112" class="method-signature">
           <span class="method-name">put_stream</span><span class="method-args">(data, resource_key, headers={})</span>
           </a>
         </div>
@@ -538,23 +582,23 @@ Put a file into the bucket.
 Put a generic stream (e.g. from a file handle) into the bucket.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000104-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000104-source">
+            onclick="toggleCode('M000112-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000112-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 109</span>
-109:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_stream</span>(<span class="ruby-identifier">data</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>={})
-110:       <span class="ruby-identifier">put_resource</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)
-111:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 128</span>
+128:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_stream</span>(<span class="ruby-identifier">data</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>={})
+129:       <span class="ruby-identifier">put_resource</span>(<span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)
+130:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000102" class="method-detail">
-        <a name="M000102"></a>
+      <div id="method-M000110" class="method-detail">
+        <a name="M000110"></a>
 
         <div class="method-heading">
-          <a href="#M000102" class="method-signature">
+          <a href="#M000110" class="method-signature">
           <span class="method-name">put_text</span><span class="method-args">(string, resource_key, headers={})</span>
           </a>
         </div>
@@ -564,23 +608,23 @@ Put a generic stream (e.g. from a file handle) into the bucket.
 Put a string into a key inside the bucket.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000102-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000102-source">
+            onclick="toggleCode('M000110-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000110-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 99</span>
- 99:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_text</span>(<span class="ruby-identifier">string</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>={})
-100:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">string</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>)
-101:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 118</span>
+118:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_text</span>(<span class="ruby-identifier">string</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>={})
+119:       <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">string</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">headers</span>)
+120:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000106" class="method-detail">
-        <a name="M000106"></a>
+      <div id="method-M000114" class="method-detail">
+        <a name="M000114"></a>
 
         <div class="method-heading">
-          <a href="#M000106" class="method-signature">
+          <a href="#M000114" class="method-signature">
           <span class="method-name">s3_authenticated_url</span><span class="method-args">(resource_key, expires=(Time.now.to_i + DEFAULT_EXPIRY_SECS))</span>
           </a>
         </div>
@@ -596,23 +640,23 @@ for an object inside this bucket.
 invalid.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000106-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000106-source">
+            onclick="toggleCode('M000114-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000114-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 126</span>
-126:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">s3_authenticated_url</span>(<span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">expires</span>=(<span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">+</span> <span class="ruby-constant">DEFAULT_EXPIRY_SECS</span>))
-127:       <span class="ruby-keyword kw">super</span>(<span class="ruby-ivar">@aws_access_key</span>, <span class="ruby-ivar">@aws_secret_access_key</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">expires</span>)
-128:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 144</span>
+144:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">s3_authenticated_url</span>(<span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">expires</span>=(<span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">+</span> <span class="ruby-constant">DEFAULT_EXPIRY_SECS</span>))
+145:       <span class="ruby-keyword kw">super</span>(<span class="ruby-ivar">@aws_access_key</span>, <span class="ruby-ivar">@aws_secret_access_key</span>, <span class="ruby-ivar">@name</span>, <span class="ruby-identifier">resource_key</span>, <span class="ruby-identifier">expires</span>)
+146:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000094" class="method-detail">
-        <a name="M000094"></a>
+      <div id="method-M000101" class="method-detail">
+        <a name="M000101"></a>
 
         <div class="method-heading">
-          <a href="#M000094" class="method-signature">
+          <a href="#M000101" class="method-signature">
           <span class="method-name">strict?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -622,13 +666,13 @@ invalid.
 Is this a strict bucket (i.e. the target bucket must exist on S3)?
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000094-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000094-source">
+            onclick="toggleCode('M000101-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000101-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 57</span>
-57:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">strict?</span>
-58:       <span class="ruby-ivar">@strict</span>
-59:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/s33r/named_bucket.rb, line 56</span>
+56:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">strict?</span>
+57:       <span class="ruby-ivar">@strict</span>
+58:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>