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/LoggingResource.html DELETED Viewed

@@ -1,222 +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::LoggingResource</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::LoggingResource</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/s33r/logging_rb.html">
-                lib/s33r/logging.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>
-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>
-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>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000085">new</a>&nbsp;&nbsp;
-      <a href="#M000086">to_xml</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">log_prefix</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">log_target</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-M000085" class="method-detail">
-        <a name="M000085"></a>
-        <div class="method-heading">
-          <a href="#M000085" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(log_target=nil, log_prefix=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000085-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000085-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/logging.rb, line 14</span>
-14:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">log_target</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">log_prefix</span>=<span class="ruby-keyword kw">nil</span>)
-15:       <span class="ruby-ivar">@log_target</span> = <span class="ruby-identifier">log_target</span>
-16:       <span class="ruby-ivar">@log_prefix</span> = <span class="ruby-identifier">log_prefix</span>
-17:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000086" class="method-detail">
-        <a name="M000086"></a>
-        <div class="method-heading">
-          <a href="#M000086" class="method-signature">
-          <span class="method-name">to_xml</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Generate a BucketLoggingStatus <a href="../XML.html">XML</a> document for
-putting to the ?logging URL for a resource.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000086-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000086-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/s33r/logging.rb, line 23</span>
-23:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_xml</span>
-24:       <span class="ruby-identifier">xml_str</span> = <span class="ruby-value str">&quot;&quot;</span>
-25:       <span class="ruby-identifier">xml</span> = <span class="ruby-constant">Builder</span><span class="ruby-operator">::</span><span class="ruby-constant">XmlMarkup</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">:target</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">xml_str</span>, <span class="ruby-identifier">:indent</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>)
-26:
-27:       <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">instruct!</span>
-28:
-29:       <span class="ruby-comment cmt"># BucketLoggingStatus XML.</span>
-30:       <span class="ruby-identifier">xml</span>.<span class="ruby-constant">BucketLoggingStatus</span>({<span class="ruby-value str">&quot;xmlns&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">RESPONSE_NAMESPACE_URI</span>}) {
-31:         <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@log_target</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">and</span> <span class="ruby-ivar">@log_prefix</span>.<span class="ruby-identifier">nil?</span>
-32:           <span class="ruby-identifier">xml</span>.<span class="ruby-constant">LoggingEnabled</span> {
-33:             <span class="ruby-identifier">xml</span>.<span class="ruby-constant">TargetBucket</span> <span class="ruby-ivar">@log_target</span>
-34:             <span class="ruby-identifier">xml</span>.<span class="ruby-constant">TargetPrefix</span> <span class="ruby-ivar">@log_prefix</span>
-35:           }
-36:         <span class="ruby-keyword kw">end</span>
-37:       }
-38:
-39:       <span class="ruby-identifier">xml_str</span>
-40:     <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/NamedBucket.html DELETED Viewed

@@ -1,693 +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::NamedBucket</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::NamedBucket</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/s33r/named_bucket_rb.html">
-                lib/s33r/named_bucket.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                <a href="Client.html">
-                Client
-               </a>
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Wraps the <a href="Client.html">S33r::Client</a> class to make it more
-convenient for use with a single bucket.
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <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>
-  </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">dump_requests</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">name</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">public_contents</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">strict</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-M000098" class="method-detail">
-        <a name="M000098"></a>
-        <div class="method-heading">
-          <a href="#M000098" class="method-signature">
-          <span class="method-name">init</span><span class="method-args">(config_file)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-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#M000117">S33r::Client.init</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000099" class="method-detail">
-        <a name="M000099"></a>
-        <div class="method-heading">
-          <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>
-        <div class="method-description">
-          <p>
-Initialize a <a href="NamedBucket.html">NamedBucket</a> instance.
-</p>
-<p>
-<tt>options</tt> is a hash of options for this instance:
-</p>
-<ul>
-<li><tt>:default_bucket =&gt; &#8216;xxxx&#8217;</tt>: name of the bucket this
-client is attached to.
-</li>
-<li><tt>:public_contents =&gt; true</tt>: all items put into bucket are made
-public (can be overridden per request).
-</li>
-<li><tt>:strict =&gt; true</tt>: check whether the bucket exists before
-attempting to initialize; initialization # fails if the bucket does not
-exist
-</li>
-</ul>
-          <p><a class="source-toggle" href="#"
-            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 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>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000102" class="method-detail">
-        <a name="M000102"></a>
-        <div class="method-heading">
-          <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 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('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 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-M000113" class="method-detail">
-        <a name="M000113"></a>
-        <div class="method-heading">
-          <a href="#M000113" class="method-signature">
-          <span class="method-name">delete</span><span class="method-args">(key, headers={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-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#M000109">key_exists?</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000106" class="method-detail">
-        <a name="M000106"></a>
-        <div class="method-heading">
-          <a href="#M000106" class="method-signature">
-          <span class="method-name">destroy</span><span class="method-args">(headers={}, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Delete the bucket.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000108" class="method-detail">
-        <a name="M000108"></a>
-        <div class="method-heading">
-          <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 <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('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 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-M000105" class="method-detail">
-        <a name="M000105"></a>
-        <div class="method-heading">
-          <a href="#M000105" class="method-signature">
-          <span class="method-name">exists?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-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('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 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-M000103" class="method-detail">
-        <a name="M000103"></a>
-        <div class="method-heading">
-          <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>
-        <div class="method-description">
-          <p>
-Does the given key exist in the bucket? Returns boolean
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000107" class="method-detail">
-        <a name="M000107"></a>
-        <div class="method-heading">
-          <a href="#M000107" class="method-signature">
-          <span class="method-name">keys</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Get a pretty list of the keys in the bucket.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000104" class="method-detail">
-        <a name="M000104"></a>
-        <div class="method-heading">
-          <a href="#M000104" class="method-signature">
-          <span class="method-name">listing</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Get a <a href="BucketListing.html">BucketListing</a> instance for the
-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('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 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-M000100" class="method-detail">
-        <a name="M000100"></a>
-        <div class="method-heading">
-          <a href="#M000100" class="method-signature">
-          <span class="method-name">public_contents?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Are all objects added to this bucket made public by default?
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000111" class="method-detail">
-        <a name="M000111"></a>
-        <div class="method-heading">
-          <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>
-        <div class="method-description">
-          <p>
-Put a file into the bucket.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000112" class="method-detail">
-        <a name="M000112"></a>
-        <div class="method-heading">
-          <a href="#M000112" class="method-signature">
-          <span class="method-name">put_stream</span><span class="method-args">(data, resource_key, headers={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Put a generic stream (e.g. from a file handle) into the bucket.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000110" class="method-detail">
-        <a name="M000110"></a>
-        <div class="method-heading">
-          <a href="#M000110" class="method-signature">
-          <span class="method-name">put_text</span><span class="method-args">(string, resource_key, headers={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Put a string into a key inside the bucket.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000114" class="method-detail">
-        <a name="M000114"></a>
-        <div class="method-heading">
-          <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>
-        <div class="method-description">
-          <p>
-Generate an authenticated URL (see <a
-href="http://docs.amazonwebservices.com/AmazonS3/2006-03-01">docs.amazonwebservices.com/AmazonS3/2006-03-01</a>/)
-for an object inside this bucket.
-</p>
-<p>
-<tt>expires</tt>: time in secs since the epoch when the link should become
-invalid.
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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-M000101" class="method-detail">
-        <a name="M000101"></a>
-        <div class="method-heading">
-          <a href="#M000101" class="method-signature">
-          <span class="method-name">strict?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Is this a strict bucket (i.e. the target bucket must exist on S3)?
-</p>
-          <p><a class="source-toggle" href="#"
-            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 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>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>