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

@@ -1,124 +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: XML::Node</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">XML::Node</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/s33r/libxml_extensions_rb.html">
-                lib/s33r/libxml_extensions.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>
-Make custom methods accessible to <a href="Node.html">Node</a> class.
-</p>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="includes">
-      <h3 class="section-bar">Included Modules</h3>
-      <div id="includes-list">
-        <span class="include-name"><a href="../XML.html">XML</a></span>
-      </div>
-    </div>
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/html/created.rid DELETED Viewed

	@@ -1 +0,0 @@
1	- Wed Jan 03 12:25:30 GMT 2007

data/html/files/CHANGELOG.html DELETED Viewed

@@ -1,107 +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>File: CHANGELOG</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="fileHeader">
-    <h1>CHANGELOG</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>CHANGELOG
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 03 11:35:17 GMT 2007</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Commit test
-</p>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/html/files/MIT-LICENSE.html DELETED Viewed

@@ -1,129 +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>File: MIT-LICENSE</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="fileHeader">
-    <h1>MIT-LICENSE</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>MIT-LICENSE
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 03 11:28:02 GMT 2007</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Copyright (C) 2006 Elliot Smith
-</p>
-<p>
-Permission is hereby granted, free of charge, to any person obtaining a
-copy of this software and associated documentation files (the
-&quot;Software&quot;), to deal in the Software without restriction,
-including without limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to the
-following conditions:
-</p>
-<p>
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-</p>
-<p>
-THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-USE OR OTHER DEALINGS IN THE SOFTWARE.
-</p>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/html/files/README_txt.html DELETED Viewed

@@ -1,259 +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>File: README.txt</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="fileHeader">
-    <h1>README.txt</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>README.txt
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 03 11:28:02 GMT 2007</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <h1>Introduction</h1>
-<p>
-This is my go at a Ruby library for talking to Amazon&#8217;s S3 service
-via REST. It is based on the sample Ruby code for S3 provided by Amazon,
-but has gone a long way beyond it now. Most of the remaining Amazon code is
-now in core.rb; the rest is mine.
-</p>
-<p>
-To use it from inside your Ruby script (as a gem):
-</p>
-<pre>
-  require 'rubygems'
-  require_gem 's33r'
-</pre>
-<p>
-Alternatively, just load lib/s33r.rb.
-</p>
-<p>
-By the way, I&#8217;ve tested this on Linux, but not on Windows or Mac.
-</p>
-<h1>Features</h1>
-<p>
-Supports the following aspects of S3:
-</p>
-<ul>
-<li>List all buckets
-</li>
-<li>Get bucket
-</li>
-<li>Create bucket
-</li>
-<li>Delete bucket
-</li>
-<li>Put resource into bucket (text or file)
-</li>
-<li>Delete resource from bucket
-</li>
-<li>Set ACL for a bucket or resource
-</li>
-<li>Turn on logging for a bucket or resource
-</li>
-</ul>
-<h1>Requirements</h1>
-<p>
-To get the most from s33r, you will need:
-</p>
-<ul>
-<li>Ruby 1.8.4 (this is what I developed with, but it may work OK with older
-versions)
-</li>
-<li>libxml (REQUIRED: s33r relies on this for parsing responses from S3)
-</li>
-<li>builder (REQUIRED)
-</li>
-<li>openssl (you can use s33r without this, but obviously you won&#8217;t be
-able to encrypt connections)
-</li>
-<li>rspec (if you want to run the unit tests)
-</li>
-<li>fakeweb (to run tests)
-</li>
-</ul>
-<h1>Basic usage</h1>
-<ul>
-<li>Set up an Amazon S3 account at <a
-href="http://amazon.com/s3">amazon.com/s3</a>.
-</li>
-<li>Checkout the s33r from the repository using <tt>svn checkout
-svn://rubyforge.org/var/svn/s33r/trunk s33r</tt>.
-</li>
-<li>Connect into the new directory made by checking out the code (s33r).
-</li>
-<li>Copy the sample configuration file (test/files/client_config.yml) to
-somewhere on your machine (e.g. /home/you/.s33r).
-</li>
-<li>Edit the file, replacing the sample aws_access_key and
-aws_secret_access_key with your settings.
-</li>
-<li>Fire up irb.
-</li>
-<li>Try the following code:
-<pre>
-  require_gem 's33r'
-  include S33r
-  # initialise a client instance from a config file
-  # (see the sample in examples/s3.yaml)
-  client = Client.init('/home/you/.s33r')
-  # create a bucket called 'some-outlandish-name'
-  client.create_bucket('some-outlandish-name')
-  # show the contents of the bucket
-  client.list_buckets.body
-  # put something into the bucket
-  c.put_file('somefile.jpg', 'some-outlandish-name')
-</pre>
-</li>
-</ul>
-<p>
-Note that the simple Client class is not particularly sophisticated and
-returns raw requests for some methods. I tend to use NamedBucket instead,
-which provides a simplified interface to a single bucket. This saves having
-to pass the bucket name to every method call, and parses bucket listings
-into an object representation.
-</p>
-<h1>Examples</h1>
-<h2>Command line client</h2>
-<p>
-If you want to see a full example program which uses the library, have a
-look at examples/cli/s3cli.rb. This is a simple command line client which
-you can use to post a file to S3 and email a link to the file to someone.
-Useful for sending big files to people without clogging their email inbox
-with enormous files. It is also intended as a demonstration of how to use
-the library. Full instructions are included at the top of the file.
-</p>
-<h2>Rails application</h2>
-<p>
-examples/fores33r contains a Rails application which makes use of the <a
-href="../classes/S33r.html">S33r</a> library. It will display a bucket list
-and the contents of individual buckets. You can upload files to your
-buckets using it.
-</p>
-<p>
-Before use, you will need to configure it by editing the file
-examples/s3.yaml (so it knows your Amazon S3 keys) and copying it into the
-config folder.
-</p>
-<p>
-This has been kept deliberately simple, and doesn&#8217;t provide any
-access control or logging management.
-</p>
-<h1>Credits</h1>
-<p>
-Thanks for bug reports to: Keaka (<a
-href="http://keakaj.com/products.htm">keakaj.com/products.htm</a>)
-</p>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>