aws_sdk 3.1.5

data/lib/aws/core/data.rb

@@ -0,0 +1,242 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  module Core
+    
+    # Data is a light wrapper around a Ruby hash that provides
+    # method missing access to the hash contents.
+    #
+    # == Method Missing Access
+    #
+    # You can access hash content with methods if their keys
+    # are symbols.
+    #
+    #   data = AWS::Core::Data.new({ :a => 1, :b => 2, :c => true })
+    #   data.a #=> 1
+    #   data.b #=> 2
+    #   data.c #=> true
+    #   data.d #=> raises NoMethodError
+    #
+    # == Boolean Methods
+    #
+    # Given the structure above you can also use question-mark methods.
+    #
+    #   data.c? #=> true
+    #   data.d? #=> raises NoMethodError
+    #
+    # == Nested Hashes
+    #
+    # If the data contains nested hashes you can chain methods into
+    # the structure.
+    #
+    #   data = AWS::Core::Data.new(:a => { :b => { :c => 'abc' }})
+    #   data.a.b.c #=> 'abc'
+    #
+    # == Nested Arrays
+    #
+    # Arrays are wrapped in {Data::List} objects.  They ensure any
+    # data returned is correctly wrapped so you can continue using
+    # method-missing access.
+    #
+    #   data = AWS::Core::Data.new(
+    #    :people => [
+    #      {:name => 'john'},
+    #      {:name => 'jane'},
+    #   ]})
+    #
+    #   data.people[0].name #=> 'john'
+    #   data.people[1].name #=> 'jane'
+    #
+    #   data.people.map(&:name) #=> ['john','jane']
+    #
+    class Data
+
+      module MethodMissingProxy
+
+        # @private
+        def id
+          self[:id] || self.id  
+        end
+
+        def [] index_or_key
+          Data.cast(@data[index_or_key])
+        end
+
+        # @return [Boolean] Returns true if the passed object equals
+        #   the wrapped array.
+        def eql? other
+          if other.is_a?(MethodMissingProxy)
+            @data == other._data
+          else
+            @data == other
+          end
+        end
+        alias_method :==, :eql?
+
+        protected
+
+        def method_missing *args, &block
+          if block_given?
+            return_value = @data.send(*args) do |*values|
+              yield(*values.flatten.map{|v| Data.cast(v) })
+            end
+            Data.cast(return_value)
+          else
+            Data.cast(@data.send(*args))
+          end
+        end
+
+        def _data
+          @data
+        end
+
+      end
+
+      include MethodMissingProxy
+
+      def method_missing method_name, *args, &block
+        if 
+          args.empty? and !block_given? and
+          key = _remove_question_mark(method_name) and
+          @data.has_key?(key)
+        then
+          Data.cast(@data[key])
+        else
+          super
+        end
+      end
+      
+      # @param [Hash] data The ruby hash of data you need wrapped.
+      def initialize data
+        @data = data
+      end
+
+      # @return [Hash] Returns contents of this Data object as a raw hash.
+      def to_hash
+        @data
+      end
+      alias_method :to_h, :to_hash
+
+      # @return [Array]
+      def to_a
+        @data.to_a
+      end
+      alias_method :to_ary, :to_a
+
+      # @param [String,Symbol] method_name
+      # @return [Boolean] Returns true if this data object will
+      #   respond to the given method name.
+      def respond_to? method_name
+        @data.key?(_remove_question_mark(method_name)) or
+          @data.respond_to?(method_name)
+      end
+
+      # Returns an inspection string from the wrapped data.
+      #
+      #   data = AWS::Core::Data.new({ :a => 1, :b => 2, :c => true })
+      #   data.inspect #=> '{:a=>1, :b=>2, :c=>true}'
+      #
+      # @return [String]
+      #
+      def inspect
+        @data.inspect
+      end
+
+      # @private
+      def kind_of? klass
+        if klass == Hash
+          true
+        else
+          super
+        end
+      end
+      alias_method :is_a?, :kind_of?
+
+      protected
+
+      def _remove_question_mark method_name
+        case method_name
+        when Symbol then method_name.to_s.sub(/\?$/, '').to_sym
+        when String then method_name.sub(/\?$/, '')
+        else method_name
+        end
+      end
+
+      class << self
+        
+        # Given a hash, this method returns a {Data} object.  Given
+        # an Array, this method returns a {Data::List} object.  Everything
+        # else is returned as is.
+        #
+        # @param [Object] value The value to conditionally wrap.
+        #
+        # @return [Data,Data::List,Object] Wraps hashes and lists with 
+        #   Data and List objects, all other objects are returned as
+        #   is.
+        #
+        def cast value
+          case value
+          when Hash then Data.new(value)
+          when Array then Data::List.new(value)
+          else value
+          end
+        end
+
+      end
+
+      class List
+
+        include MethodMissingProxy
+        
+        # @param [Array] array
+        def initialize array
+          @data = array
+        end
+
+        # @return [String] Returns the inspection string for the
+        #   wrapped array.
+        def inspect
+          @data.inspect
+        end
+
+        # @return [Array] Returns the contents of this Data::List as
+        #   a raw array.
+        def to_ary
+          @data
+        end
+        alias_method :to_a, :to_ary
+
+        # #inject works on Core::Data::List in in 1.8.7 and 1.9.3, but not 
+        # in 1.9.2 unless we define it like so.
+        # @private
+        def inject *args, &block
+          @data.inject(*args) do |obj,value|
+            yield(Data.cast(obj),Data.cast(value))
+          end
+        end
+
+        # @private
+        def kind_of? klass
+          if klass == Array
+            true
+          else
+            super
+          end
+        end
+        alias_method :is_a?, :kind_of?
+
+      end
+    end
+  end
+end

