awsum 0.5

data/lib/awsum/s3/bucket.rb

@@ -0,0 +1,28 @@
+require 'awsum/s3/parsers/bucket_parser'
+
+module Awsum
+  class S3
+    class Bucket
+      attr_reader :name, :creation_date
+
+      def initialize(s3, name, creation_date = nil)
+        @s3 = s3
+        @name = name
+        @creation_date = creation_date
+      end
+
+      # Delete this Bucket
+      def delete
+        @s3.delete_bucket(@name)
+      end
+
+      # Delete this Bucket, recursively deleting all keys first
+      def delete!
+        @s3.keys(@name).each do |key|
+          key.delete
+        end
+        delete
+      end
+    end
+  end
+end

data/lib/awsum/s3/headers.rb

@@ -0,0 +1,24 @@
+module Awsum
+  class S3
+    class Headers #:nodoc:
+      def initialize(response)
+        @response = response
+      end
+
+      # Locking down to HTTPHeader methods only
+      def method_missing(method, *args, &block)
+        if !%w(body body_permitted? entity inspect read_body to_ary value).include?(method.to_s) && @response.respond_to?(method)
+          @response.send(method, *args, &block)
+        else
+          raise NoMethodError.new("undefined method `#{method}' for #{inspect}")
+        end
+      end
+
+      def inspect
+        headers = []
+        @response.canonical_each do |h,v| headers << h end
+        "#<Awsum::S3::Headers \"#{headers.join('", "')}\">"
+      end
+    end
+  end
+end

data/lib/awsum/s3/object.rb

@@ -0,0 +1,138 @@
+module Awsum
+  class S3
+    class Object
+      attr_reader :key, :bucket, :last_modified, :etag, :size, :owner, :storage_class
+
+      def initialize(s3, bucket, key, last_modified, etag, size, owner, storage_class)
+        @s3 = s3
+        @bucket = bucket
+        @key = key
+        @last_modified = last_modified
+        @etag = etag
+        @size = size
+        @owner = owner
+        @storage_class = storage_class
+      end
+
+      # Get the headers for this Object
+      #
+      # All header methods map directly to the Net::HTTPHeader module
+      def headers
+        @headers ||= @s3.object_headers(@bucket, @key)
+      end
+
+      # Retrieve the data stored for this Object
+      #
+      # You can get the data as a single call or add a block to retrieve the data in chunks
+      # ==Examples
+      #   content = object.data
+      #
+      # or
+      #
+      #   object.data do |chunk|
+      #     # handle chunk
+      #     puts chunk
+      #   end
+      def data(&block)
+        @s3.object_data @bucket, @key, &block
+      end
+
+      # Delete this Key
+      def delete
+        @s3.delete_object(@bucket, @key)
+      end
+
+      # Make a copy of this Object with a new key
+      def copy(new_key, headers = nil, meta_headers = nil)
+        @s3.copy_object(@bucket, @key, nil, new_key, headers, meta_headers)
+      end
+
+      # Rename or move this Object to a new key
+      def rename(new_key, headers = nil, meta_headers = nil)
+        copied = @s3.copy_object(@bucket, @key, nil, new_key, headers, meta_headers)
+        @s3.delete_object(@bucket, @key) if copied
+      end
+      alias_method :move, :rename
+
+      # Copy this Object to another Bucket
+      #
+      def copy_to(new_bucket, new_key = nil, headers = nil, meta_headers = nil)
+        @s3.copy_object(@bucket, @key, new_bucket, new_key, headers, meta_headers)
+      end
+
+      # Move this Object to another Bucket
+      def move_to(new_bucket, new_key = nil, headers = nil, meta_headers = nil)
+        copied = @s3.copy_object(@bucket, @key, new_bucket, new_key, headers, meta_headers)
+        @s3.delete_object(@bucket, @key) if copied
+      end
+    end
+
+#TODO: Create a more advanced array which can deal with pagination
+    class ObjectParser < Awsum::Parser #:nodoc:
+      def initialize(s3)
+        @s3 = s3
+        @bucket = ''
+        @objects = []
+        @text = nil
+        @stack = []
+      end
+
+      def tag_start(tag, attributes)
+        case tag
+          when 'ListBucketResult'
+            @stack << tag
+            @text = ''
+          when 'Contents'
+            @stack << tag
+            @current = {}
+            @text = ''
+          when 'Owner'
+            @owner = {}
+            @stack << tag
+        end
+      end
+
+      def text(text)
+        @text << text unless @text.nil?
+      end
+
+      def tag_end(tag)
+        case tag
+          when 'Name'
+            if @stack[-1] == 'ListBucketResult'
+              @bucket = @text.strip
+            end
+          when 'Contents'
+            @objects << Object.new(
+                          @s3,
+                          @bucket,
+                          @current['Key'],
+                          Time.parse(@current['LastModified']),
+                          @current['ETag'],
+                          @current['Size'].to_i,
+                          {'id' => @owner['ID'], 'name' => @owner['DisplayName']},
+                          @current['StorageClass']
+                        )
+            @current = nil
+            @text = nil
+            @stack.pop
+          when 'Owner'
+            @stack.pop
+          else
+            text = @text.strip unless @text.nil?
+            case @stack[-1]
+              when 'Owner'
+                @owner[tag] = (text == '' ? nil : text) unless @owner.nil?
+              when 'Contents'
+                @current[tag] = (text == '' ? nil : text) unless @current.nil?
+            end
+            @text = ''
+        end
+      end
+
+      def result
+        @objects
+      end
+    end
+  end
+end

