RubyGems - s33r - Versions diffs - 0.4.2 → 0.5 - Mend

s33r 0.4.2 → 0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

data/examples/cli/instant_download_server.rb +88 -0
data/examples/cli/s3cli.rb +31 -52
data/examples/cli/simple.rb +16 -6
data/examples/fores33r/app/controllers/browser_controller.rb +12 -10
data/examples/fores33r/app/helpers/application_helper.rb +2 -1
data/examples/fores33r/app/views/browser/_upload.rhtml +1 -1
data/examples/fores33r/app/views/browser/index.rhtml +4 -4
data/examples/fores33r/config/environment.rb +5 -3
data/examples/fores33r/log/development.log +2259 -0
data/examples/fores33r/log/mongrel.log +59 -0
data/examples/s3.yaml +2 -6
data/lib/s33r/bucket.rb +103 -0
data/lib/s33r/bucket_listing.rb +33 -76
data/lib/s33r/client.rb +305 -446
data/lib/s33r/networking.rb +197 -0
data/lib/s33r/s33r_exception.rb +29 -18
data/lib/s33r/s33r_http.rb +36 -18
data/lib/s33r/s3_acl.rb +32 -52
data/lib/s33r/s3_logging.rb +117 -0
data/lib/s33r/s3_obj.rb +124 -69
data/lib/s33r/utility.rb +447 -0
data/test/cases/spec_acl.rb +10 -40
data/test/cases/spec_bucket_listing.rb +12 -32
data/test/cases/spec_logging.rb +47 -0
data/test/cases/spec_networking.rb +11 -0
data/test/cases/spec_s3_object.rb +44 -5
data/test/cases/spec_utility.rb +264 -0
data/test/files/acl.xml +0 -6
data/test/files/config.yaml +5 -0
data/test/files/logging_status_disabled.xml +3 -0
data/test/files/logging_status_enabled.xml +7 -0
data/test/test_setup.rb +7 -2
metadata +16 -94
data/examples/cli/acl_x.rb +0 -41
data/examples/cli/logging_x.rb +0 -20
data/examples/fores33r/README +0 -183
data/html/classes/MIME.html +0 -120
data/html/classes/MIME/InvalidContentType.html +0 -119
data/html/classes/MIME/Type.html +0 -1173
data/html/classes/MIME/Types.html +0 -566
data/html/classes/Net.html +0 -108
data/html/classes/Net/HTTPGenericRequest.html +0 -233
data/html/classes/Net/HTTPResponse.html +0 -271
data/html/classes/S33r.html +0 -986
data/html/classes/S33r/BucketListing.html +0 -434
data/html/classes/S33r/Client.html +0 -1575
data/html/classes/S33r/LoggingResource.html +0 -222
data/html/classes/S33r/NamedBucket.html +0 -693
data/html/classes/S33r/OrderlyXmlMarkup.html +0 -165
data/html/classes/S33r/S33rException.html +0 -124
data/html/classes/S33r/S33rException/BucketListingMaxKeysError.html +0 -111
data/html/classes/S33r/S33rException/BucketNotLogTargetable.html +0 -119
data/html/classes/S33r/S33rException/InvalidBucketListing.html +0 -111
data/html/classes/S33r/S33rException/InvalidPermission.html +0 -111
data/html/classes/S33r/S33rException/InvalidS3GroupType.html +0 -111
data/html/classes/S33r/S33rException/MalformedBucketName.html +0 -111
data/html/classes/S33r/S33rException/MethodNotAvailable.html +0 -111
data/html/classes/S33r/S33rException/MissingBucketName.html +0 -111
data/html/classes/S33r/S33rException/MissingRequiredHeaders.html +0 -111
data/html/classes/S33r/S33rException/MissingResource.html +0 -111
data/html/classes/S33r/S33rException/S3FallenOver.html +0 -111
data/html/classes/S33r/S33rException/TryingToPutEmptyResource.html +0 -117
data/html/classes/S33r/S33rException/UnsupportedCannedACL.html +0 -111
data/html/classes/S33r/S33rException/UnsupportedHTTPMethod.html +0 -111
data/html/classes/S33r/S3ACL.html +0 -125
data/html/classes/S33r/S3ACL/ACLDoc.html +0 -521
data/html/classes/S33r/S3ACL/AmazonCustomer.html +0 -168
data/html/classes/S33r/S3ACL/CanonicalUser.html +0 -212
data/html/classes/S33r/S3ACL/Grant.html +0 -403
data/html/classes/S33r/S3ACL/Grantee.html +0 -239
data/html/classes/S33r/S3ACL/Group.html +0 -178
data/html/classes/S33r/S3Object.html +0 -618
data/html/classes/S33r/Sync.html +0 -152
data/html/classes/XML.html +0 -202
data/html/classes/XML/Document.html +0 -125
data/html/classes/XML/Node.html +0 -124
data/html/created.rid +0 -1
data/html/files/CHANGELOG.html +0 -107
data/html/files/MIT-LICENSE.html +0 -129
data/html/files/README_txt.html +0 -259
data/html/files/lib/s33r/bucket_listing_rb.html +0 -101
data/html/files/lib/s33r/builder_rb.html +0 -108
data/html/files/lib/s33r/client_rb.html +0 -111
data/html/files/lib/s33r/core_rb.html +0 -113
data/html/files/lib/s33r/libxml_extensions_rb.html +0 -101
data/html/files/lib/s33r/libxml_loader_rb.html +0 -109
data/html/files/lib/s33r/logging_rb.html +0 -108
data/html/files/lib/s33r/mimetypes_rb.html +0 -120
data/html/files/lib/s33r/named_bucket_rb.html +0 -101
data/html/files/lib/s33r/s33r_exception_rb.html +0 -101
data/html/files/lib/s33r/s33r_http_rb.html +0 -108
data/html/files/lib/s33r/s3_acl_rb.html +0 -108
data/html/files/lib/s33r/s3_obj_rb.html +0 -108
data/html/files/lib/s33r/sync_rb.html +0 -101
data/html/files/lib/s33r_rb.html +0 -101
data/html/fr_class_index.html +0 -66
data/html/fr_file_index.html +0 -44
data/html/fr_method_index.html +0 -183
data/html/index.html +0 -24
data/html/rdoc-style.css +0 -208
data/lib/s33r/core.rb +0 -296
data/lib/s33r/logging.rb +0 -43
data/lib/s33r/named_bucket.rb +0 -148
data/lib/s33r/sync.rb +0 -13
data/test/cases/spec_all_buckets.rb +0 -28
data/test/cases/spec_client.rb +0 -101
data/test/cases/spec_core.rb +0 -128
data/test/cases/spec_namedbucket.rb +0 -46
data/test/cases/spec_sync.rb +0 -34
data/test/files/all_buckets.xml +0 -21
data/test/files/client_config.yml +0 -5
data/test/files/namedbucket_config.yml +0 -8
data/test/files/namedbucket_config2.yml +0 -8
data/test/test_bucket_setup.rb +0 -41