data/lib/aws/core/default_signer.rb

@@ -0,0 +1,67 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'base64'
+require 'openssl'
+
+module AWS
+  module Core
+
+    # Computes signatures using credentials that are stored in memory.
+    class DefaultSigner
+
+      # @return [String] The Access Key ID used to sign requests.
+      attr_reader :access_key_id
+
+      # @return [String] The Secret Access Key used to sign requests.
+      attr_reader :secret_access_key
+
+      # @return [String] The Session Token used to sign requests.
+      attr_reader :session_token
+
+      # @param [String] access_key_id The Access Key ID used to sign
+      #   requests.
+      #
+      # @param [String] secret_access_key The Secret Access Key used to
+      #   sign requests.
+      #
+      # @param [String] session_token The Session Token used to sign
+      #   requests.  You can get credentials that include a session
+      #   token using the {STS} class.
+      def initialize(access_key_id, secret_access_key, session_token = nil)
+
+        @access_key_id = access_key_id
+        @secret_access_key = secret_access_key
+        @session_token = session_token
+
+        raise "Missing credentials" unless access_key_id and secret_access_key
+
+      end
+
+      # Signs a string using the credentials stored in memory.
+      #
+      # @param [String] string_to_sign The string to sign.
+      #
+      # @param [String] digest_method The digest method to use when
+      #   computing the HMAC digest.
+      def sign(string_to_sign, digest_method = 'sha256')
+        Base64.encode64(
+          OpenSSL::HMAC.digest(
+            OpenSSL::Digest::Digest.new(digest_method),
+            secret_access_key, 
+            string_to_sign)).strip
+      end
+
+    end
+  end
+end

data/lib/aws/core/http/curb_handler.rb