data/lib/awsum/s3/parsers/bucket_parser.rb

@@ -0,0 +1,43 @@
+module Awsum
+  class S3
+    class BucketParser < Awsum::Parser #:nodoc:
+      def initialize(s3)
+        @s3 = s3
+        @buckets = []
+        @text = nil
+      end
+
+      def tag_start(tag, attributes)
+        case tag
+          when 'Bucket'
+            @current = {}
+            @text = ''
+        end
+      end
+
+      def text(text)
+        @text << text unless @text.nil?
+      end
+
+      def tag_end(tag)
+        case tag
+          when 'Bucket'
+            @buckets << Bucket.new(
+                          @s3,
+                          @current['Name'],
+                          Time.parse(@current['CreationDate'])
+                        )
+            @text = nil
+            @current = nil
+          else
+            text = @text.strip unless @text.nil?
+            @current[tag] = (text == '' ? nil : text) unless @current.nil?
+        end
+      end
+
+      def result
+        @buckets
+      end
+    end
+  end
+end

data/lib/awsum/support.rb

@@ -0,0 +1,94 @@
+# Thanks to RightAws for this idea!
+#
+# If ActiveSupport is loaded, then great - use it.  But we don't 
+# want a dependency on it, so if it's not present, define the few
+# extensions that we want to use...
+unless defined? ActiveSupport::CoreExtensions
+  # These are ActiveSupport-;like extensions to do a few handy things in the gems
+  # Derived from ActiveSupport, so the ActiveSupport copyright notice applies:
+  #
+  #
+  #
+  # Copyright (c) 2005 David Heinemeier Hansson
+  #
+  # 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.
+  #++
+  #
+  #
+
+  class Object #:nodoc:
+    # "", "   ", nil, [], and {} are blank
+    def blank?
+      if respond_to?(:empty?) && respond_to?(:strip)
+        empty? or strip.empty?
+      elsif respond_to?(:empty?)
+        empty?
+      else
+        !self
+      end
+    end
+  end
+
+  class NilClass #:nodoc:
+    def blank?
+      true
+    end
+  end
+
+  class FalseClass #:nodoc:
+    def blank?
+      true
+    end
+  end
+
+  class TrueClass #:nodoc:
+    def blank?
+      false
+    end
+  end
+
+  class Array #:nodoc:
+    alias_method :blank?, :empty?
+  end
+
+  class Hash #:nodoc:
+    alias_method :blank?, :empty?
+    
+    # Return a new hash with all keys converted to symbols.
+    def symbolize_keys
+      inject({}) do |options, (key, value)|
+        options[key.to_sym] = value
+        options
+      end
+    end
+  end
+
+  class String #:nodoc:
+    def blank?
+      empty? || strip.empty?
+    end
+  end
+
+  class Numeric #:nodoc:
+    def blank?
+      false
+    end
+  end
+end