data/html/classes/S33r/S3ACL/Grantee.html DELETED Viewed

@@ -1,239 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: S33r::S3ACL::Grantee</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">S33r::S3ACL::Grantee</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/lib/s33r/s3_acl_rb.html">
-                lib/s33r/s3_acl.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Abstract representation of an S3 <a href="Grantee.html">Grantee</a>.
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000074">==</a>&nbsp;&nbsp;
-      <a href="#M000076">from_xml</a>&nbsp;&nbsp;
-      <a href="#M000075">method_missing</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">grantee_type</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
-        <div class="method-heading">
-          <a href="#M000076" class="method-signature">
-          <span class="method-name">from_xml</span><span class="method-args">(grantee_xml)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000076-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000076-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_acl.rb, line 265</span>
-265:       <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_xml</span>(<span class="ruby-identifier">grantee_xml</span>)
-266:         <span class="ruby-identifier">grantee_type</span> = <span class="ruby-identifier">grantee_xml</span>[<span class="ruby-value str">'type'</span>]
-267:
-268:         <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">grantee_type</span>
-269:           <span class="ruby-keyword kw">when</span> <span class="ruby-constant">GRANTEE_TYPES</span>[<span class="ruby-identifier">:amazon_customer</span>]
-270:             <span class="ruby-constant">AmazonCustomer</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">grantee_xml</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'EmailAddress'</span>))
-271:           <span class="ruby-keyword kw">when</span> <span class="ruby-constant">GRANTEE_TYPES</span>[<span class="ruby-identifier">:canonical_user</span>]
-272:             <span class="ruby-constant">CanonicalUser</span>.<span class="ruby-identifier">from_xml</span>(<span class="ruby-identifier">grantee_xml</span>)
-273:           <span class="ruby-keyword kw">when</span> <span class="ruby-constant">GRANTEE_TYPES</span>[<span class="ruby-identifier">:group</span>]
-274:             <span class="ruby-identifier">uri</span> = <span class="ruby-identifier">grantee_xml</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'URI'</span>)
-275:             <span class="ruby-comment cmt"># last part of the path is the group type</span>
-276:             <span class="ruby-identifier">path</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/#{GROUP_ACL_URI_BASE}/</span>, <span class="ruby-value str">''</span>)
-277:
-278:             <span class="ruby-identifier">group_type</span> = <span class="ruby-identifier">:all_users</span>
-279:             <span class="ruby-constant">S3_GROUP_TYPES</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">group_type</span> = <span class="ruby-identifier">k</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">v</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">path</span> }
-280:             <span class="ruby-constant">Group</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">group_type</span>)
-281:         <span class="ruby-keyword kw">end</span>
-282:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000074" class="method-detail">
-        <a name="M000074"></a>
-        <div class="method-heading">
-          <a href="#M000074" class="method-signature">
-          <span class="method-name">==</span><span class="method-args">(obj)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000074-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000074-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_acl.rb, line 248</span>
-248:       <span class="ruby-keyword kw">def</span> <span class="ruby-operator">==</span>(<span class="ruby-identifier">obj</span>)
-249:         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">obj</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Grantee</span>)
-250:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-251:         <span class="ruby-keyword kw">end</span>
-252:         <span class="ruby-identifier">instance_variables</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">var</span><span class="ruby-operator">|</span>
-253:           <span class="ruby-identifier">method_name</span> = <span class="ruby-identifier">var</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^@/</span>, <span class="ruby-value str">''</span>)
-254:           <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">method_name</span>) <span class="ruby-operator">!=</span> <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">method_name</span>)
-255:             <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-256:           <span class="ruby-keyword kw">end</span>
-257:         <span class="ruby-keyword kw">end</span>
-258:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
-259:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
-        <div class="method-heading">
-          <a href="#M000075" class="method-signature">
-          <span class="method-name">method_missing</span><span class="method-args">(*args)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000075-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000075-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_acl.rb, line 261</span>
-261:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">method_missing</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-262:         <span class="ruby-keyword kw">nil</span>
-263:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/html/classes/S33r/S3ACL/Group.html DELETED Viewed

