yam-aws-s3 0.6.2.2

data/CHANGELOG

@@ -0,0 +1,105 @@
+head:
+
+0.6.2:
+
+- Apparently need to use custom __method__ in Ruby versions right up to 1.8.7.
+
+0.6.1:
+
+- Use custom __method__ in Ruby versions *prior* to 1.8.7 not *up to* 1.8.7.
+
+- Rename Kernel#memoize to Kernel#expirable_memoize so that it doesn't conflict with memoize method in ActiveSupport which has an entirely different API and semantics. Reported by [Florian Dütsc (mail@florian-duetsch.de)].
+
+0.6.0:
+
+- Full 1.9 compatibility (all tests passing against 1.9 & 1.8.6). Thanks to [David (dvdplm@gmail.com), Cyril David (cyx.ucron@gmail.com)]
+
+0.5.1:
+
+- For now just redefine __method__ to take arguments so we don't break 1.8.7 use today
+
+0.5.0:
+
+- Bug #17458 fixed. Normalize the :expires_in option to always be an integer even if the actual object passed in is a proxy to an integer, such as is the case with 2.hours from ActiveSupport which is actually an instance of ActiveSupport::Duration. Reported by [Steve Kickert steve@riverocktech.com]
+
+- Bug #19158 fixed. Don't prepend leading slash onto bucket name when deleting a bucket with the :force => true option.
+
+- Bug #17628 fixed. Don't ignore :use_ssl => false in url_for when the connection is established over ssl. Reported by [Tom Fixed (tkat11)]
+
+- Bug #13052 fixed. Appease some proxies by always including a Content-Length with all requests. Reported by [James Murty (jmurty)]
+
+- Bug #13756 fixed. Attributes that are false should not raise NoMethodError in Base#method_missing. Fixed by [Scott Patten]
+
+- Bug #19189 fixed. No longer reference Date::ABBR_MONTHS constant which was removed in Ruby 1.8.6. Reported by [Khurram Virani (kvirani)]
+
+- Bug #20487 fixed. If a request fails and is retried, only escape the request path the first time. Reported by [anonymous]
+
+- Replace ad-hoc S3Object.copy method with newly support built in API call.
+
+- Do not make connections persistent by default. This "feature" causes far more broken pipes than it is worth. Use with caution.
+
+0.4.0:
+
+- Various adjustments to connection handling to try to mitigate exceptions raised from deep within Net::HTTP.
+
+- Don't coerce numbers that start with a zero because the zero will be lost. If a bucket, for example, has a name like '0815', all operation it will fail. Closes ticket #10089 [reported anonymously]"
+
+- Add ability to connect through a proxy using the :proxy option when establishing a connection. Suggested by [Simon Horne <simon@soulware.co.uk>]
+
+- Add :authenticated option to url_for. When passing false, don't generate signature parameters for query string.
+
+- Make url_for accept custom port settings. [Rich Olson] 
+
+0.3.0:
+
+- Ensure content type is eventually set to account for changes made to Net::HTTP in Ruby version 1.8.5. Reported by [David Hanson, Stephen Caudill, Tom Mornini <tmornini@engineyard.com>]
+
+- Add :persistent option to connections which keeps a persistent connection rather than creating a new one per request, defaulting to true. Based on a patch by [Metalhead <metalhead@metalhead.ws>]
+
+- If we are retrying a request after rescuing one of the retry exceptions, rewind the body if its an IO stream so it starts at the beginning. [Jamis Buck]
+
+- Ensure that all paths being submitted to S3 are valid utf8. If they are not, we remove the extended characters. Ample help from [Jamis Buck]
+
+- Wrap logs in Log objects which exposes each line as a Log::Line that has accessors by name for each field.
+
+- Various performance optimizations for the extensions code. [Roman LE NEGRATE <roman2k@free.fr>]
+
+- Make S3Object.copy more efficient by streaming in both directions in parallel.
+
+- Open up Net:HTTPGenericRequest to make the chunk size 1 megabyte, up from 1 kilobyte.
+
+- Add S3Object.exists?
+
+0.2.1:
+
+- When the bucket name argument (for e.g. Bucket.objects) is being used as the option hash, reassign it to the options variable and set the bucket to nil so bucket inference + options works.
+
+- Don't call CGI.escape on query string parameters in Hash#to_query_string since all paths get passed through URI.escape right before the request is made. Paths were getting double escaped. Bug spotted by [David Hanson]
+
+- Make s3sh exec irb.bat if on Windows. Bug spotted by [N. Sathish Kumar <nsathishk@yahoo.com>]
+
+- Avoid class_variable_(get|set) since it was only recently added to Ruby. Spotted by [N. Sathish Kumar <nsathishk@yahoo.com>]
+
+- Raise NoSuchKey if S3Object.about requests a key that does not exist.
+
+- If the response body is an empty string, don't try to parse it as xml.
+
+- Don't reject every body type save for IO and String at the door when making a request. Suggested by [Alex MacCaw <maccman@gmail.com>]
+
+- Allow dots in bucket names. [Jesse Newland]
+
+0.2.0:
+
+- Infer content type for an object when calling S3Object.store without explicitly passing in the :content_type option.
+
+0.1.2:
+
+- Scrap (overly) fancy generator based version of CoercibleString with a much simpler and clearer case statement. Continuations are really slow and the specific use of the generator was leaking memory. Bug spotted by [Remco van't Veer]
+
+0.1.1:
+
+- Don't add the underscore method to String if it is already defined (like, for example, from ActiveSupport). Bug spotted by [Matt White <stockliasteroid@gmail.com>]
+
+0.1.0:
+
+- Initial public release

data/COPYING

@@ -0,0 +1,19 @@
+#
+# Copyright (c) 2006-2009 Marcel Molina Jr. <marcel@vernix.org>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), 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:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", 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.

data/INSTALL

@@ -0,0 +1,55 @@
+== Rubygems
+
+The easiest way to install aws/s3 is with Rubygems:
+
+  % sudo gem i aws-s3 -ry
+ 
+== Directly from svn
+
+ % svn co svn://rubyforge.org/var/svn/amazon/s3/trunk aws
+
+== As a Rails plugin
+
+If you want to use aws/s3 with a Rails application, you can export the repository
+into your plugins directory and then check it in: 
+
+  % cd my-rails-application/vendor/plugins
+  % svn export svn://rubyforge.org/var/svn/amazon/s3/trunk aws
+  % svn add aws
+  
+Or you could pull it down with an svn:externals:
+
+  % cd my-rails-application/vendor/plugins
+  % svn propedit svn:externals .
+  
+Then add the following line, save and exit:
+
+  aws svn://rubyforge.org/var/svn/amazon/s3/trunk
+  
+If you go the svn route, be sure that you have all the dependencies installed. The list of dependencies follow.
+  
+== Dependencies
+
+AWS::S3 requires Ruby 1.8.4 or greater. 
+
+It also has the following dependencies:
+
+  sudo gem i xml-simple -ry
+  sudo gem i builder    -ry
+  sudo gem i mime-types -ry
+
+=== XML parsing (xml-simple)
+
+AWS::S3 depends on XmlSimple (http://xml-simple.rubyforge.org/). When installing aws/s3 with
+Rubygems, this dependency will be taken care of for you. Otherwise, installation instructions are listed on the xml-simple
+site.
+
+If your system has the Ruby libxml bindings installed (http://libxml.rubyforge.org/) they will be used instead of REXML (which is what XmlSimple uses). For those concerned with speed and efficiency, it would behoove you to install libxml (instructions here: http://libxml.rubyforge.org/install.html) as it is considerably faster and less expensive than REXML.
+
+=== XML generation (builder)
+
+AWS::S3 also depends on the Builder library (http://builder.rubyforge.org/ and http://rubyforge.org/projects/builder/). This will also automatically be installed for you when using Rubygems.
+
+=== Content type inference (mime-types)
+
+AWS::S3 depends on the MIME::Types library (http://mime-types.rubyforge.org/) to infer the content type of an object that does not explicitly specify it. This library will automatically be installed for you when using Rubygems.

data/README.erb

@@ -0,0 +1,58 @@
+= AWS::S3
+
+<%= docs_for['AWS::S3'] %>
+
+== AWS::S3 Basics
+=== The service, buckets and objects
+
+The three main concepts of S3 are the service, buckets and objects. 
+
+==== The service
+
+<%= docs_for['AWS::S3::Service'] %>
+ 
+==== Buckets
+
+<%= docs_for['AWS::S3::Bucket'] %>
+
+==== Objects
+
+<%= docs_for['AWS::S3::S3Object'] %>
+
+==== Streaming uploads
+
+<%= docs_for['AWS::S3::S3Object::store'] %>
+
+== Setting the current bucket
+==== Scoping operations to a specific bucket
+
+<%= docs_for['AWS::S3::Base.set_current_bucket_to'] %>
+
+== BitTorrent
+==== Another way to download large files
+
+<%= docs_for['AWS::S3::BitTorrent'] %>
+
+== Access control
+==== Using canned access control policies
+
+<%= docs_for['AWS::S3::ACL'] %>
+
+==== Accessing private objects from a browser
+
+<%= docs_for['AWS::S3::S3Object.url_for'] %>
+
+== Logging
+==== Tracking requests made on a bucket
+
+<%= docs_for['AWS::S3::Logging'] %>
+
+== Errors
+==== When things go wrong
+
+<%= docs_for['AWS::S3::Error'] %>
+
+==== Accessing the last request's response
+
+<%= docs_for['AWS::S3::Service.response'] %>
+  

data/bin/s3sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+s3_lib   = File.dirname(__FILE__) + '/../lib/aws/s3'
+setup    = File.dirname(__FILE__) + '/setup'
+irb_name = RUBY_PLATFORM =~ /mswin32/ ? 'irb.bat' : 'irb'
+
+exec "#{irb_name} -r #{s3_lib} -r #{setup} --simple-prompt"

data/bin/setup.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+if ENV['AMAZON_ACCESS_KEY_ID'] && ENV['AMAZON_SECRET_ACCESS_KEY']
+  AWS::S3::Base.establish_connection!(
+    :access_key_id     => ENV['AMAZON_ACCESS_KEY_ID'], 
+    :secret_access_key => ENV['AMAZON_SECRET_ACCESS_KEY']
+  )
+end
+
+require File.dirname(__FILE__) + '/../test/fixtures'
+include AWS::S3