data/spec/fixtures/ec2/addresses.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0"?>
+<DescribeAddressesResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>0a578151-76d1-4461-b1ce-ae36d39ec349</requestId>
+    <addressesSet>
+        <item>
+            <publicIp>127.0.0.1</publicIp>
+            <instanceId>i-3f1cc856</instanceId>
+        </item>
+    </addressesSet>
+</DescribeAddressesResponse>

data/spec/fixtures/ec2/allocate_address.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0"?>
+<AllocateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>c4e3b090-0fd8-4e65-aed7-4c3fe8fc7702</requestId>
+    <publicIp>127.0.0.1</publicIp>
+</AllocateAddressResponse>

data/spec/fixtures/ec2/associate_address.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0"?>
+<AssociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+  <requestId>668dec61-986c-468e-85be-4bfcd708fb1f</requestId>
+  <return>true</return>
+</AssociateAddressResponse></return></requestId></AssociateAddressResponse>

data/spec/fixtures/ec2/attach_volume.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<AttachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>3756a0c0-aa24-468d-9bd1-bfe2e54dd4cc</requestId>
+    <volumeId>vol-44d6322d</volumeId>
+    <instanceId>i-3f1cc856</instanceId>
+    <device>/dev/sdb</device>
+    <status>attaching</status>
+    <attachTime>2009-01-14T04:34:35.000Z</attachTime>
+</AttachVolumeResponse>

data/spec/fixtures/ec2/authorize_ip_access.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0"?>
+<AuthorizeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>80863a38-c204-492e-8c3e-d41b45379e3e</requestId>
+    <return>true</return>
+</AuthorizeSecurityGroupIngressResponse>

data/spec/fixtures/ec2/authorize_owner_group_access.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0"?>
+<AuthorizeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>0fa48cfd-7766-4713-aecd-140e50f24091</requestId>
+    <return>true</return>
+</AuthorizeSecurityGroupIngressResponse>

data/spec/fixtures/ec2/authorize_owner_group_access_error.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0"?>
+<Response><Errors><Error><Code>InvalidParameterCombination</Code><Message>The parameter 'CidrIp' may not be used in combination with 'SourceSecurityGroupOwnerId'</Message></Error></Errors><RequestID>6364d411-bdf0-4718-a2c9-219ebec33827</RequestID></Response>

data/spec/fixtures/ec2/availability_zones.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0"?>
+<DescribeAvailabilityZonesResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>6ffe1588-28b8-4033-a07c-97b029c6930a</requestId>
+    <availabilityZoneInfo>
+        <item>
+            <zoneName>eu-west-1a</zoneName>
+            <zoneState>available</zoneState>
+            <regionName>eu-west-1</regionName>
+        </item>
+        <item>
+            <zoneName>eu-west-1b</zoneName>
+            <zoneState>available</zoneState>
+            <regionName>eu-west-1</regionName>
+        </item>
+    </availabilityZoneInfo>
+</DescribeAvailabilityZonesResponse>

data/spec/fixtures/ec2/available_volume.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0"?>
+<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>f4786b8a-90e8-4570-a786-1076fba0eeae</requestId>
+    <volumeSet>
+        <item>
+            <volumeId>vol-44d6322d</volumeId>
+            <size>10</size>
+            <snapshotId/>
+            <availabilityZone>us-east-1b</availabilityZone>
+            <status>available</status>
+            <createTime>2009-01-14T03:57:08.000Z</createTime>
+        </item>
+    </volumeSet>
+</DescribeVolumesResponse>

