zzuligy / bucket_head

Gem to hit URI's and stick their contents on S3

BucketHead¶ ↑

BucketHead grabs the contents of a URI–an image, html or xml file, whatever–and sticks them on S3. It requires either the RightAWS or AWS/S3 libraries. If both are present it uses RightAWS.

Install:¶ ↑

sudo gem install john-bucket_head-0.1.0 --source http://gems.github.com

Usage:¶ ↑

Make a hash available in your environment called AWS_CREDENTIALS holding, yes, your AWS credential. In Rails you can create a config/initializers/amazon_credentials.rb file containing:

AWS_CREDENTIALS = { :access_key => 'your-key-goes-here',
                    :secret_access_key => 'your-top-secret-key-goes-here'}

Then you can do something like t:

BucketHead.set_bucket_name('your-bucket')
BucketHead.put( :uri => 'http://wordie.org/', :key => 'fake-wordie.html')

That would result in the source of wordie.org/ being uploaded to: your-bucket.s3.amazonaws.com/fake-wordie.html

By default buckets and anything put in them have ‘public-read’ access. You can set bucket permissions, if, prior to bucket creation, you call:

BucketHead.set_bucket_access( 'public-read|private|public-read-write|authenticated-read')

You can set access on individual objects within buckets with an ‘:access’ argument:

BucketHead.put( :uri => 'http://wordie.org/', :key => 'fake-wordie.html', :access => 'private')

BucketHead will try to base the content type on what it finds at the :uri, but you can set it explicitly if you want:

BucketHead.put( :uri => 'http://wordie.org/', :key => 'fake-wordie.html', :access => 'private', :content_type => 'text/html')

Copyright¶ ↑

Copyright © 2009 John McGrath, released under the MIT License. See LICENSE for details.