@@ -1,178 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: S33r::S3ACL::Group</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">S33r::S3ACL::Group</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/lib/s33r/s3_acl_rb.html">
-                lib/s33r/s3_acl.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                <a href="Grantee.html">
-                Grantee
-               </a>
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-One of the predefined S3 groups.
-</p>
-<p>
-A group must have a type (AllUsers or AuthenticatedUsers).
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000060">new</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">group_type</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
-        <div class="method-heading">
-          <a href="#M000060" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(group_type)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-The type of group. A key from S3_GROUP_TYPES to one of the pre-defined
-Amazon group types.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000060-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000060-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_acl.rb, line 328</span>
-328:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">group_type</span>)
-329:         <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">S3_GROUP_TYPES</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">group_type</span>)
-330:           <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidS3GroupType</span>, <span class="ruby-value str">'No such group type #{group_type}'</span>
-331:         <span class="ruby-keyword kw">end</span>
-332:         <span class="ruby-ivar">@group_type</span> = <span class="ruby-constant">S3_GROUP_TYPES</span>[<span class="ruby-identifier">group_type</span>]
-333:         <span class="ruby-ivar">@grantee_type</span> = <span class="ruby-constant">GRANTEE_TYPES</span>[<span class="ruby-identifier">:group</span>]
-334:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/html/classes/S33r/S3Object.html DELETED Viewed