@@ -0,0 +1,136 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'thread'
+
+module AWS
+  module Core
+    module Http
+  
+      # @private
+      class CurbHandler
+
+        def initialize
+          @q = []
+          @sem = Mutex.new
+          @multi = Curl::Multi.new
+
+          start_processor
+        end
+
+        def handle request, response
+          raise "unsupport http reqest method: #{request.http_method}" unless
+            ['GET', 'HEAD', 'PUT', 'POST', 'DELETE'].include? request.http_method
+          @sem.synchronize do
+            @q << [request, response, Thread.current]
+            begin
+             @processor.wakeup
+            rescue ThreadError
+              start_processor
+            end
+          end
+          Thread.stop
+          nil
+        end
+
+        # fills the Curl::Multi handle with the given array of queue
+        # items, calling make_easy_handle on each one first
+        private
+        def fill_multi(items)
+          items.each do |item|
+            c = make_easy_handle(*item)
+            @multi.add(c)
+          end
+        end
+
+        # starts a background thread that waits for new items and
+        # sends them through the Curl::Multi handle
+        private
+        def start_processor
+          @processor = Thread.new do
+            loop do
+              items = nil
+              @sem.synchronize do
+                items = @q.slice!(0..-1)
+              end
+              unless items.empty?
+                fill_multi(items)
+                @multi.perform do
+                  # curl is idle, so process more items if we can get them
+                  # without blocking
+                  if !@q.empty? && @sem.try_lock
+                    begin
+                      fill_multi(@q.slice!(0..-1))
+                    ensure
+                      @sem.unlock
+                    end
+                  end
+                end
+              end
+
+              # wait for a new item to show up before continuing
+              Thread.stop if @q.empty?
+            end
+          end
+        end
+
+        private
+        def make_easy_handle request, response, thread = nil
+  
+          protocol = request.use_ssl? ? 'https' : 'http'
+          url = "#{protocol}://#{request.host}:#{request.port}#{request.uri}"
+  
+          curl = Curl::Easy.new(url)
+          # curl.verbose = true
+          request.headers.each {|k, v| curl.headers[k] = v}
+
+          if proxy = request.proxy_uri
+            curl.proxy_url = proxy.to_s
+            curl.proxy_port = proxy.port
+          end
+
+          curl.on_header {|header_data|
+            if header_data =~ /:\s+/
+              name, value = header_data.strip.split(/:\s+/, 2)
+              response.headers[name] = value
+            end
+            header_data.length
+          }
+
+          case request.http_method
+          when 'GET'
+            # ....
+          when 'HEAD'
+            curl.head = true
+          when 'PUT'
+            curl.put_data = request.body || ''
+          when 'POST'
+            curl.headers['Content-Type'] = curl.headers['Content-Type'] || ''
+            curl.post_body = request.body || ''
+          when 'DELETE'
+            curl.delete = true
+          end
+
+          curl.on_complete do
+            response.body = curl.body_str
+            response.status = curl.response_code
+            thread.run if thread
+          end
+
+          curl
+        end
+
+      end
+    end
+  end
+end

data/lib/aws/core/http/handler.rb

@@ -0,0 +1,77 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  module Core
+    module Http
+      
+      # @private
+      class Handler
+  
+        attr_reader :base
+  
+        def initialize(base, &block)
+          @base = base
+          if base.respond_to?(:handle)
+  
+            unless block.arity == 2
+              raise ArgumentError, 'passed block must accept 2 arguments'
+            end
+            MetaUtils.extend_method(self, :handle, &block)
+  
+          elsif base.respond_to?(:handle_async)
+  
+            unless block.arity == 3
+              raise ArgumentError, 'passed block must accept 3 arguments'
+            end
+  
+            MetaUtils.extend_method(self, :handle_async) do |req, resp, handle|
+              @base.handle_async(req, resp, handle)
+            end
+            MetaUtils.extend(self) do
+              define_method(:handle) do |req, resp|
+                raise "attempted to call #handle on an async handler"
+              end
+              define_method(:handle_async, &block)
+            end
+  
+          else
+            raise ArgumentError, 'base must respond to #handle or #handle_async'
+          end
+        end
+  
+        def handle(request, http_response)
+          @base.handle(request, http_response)
+        end
+  
+        def handle_async(request, http_response, handle)
+          Thread.new do
+            begin
+              self.handle(request, http_response)
+            rescue => e
+              handle.signal_failure
+            else
+              handle.signal_success
+            end
+          end
+        end
+  
+        def sleep_with_callback seconds, &block
+          Kernel.sleep(seconds)
+          yield
+        end
+  
+      end
+    end
+  end
+end