data/spec/fixtures/ec2/create_key_pair.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0"?>
+<CreateKeyPairResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01/">
+    <requestId>6c6d3488-f769-431b-a838-2f630aa6c38b</requestId>
+    <keyName>test-keypair</keyName>
+    <keyFingerprint>ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab:ab</keyFingerprint>
+    <keyMaterial>-----BEGIN RSA PRIVATE KEY-----
+MIIEogIBAAKCAQEAqkxIjNxLV/shvaep5Kum3N2xTV6aBbXezVA4HHE371HSq3haKTcST7QYeQha
+92AmZojAm2ojqWMw9GJaeq/Q7NvXKdMgj3mKd7zY7tdC+HmKYVkAvJ9enuuVwPFxlt+5rPpZ2jS+
+kl4MWEvWh1N5U1urx5gzHq2e/k7P+dCBwFnCHsg/p1mym4j4qwEHEviaUG6SnB8Xvuggp/pxCmJg
+9Gie4cXNgbBboEyAQDRb/AmrehbBa90GOVDjDGIzB98rOcJ22FRrpLqSl2D+FQKsXWboqgbIrgKT
+ven7mzb8cgDJNrWTI/MNP8p8gNTh+L7gTwPDcGfaDBiRpn9t3FiTBwIDAQABAoIBAEmuNZmUWpjX
+U/LdjtkcF1bqKCMkchlUZfCI664KojvOOAruSHwakrafYhNDtS/gjtzAAC19z64i93RU9XatiQRh
+3YcADM9ms604rNcxlY0x8NhLjNEPVv4FScav8AhqBci8jJGnTmi/fjHZphjo2c5iFEGILV3xmp/G
+857PQsQ4nOAzoV7fQPYow4XiO/xhGh8p8o2Z9Og3GdbEGH1v/051g3O1eU7PFyQaxmOGNYmklMuM
+V/8l/LK+OKR0f9KgqcgDSlEbidqsmWM0a1/t7+I5W/mgXSZl5U4HN680DKbkzoX0kgoPN7XMbcSX
+sHNguqDfrvkBUQu1vEaXebWfpekCgYEA0qVbcFGxKniyYxmvtSrbb5bpEnh6zRCGXgSU4fX41i8P
+Xg15R7FnwGO5nuRXqGW6CSgfbA7YAVEQHunUOB0XWuJWgn6gsqvnCZvyfRnqyMJJjRhvuaUMTn/5
+ikcayflqPFHvv5Z+pB3pWNaTD6lM5imdF1In9RBYL4q5Vpt9gl0CgYEAzvb6cS6Yi0PkxU3OOEmg
+98QcdTEd1hrk3r6uXI1TOeiUPIw+dyGCKa9OqpcFDs+0FskFs6RzztRh2gpwQZTH3UOYPqsjsWd+
+AjL3jv+vmpU1OhnA0SpkyiiZtaSAV2N+Xlq8orG6fbnYFCdzHbufLFaoOpbGptmLfrwMSvnhXLMC
+gYBxRsEcbqHycAOmLUsDBvAIW0QtTaLkIe3QI3CY7viI3bfK4T4GIs3jdP1+B9dn1IStpej36Cea
+1afwp9ga8PH9Stgwxr3ON4k/7qABTG2o1mpNOQXj9HDgygs8pC4wzTKnC3z9L4Yc5YT15DYjZuzW
+nSxAPUsFi2uQ7W3ruCRPdQKBgGslsCiyb+UBpEmFa3L2o3BCRl1hrUmwKLcszsY5oFHFmCD0lk5E
+ucds6/QjNUoiu+Bj+CC1zgLRL0ubxdwd848YtJQVM+hfZPwseL++naIRBzpqJMnlAcMrW9CPNqaH
+at/cZ/ZuvtbiRPzCI7XL8a8ZugSDFJtC2xYkstSKI2NDAoGAIiwUwKRMJyB9IRXhMfpf6vsEza2t
+urHVUdJUyIwvPJSh2PfkumwrPuk+P+8v6jJjJ0hsqOS+TLQwWclIGwGey/PMNRYqQDqnSUofNmza
+XtGGfWTOD3AdDEH39RTd3Zmfirrjm1YsY/Nb54X+V5TN2uvm/yJBIbb4aLvfG74Jmoc=
+-----END RSA PRIVATE KEY-----</keyMaterial>
+</CreateKeyPairResponse>