@@ -1,618 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: S33r::S3Object</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">S33r::S3Object</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/s33r/s3_obj_rb.html">
-                lib/s33r/s3_obj.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000096">delete</a>&nbsp;&nbsp;
-      <a href="#M000089">from_file</a>&nbsp;&nbsp;
-      <a href="#M000093">from_response</a>&nbsp;&nbsp;
-      <a href="#M000091">from_xml_node</a>&nbsp;&nbsp;
-      <a href="#M000090">from_xml_string</a>&nbsp;&nbsp;
-      <a href="#M000095">load</a>&nbsp;&nbsp;
-      <a href="#M000087">new</a>&nbsp;&nbsp;
-      <a href="#M000094">parse_response</a>&nbsp;&nbsp;
-      <a href="#M000092">parse_xml_node</a>&nbsp;&nbsp;
-      <a href="#M000097">save</a>&nbsp;&nbsp;
-      <a href="#M000088">set_properties</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">content_type</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">etag</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">key</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">last_modified</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">meta</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc">
-Metadata set by x-amz-meta- style headers. Note that the bit after
-x-amz-meta- is stored for each key, rather than the full key.
-</td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">mime_type</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">named_bucket</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">owner</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">size</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">storage_class</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">value</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000089" class="method-detail">
-        <a name="M000089"></a>
-        <div class="method-heading">
-          <a href="#M000089" class="method-signature">
-          <span class="method-name">from_file</span><span class="method-args">(key, filename)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-To create an object which reads the content in from a file; this is not
-very efficient - it&#8217;s actually better to use <a
-href="NamedBucket.html#M000111">NamedBucket.put_file</a>, as this will
-stream out of a file to S3, rather than load the file in memory first.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000089-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000089-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 43</span>
-43:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_file</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">filename</span>)
-44:       <span class="ruby-identifier">mime_type</span> = <span class="ruby-identifier">guess_mime_type</span>(<span class="ruby-identifier">filename</span>)
-45:       <span class="ruby-identifier">content_type</span> = <span class="ruby-identifier">mime_type</span>.<span class="ruby-identifier">simplified</span>
-46:       <span class="ruby-identifier">value</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">filename</span>).<span class="ruby-identifier">read</span>
-47:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">key</span>, { <span class="ruby-identifier">:content_type</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">content_type</span> }, {}, <span class="ruby-identifier">value</span>)
-48:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000093" class="method-detail">
-        <a name="M000093"></a>
-        <div class="method-heading">
-          <a href="#M000093" class="method-signature">
-          <span class="method-name">from_response</span><span class="method-args">(key, resp)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create a new instance from a HTTP response. This is useful if you do a GET
-for a resource key and want to convert the response into an object; NB the
-response doesn&#8217;t necessarily contain all the metadata you might want
-- you need to do a HEAD for that.
-</p>
-<p>
-<tt>key</tt> is the key for the resource (not part of the response).
-</p>
-<p>
-Note that if the resp returns nil, a blank object is created.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000093-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000093-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 93</span>
- 93:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_response</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">resp</span>)
- 94:       <span class="ruby-identifier">result</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_response</span>(<span class="ruby-identifier">resp</span>)
- 95:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>
- 96:         <span class="ruby-identifier">metadata</span>, <span class="ruby-identifier">amz_meta</span>, <span class="ruby-identifier">value</span> = <span class="ruby-identifier">result</span>
- 97:       <span class="ruby-keyword kw">else</span>
- 98:         <span class="ruby-identifier">metadata</span> = {}
- 99:         <span class="ruby-identifier">amz_meta</span> = {}
-100:         <span class="ruby-identifier">value</span> = <span class="ruby-keyword kw">nil</span>
-101:       <span class="ruby-keyword kw">end</span>
-102:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">metadata</span>, <span class="ruby-identifier">amz_meta</span>, <span class="ruby-identifier">value</span>)
-103:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000091" class="method-detail">
-        <a name="M000091"></a>
-        <div class="method-heading">
-          <a href="#M000091" class="method-signature">
-          <span class="method-name">from_xml_node</span><span class="method-args">(doc)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create a new instance from an <a href="../XML.html">XML</a> document.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000091-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000091-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 59</span>
-59:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_xml_node</span>(<span class="ruby-identifier">doc</span>)
-60:       <span class="ruby-identifier">metadata</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_xml_node</span>(<span class="ruby-identifier">doc</span>)
-61:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:key</span>], <span class="ruby-identifier">metadata</span>)
-62:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000090" class="method-detail">
-        <a name="M000090"></a>
-        <div class="method-heading">
-          <a href="#M000090" class="method-signature">
-          <span class="method-name">from_xml_string</span><span class="method-args">(xml_str)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Set properties of the object from an <a href="../XML.html">XML</a> string.
-</p>
-<p>
-<tt>xml_str</tt> should be a string representing a full <a
-href="../XML.html">XML</a> document, containing a &lt;Contents&gt; element
-as its root element.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000090-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000090-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 54</span>
-54:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_xml_string</span>(<span class="ruby-identifier">xml_str</span>)
-55:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_xml_node</span>(<span class="ruby-constant">XML</span>.<span class="ruby-identifier">get_xml_doc</span>(<span class="ruby-identifier">xml_str</span>))
-56:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000087" class="method-detail">
-        <a name="M000087"></a>
-        <div class="method-heading">
-          <a href="#M000087" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(key, metadata={}, amz_meta={}, value=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000087-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000087-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 13</span>
-13:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">metadata</span>={}, <span class="ruby-identifier">amz_meta</span>={}, <span class="ruby-identifier">value</span>=<span class="ruby-keyword kw">nil</span>)
-14:       <span class="ruby-ivar">@key</span> = <span class="ruby-identifier">key</span>
-15:       <span class="ruby-ivar">@meta</span> = <span class="ruby-identifier">amz_meta</span>
-16:       <span class="ruby-ivar">@value</span> = <span class="ruby-identifier">value</span>
-17:       <span class="ruby-identifier">set_properties</span>(<span class="ruby-identifier">metadata</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">metadata</span>.<span class="ruby-identifier">empty?</span>
-18:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000094" class="method-detail">
-        <a name="M000094"></a>
-        <div class="method-heading">
-          <a href="#M000094" class="method-signature">
-          <span class="method-name">parse_response</span><span class="method-args">(resp)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Parse the response returned by GET on a resource key within a bucket.
-</p>
-<p>
-<tt>resp</tt> is a <a href="../Net/HTTPResponse.html">Net::HTTPResponse</a>
-instance.
-</p>
-<p>
-Returns an array [<tt>metadata</tt>, +response.body+]; or nil if the object
-doesn&#8217;t exist.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000094-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000094-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 112</span>
-112:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_response</span>(<span class="ruby-identifier">resp</span>)
-113:       <span class="ruby-identifier">resp_headers</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">to_hash</span>
-114:
-115:       <span class="ruby-comment cmt"># If there's no etag, there's no content in the resource.</span>
-116:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">resp_headers</span>[<span class="ruby-value str">'etag'</span>]
-117:         <span class="ruby-identifier">metadata</span> = {}
-118:         <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:last_modified</span>] = <span class="ruby-identifier">resp_headers</span>[<span class="ruby-value str">'last-modified'</span>][<span class="ruby-value">0</span>]
-119:         <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:etag</span>] = <span class="ruby-identifier">resp_headers</span>[<span class="ruby-value str">'etag'</span>][<span class="ruby-value">0</span>]
-120:         <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:size</span>] = <span class="ruby-identifier">resp_headers</span>[<span class="ruby-value str">'content-length'</span>][<span class="ruby-value">0</span>]
-121:         <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:content_type</span>] = <span class="ruby-identifier">resp_headers</span>[<span class="ruby-value str">'content-type'</span>][<span class="ruby-value">0</span>]
-122:
-123:         <span class="ruby-comment cmt"># x-amz-meta- response headers.</span>
-124:         <span class="ruby-identifier">interesting_header</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">METADATA_PREFIX</span>)
-125:         <span class="ruby-identifier">amz_meta</span> = {}
-126:         <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">each_header</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-127:           <span class="ruby-identifier">amz_meta</span>[<span class="ruby-identifier">key</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">interesting_header</span>, <span class="ruby-value str">''</span>)] = <span class="ruby-identifier">value</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">interesting_header</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">key</span>
-128:         <span class="ruby-keyword kw">end</span>
-129:
-130:         <span class="ruby-comment cmt"># The actual content of the S3 object.</span>
-131:         <span class="ruby-identifier">value</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">body</span>
-132:
-133:         [<span class="ruby-identifier">metadata</span>, <span class="ruby-identifier">amz_meta</span>, <span class="ruby-identifier">value</span>]
-134:       <span class="ruby-keyword kw">else</span>
-135:         <span class="ruby-keyword kw">nil</span>
-136:       <span class="ruby-keyword kw">end</span>
-137:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000092" class="method-detail">
-        <a name="M000092"></a>
-        <div class="method-heading">
-          <a href="#M000092" class="method-signature">
-          <span class="method-name">parse_xml_node</span><span class="method-args">(doc)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Get properties of the object from an <a href="../XML.html">XML</a>
-document, e.g. as returned in a bucket listing.
-</p>
-<p>
-<tt>doc</tt>: <a href="../XML/Document.html">XML::Document</a> instance to
-parse to get properties for this object.
-</p>
-<p>
-Returns the metadata relating to the object, as stored on S3.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000092-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000092-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 70</span>
-70:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_xml_node</span>(<span class="ruby-identifier">doc</span>)
-71:       <span class="ruby-identifier">metadata</span> = {}
-72:       <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:key</span>] = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'Key'</span>)
-73:       <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:last_modified</span>] = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'LastModified'</span>)
-74:       <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:etag</span>] = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'ETag'</span>)
-75:       <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:size</span>] = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">xget</span>(<span class="ruby-value str">'Size'</span>)
-76:
-77:       <span class="ruby-comment cmt"># Build representation of the owner.</span>
-78:       <span class="ruby-identifier">user_xml_doc</span> = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">find</span>(<span class="ruby-value str">'Owner'</span>).<span class="ruby-identifier">to_a</span>.<span class="ruby-identifier">first</span>
-79:       <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:owner</span>] = <span class="ruby-constant">S3ACL</span><span class="ruby-operator">::</span><span class="ruby-constant">CanonicalUser</span>.<span class="ruby-identifier">from_xml</span>(<span class="ruby-identifier">user_xml_doc</span>)
-80:
-81:       <span class="ruby-identifier">metadata</span>
-82:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000096" class="method-detail">
-        <a name="M000096"></a>
-        <div class="method-heading">
-          <a href="#M000096" class="method-signature">
-          <span class="method-name">delete</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Remove this object from its associated <a
-href="NamedBucket.html">NamedBucket</a>.
-</p>
-<p>
-Returns false if this object is not associated with a bucket; otherwise
-returns the response from S3.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000096-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000096-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 163</span>
-163:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete</span>
-164:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">nil?</span>
-165:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-166:       <span class="ruby-keyword kw">else</span>
-167:         <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">delete_resource</span>(<span class="ruby-ivar">@key</span>)
-168:       <span class="ruby-keyword kw">end</span>
-169:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000095" class="method-detail">
-        <a name="M000095"></a>
-        <div class="method-heading">
-          <a href="#M000095" class="method-signature">
-          <span class="method-name">load</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Load content into this object from S3; will perform an HTTP request to
-&quot;refresh&quot; the object (providing the object has an association
-with a bucket it can use for piggybacking).
-</p>
-<p>
-Returns false if value cannot be retrieved.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000095-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000095-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 144</span>
-144:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load</span>
-145:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_bucket</span> <span class="ruby-keyword kw">and</span> <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">key_exists?</span>(<span class="ruby-ivar">@key</span>)
-146:         <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">get_raw</span>(<span class="ruby-ivar">@key</span>)
-147:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">ok?</span>
-148:           <span class="ruby-ivar">@value</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">body</span>
-149:           <span class="ruby-ivar">@content_type</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">to_hash</span>[<span class="ruby-value str">'content-type'</span>]
-150:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
-151:         <span class="ruby-keyword kw">else</span>
-152:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-153:         <span class="ruby-keyword kw">end</span>
-154:       <span class="ruby-keyword kw">else</span>
-155:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-156:       <span class="ruby-keyword kw">end</span>
-157:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000097" class="method-detail">
-        <a name="M000097"></a>
-        <div class="method-heading">
-          <a href="#M000097" class="method-signature">
-          <span class="method-name">save</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Save this object back into its bucket.
-</p>
-<p>
-Only works if the object has an associated <a
-href="NamedBucket.html">NamedBucket</a>; returns false if it doesn&#8217;t.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000097-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000097-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 175</span>
-175:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">save</span>
-176:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">nil?</span>
-177:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-178:       <span class="ruby-keyword kw">else</span>
-179:         <span class="ruby-identifier">headers</span> = {}
-180:         <span class="ruby-identifier">headers</span>[<span class="ruby-value str">&quot;Content-Type&quot;</span>] = <span class="ruby-ivar">@content_type</span> <span class="ruby-operator">||</span> <span class="ruby-value str">''</span>
-181:         <span class="ruby-identifier">headers</span> = <span class="ruby-identifier">metadata_headers</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">meta</span>)
-182:         <span class="ruby-ivar">@named_bucket</span>.<span class="ruby-identifier">put_stream</span>(<span class="ruby-ivar">@value</span>, <span class="ruby-ivar">@key</span>, <span class="ruby-identifier">headers</span>)
-183:       <span class="ruby-keyword kw">end</span>
-184:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000088" class="method-detail">
-        <a name="M000088"></a>
-        <div class="method-heading">
-          <a href="#M000088" class="method-signature">
-          <span class="method-name">set_properties</span><span class="method-args">(metadata)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Set the properties of the object from some metadata name-value pairs.
-</p>
-<p>
-<tt>metadata</tt> is a hash of properties and their values, used to set the
-corresponding properties on the object.
-</p>
-<p>
-<tt>value</tt> is the data associated with the object on S3.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000088-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000088-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/s3_obj.rb, line 26</span>
-26:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_properties</span>(<span class="ruby-identifier">metadata</span>)
-27:       <span class="ruby-comment cmt"># required properties</span>
-28:       <span class="ruby-ivar">@etag</span> = <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:etag</span>].<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot;\&quot;&quot;</span>, <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:etag</span>]
-29:       <span class="ruby-ivar">@last_modified</span> = <span class="ruby-constant">DateTime</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:last_modified</span>]) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:last_modified</span>]
-30:       <span class="ruby-ivar">@size</span> = <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:size</span>].<span class="ruby-identifier">to_i</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:size</span>]
-31:
-32:       <span class="ruby-comment cmt"># only set if creating object from XML (not available otherwise)</span>
-33:       <span class="ruby-ivar">@owner</span> = <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:owner</span>]
-34:
-35:       <span class="ruby-comment cmt"># only set if creating object from HTTP response</span>
-36:       <span class="ruby-ivar">@content_type</span> = <span class="ruby-identifier">metadata</span>[<span class="ruby-identifier">:content_type</span>]
-37:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>