s33r 0.1

data/lib/s33r/list_bucket_result.rb

@@ -0,0 +1 @@
+# TODO: parser to provide a tree representation of keys in a bucket

data/lib/s33r/named_bucket.rb

@@ -0,0 +1,28 @@
+module S3
+  # a client for dealing with a single bucket
+  class NamedBucket < Client
+    attr_accessor :bucket_name
+
+    # TODO: check bucket exists before setting it
+    # options available:
+    # :public_contents => true: all items put into bucket are made public
+    def initialize(aws_access_key, aws_secret_access_key, bucket_name, options={}, &block)
+      super(aws_access_key, aws_secret_access_key)
+      @bucket_name = bucket_name
+      @client_headers.merge!(canned_acl_header('public-read')) if options[:public_contents]
+      yield self if block_given?
+    end
+
+    def root
+      list_bucket(@bucket_name)
+    end
+
+    def put_text(string, resource_key, headers={})
+      super(string, @bucket_name, resource_key, headers)
+    end
+
+    def put_file(filename, resource_key=nil, headers={})
+      super(filename, @bucket_name, resource_key, headers)
+    end
+  end
+end

data/lib/s33r/net_http_overrides.rb

@@ -0,0 +1,42 @@
+require 'net/http'
+
+class Net::HTTPResponse
+  attr_accessor :success
+
+  def ok?
+    success
+  end
+
+  def success
+    response.is_a?(Net::HTTPOK)
+  end
+
+  def to_s
+    body
+  end
+end
+
+class Net::HTTPGenericRequest
+  attr_accessor :chunk_size
+
+  private
+  def send_request_with_body_stream(sock, ver, path, f)
+    raise ArgumentError, "Content-Length not given and Transfer-Encoding is not `chunked'" unless content_length() or chunked?
+    unless content_type()
+      warn 'net/http: warning: Content-Type did not set; using application/x-www-form-urlencoded' if $VERBOSE
+      set_content_type 'application/x-www-form-urlencoded'
+    end
+    @chunk_size ||= 1024
+    write_header sock, ver, path
+    if chunked?
+      while s = f.read(@chunk_size)
+        sock.write(sprintf("%x\r\n", s.length) << s << "\r\n")
+      end
+      sock.write "0\r\n\r\n"
+    else
+      while s = f.read(@chunk_size)
+        sock.write s
+      end
+    end
+  end
+end

data/lib/s33r/s3_exception.rb

@@ -0,0 +1,20 @@
+module S3
+  module S3Exception
+  
+    class MethodNotAvailable < Exception
+    end
+    
+    class MissingRequiredHeaders < Exception
+    end
+    
+    class UnsupportedCannedACL < Exception
+    end
+    
+    class UnsupportedHTTPMethod < Exception
+    end
+    
+    class MalformedBucketName < Exception
+    end
+
+  end
+end

data/test/spec/spec_core.rb

@@ -0,0 +1,87 @@
+require 'rubygems'
+require_gem 'rspec'
+
+require File.dirname(__FILE__) + '/../../lib/s33r.rb'
+include S3
+
+context 'S3 module' do
+
+  setup do
+    @for_request_method = 'PUT'
+    @for_request_path = "/quotes/nelson"
+    @for_request_headers = {
+    "Content-Md5" => "c8fdb181845a4ca6b8fec737b3581d76",
+    "Content-Type" => "text/html",
+    "Date" => "Thu, 17 Nov 2005 18:49:58 GMT",
+    "X-Amz-Meta-Author" => "foo@bar.com",
+    "X-Amz-Magic" => "abracadabra"
+    }
+    @with_access_key = '44CF9590006BF252F707'
+    @with_secret_access_key = 'OtxrzxIsfpFjA7SwPzILwy8Bw21TLhquhboDYROV'
+
+    @for_incomplete_headers = @for_request_headers.clone.delete_if do |key,value|
+      'Content-Type' == key or 'Date' == key
+    end
+
+    @correct_canonical_string = "PUT\nc8fdb181845a4ca6b8fec737b3581d76\n" +
+    "text/html\nThu, 17 Nov 2005 18:49:58 GMT\nx-amz-magic:abracadabra\n" +
+    "x-amz-meta-author:foo@bar.com\n/quotes/nelson"
+    @correct_signature = "jZNOcbfWmD/A/f3hSvVzXZjM2HU="
+    @correct_auth_header = "AWS #{@with_access_key}:#{@correct_signature}"
+  end
+
+  specify 'should generate correct canonical strings' do
+    generate_canonical_string(@for_request_method, @for_request_path,
+    @for_request_headers).should.equal @correct_canonical_string
+  end
+
+  specify 'should generate correct signatures' do
+    generate_signature(@with_secret_access_key,
+    @correct_canonical_string).should.equal @correct_signature
+  end
+
+  specify 'should generate correct auth headers' do
+    generate_auth_header_value(@for_request_method, @for_request_path, @for_request_headers,
+    @with_access_key, @with_secret_access_key).should.equal @correct_auth_header
+  end
+
+  specify 'should not generate auth header if bad HTTP method passed' do
+    lambda { generate_auth_header_value('duff', nil, nil, nil, nil) }.should.raise
+    S3Exception::MethodNotAvailable
+  end
+
+  specify 'should not generate auth header if required headers missing' do
+    lambda { generate_auth_header_value('PUT', '/', @for_incomplete_headers,
+    nil, nil) }.should.raise S3Exception::MissingRequiredHeaders
+  end
+
+  specify 'when generating auth header, should allow addition of Date and Content-Type headers' do
+    now = Time.now
+
+    fixed_headers = add_default_headers(@for_incomplete_headers, :date => now,
+    :content_type => 'text/html')
+
+    fixed_headers['Date'].should.equal now.httpdate
+    fixed_headers['Content-Type'].should.equal 'text/html'
+  end
+
+  specify 'should not generate canned ACL header if invalid canned ACL supplied' do
+    lambda { canned_acl_header('duff') }.should.raise
+    S3Exception::UnsupportedCannedACL
+  end
+
+  specify 'should correctly add canned ACL headers' do
+    new_headers = canned_acl_header('private', { 'Content-Type' => 'text/html' })
+    new_headers.should.have(2).keys
+    new_headers.keys.should.include 'Content-Type'
+    new_headers.keys.should.include 'x-amz-acl'
+    new_headers['x-amz-acl'].should.equal 'private'
+  end
+
+  specify 'should set sensible defaults for missing Content-Type and Date headers' do
+    fixed_headers = add_default_headers(@for_incomplete_headers)
+    fixed_headers['Content-Type'].should.equal ''
+    fixed_headers.include?('Date').should.not.be nil
+  end
+
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: s33r
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+date: 2006-07-25 00:00:00 +01:00
+summary: A library for accessing Amazon S3
+require_paths: 
+- lib
+email: elliot@moochlabs.com/
+homepage: http://moochlabs.com/
+rubyforge_project: 
+description: 
+autorequire: s33r
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+- Elliot Smith
+files: 
+- bin/s3cli.rb
+- bin/config.yml
+- lib/s33r
+- lib/s33r.rb
+- lib/s33r/external
+- lib/s33r/client.rb
+- lib/s33r/list_bucket_result.rb
+- lib/s33r/net_http_overrides.rb
+- lib/s33r/s3_exception.rb
+- lib/s33r/core.rb
+- lib/s33r/named_bucket.rb
+- lib/s33r/external/mimetypes.rb
+- test/spec
+- test/spec/spec_core.rb
+- LICENSE.txt
+- README.txt
+- MIT-LICENSE
+test_files: 
+- test/spec/spec_core.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+