aws-sdk-euca 1.8.5

data/lib/aws/core/indifferent_hash.rb

@@ -0,0 +1,88 @@
+# Copyright 2011-2013 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
+
+    # A utility class to provide indifferent access to hash data.
+    #
+    # Inspired by ActiveSupport's HashWithIndifferentAccess, this class
+    # has a few notable differences:
+    #
+    # * ALL keys are converted to strings (via #to_s)
+    # * It does not deep merge/convert hashes indifferently, good for fla
+    # * It will not perserve default value behaviours
+    #
+    # These features were omitted because our primary use for this class is to
+    # wrap a 1-level hash as a return value, but we want the user to access
+    # the values with string or symbol keys.
+    #
+    # @private
+    class IndifferentHash < Hash
+
+      def initialize *args
+        if args.first.is_a?(Hash)
+          super()
+          merge!(*args)
+        else
+          super(*args)
+        end
+      end
+
+      alias_method :_getter, :[]
+      alias_method :_setter, :[]=
+
+      def []=(key, value)
+        _setter(_convert_key(key), value)
+      end
+      alias_method :store, :[]=
+
+      def [] key
+        _getter(_convert_key(key))
+      end
+
+      def merge! hash
+        hash.each_pair do |key,value|
+          self[key] = value
+        end
+        self
+      end
+      alias_method :update, :merge!
+
+      def merge hash
+        self.dup.merge!(hash)
+      end
+
+      def has_key? key
+        super(_convert_key(key))
+      end
+      alias_method :key?, :has_key?
+      alias_method :member?, :has_key?
+      alias_method :include?, :has_key?
+
+      def fetch key, *extras, &block
+        super(_convert_key(key), *extras, &block)
+      end
+
+      def delete key
+        super(_convert_key(key))
+      end
+
+      private
+      def _convert_key key
+        key.is_a?(String) ? key : key.to_s
+      end
+
+    end
+  end
+end

data/lib/aws/core/inflection.rb

@@ -0,0 +1,56 @@
+# Copyright 2011-2013 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
+
+    # @private
+    module Inflection
+
+      def ruby_name aws_name
+
+        inflector = Hash.new do |hash,key|
+
+          key.
+            sub(/^.*:/, '').                          # strip namespace
+            gsub(/([A-Z0-9]+)([A-Z][a-z])/, '\1_\2'). # split acronyms
+            scan(/[a-z]+|\d+|[A-Z0-9]+[a-z]*/).       # split words
+            join('_').downcase                        # join parts
+
+        end
+
+        # add a few irregular inflections
+        inflector['ETag'] = 'etag'
+        inflector['s3Bucket'] = 's3_bucket'
+        inflector['s3Key'] = 's3_key'
+        inflector['Ec2KeyName'] = 'ec2_key_name'
+        inflector['Ec2SubnetId'] = 'ec2_subnet_id'
+        inflector['Ec2VolumeId'] = 'ec2_volume_id'
+        inflector['Ec2InstanceId'] = 'ec2_instance_id'
+        inflector['ElastiCache'] = 'elasticache'
+        inflector['NotificationARNs'] = 'notification_arns'
+
+        inflector[aws_name]
+
+      end
+      module_function :ruby_name
+
+      def class_name(name)
+        name.sub(/^(.)/) { |m| m.upcase }.
+          gsub(/[-_]([a-z])/i) { |m| m[1,1].upcase }
+      end
+      module_function :class_name
+
+    end
+  end
+end

data/lib/aws/core/json_client.rb

@@ -0,0 +1,47 @@
+# Copyright 2011-2013 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
+    class JSONClient < Core::Client
+
+      protected
+
+      def self.request_builder_for api_config, operation
+        JSONRequestBuilder.new(api_config, operation)
+      end
+
+      def self.response_parser_for api_config, operation
+        JSONResponseParser.new(operation[:outputs])
+      end
+
+      def extract_error_details response
+        if
+          response.http_response.status >= 300 and
+          body = response.http_response.body and
+          json = (::JSON.load(body) rescue nil) and
+          type = json["__type"]
+        then
+          code = type.split('#').last
+          if code == 'RequestEntityTooLarge'
+            message = 'Request body must be less than 1 MB'
+          else
+            message = json['message'] || json['Message']
+          end
+          [code, message]
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/core/json_parser.rb

@@ -0,0 +1,76 @@
+# Copyright 2011-2013 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 'json'
+require 'time'
+require 'bigdecimal'
+require 'base64'
+
+module AWS
+  module Core
+
+    # @private
+    class JSONParser
+
+      def initialize rules
+        @rules = rules
+      end
+
+      attr_reader :rules
+
+      def parse body
+        body = "{}" if [nil, ''].include?(body)
+        translate(JSON.load(body))
+      end
+
+      protected
+
+      # @param [Hash] values
+      # @param [Hash] rules
+      # @return [Hash]
+      def translate values, rules = @rules
+        rules.inject({}) do |data,(key,rule)|
+          if values.key?(key)
+            data.merge(rule[:sym] || key => translate_value(values[key], rule))
+          else
+            data
+          end
+        end
+      end
+
+      def translate_hash values, rules
+        translate(values, rules[:members])
+      end
+
+      def translate_map values, rules
+        values.inject({}) do |data,(key,value)|
+          data.merge(key => translate_value(value, rules[:members]))
+        end
+      end
+
+      def translate_value value, rule
+        case
+        when value.is_a?(Array) then value.map{|v| translate_value(v, rule) }
+        when rule[:type] == :hash then translate_hash(value, rule)
+        when rule[:type] == :map then translate_map(value, rule)
+        when rule[:type] == :blob then Base64.decode64(value)
+        when rule[:type] == :time then Time.at(value)
+        when rule[:type] == :big_decimal then BigDecimal.new(value)
+        else value
+        end
+      end
+
+    end
+
+  end
+end

data/lib/aws/core/json_request_builder.rb

@@ -0,0 +1,35 @@
+# Copyright 2011-2013 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
+
+    # @private
+    class JSONRequestBuilder
+
+      def initialize api, operation
+        @x_amz_target = api[:target_prefix] + operation[:name]
+        @content_type = "application/x-amz-json-#{api[:json_version] || 1.0}"
+        @grammar = OptionGrammar.customize(operation[:inputs])
+      end
+
+      def populate_request request, options
+        request.headers["content-type"] = @content_type
+        request.headers["x-amz-target"] = @x_amz_target
+        request.body = @grammar.to_json(options)
+      end
+
+    end
+
+  end
+end

data/lib/aws/core/json_response_parser.rb

@@ -0,0 +1,79 @@
+# Copyright 2011-2013 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 'json'
+require 'time'
+require 'bigdecimal'
+require 'base64'
+
+module AWS
+  module Core
+
+    # @private
+    class JSONResponseParser
+
+      def initialize rules
+        @rules = rules
+      end
+
+      def extract_data response
+        body = response.http_response.body
+        body = "{}" if [nil, ''].include?(body)
+        translate(JSON.load(body))
+      end
+
+      def simulate
+        {}
+      end
+
+      protected
+
+      # @param [Hash] values
+      # @param [Hash] rules
+      # @return [Hash]
+      def translate values, rules = @rules
+        rules.inject({}) do |data,(key,rule)|
+          if values.key?(key)
+            data.merge(rule[:sym] || key => translate_value(values[key], rule))
+          else
+            data
+          end
+        end
+      end
+
+      def translate_hash values, rules
+        translate(values, rules[:members])
+      end
+
+      def translate_map values, rules
+        values.inject({}) do |data,(key,value)|
+          data.merge(key => translate_value(value, rules[:members]))
+        end
+      end
+
+      def translate_value value, rule
+        case
+        when value.is_a?(Array) then value.map{|v| translate_value(v, rule) }
+        when rule[:type] == :hash then translate_hash(value, rule)
+        when rule[:type] == :map then translate_map(value, rule)
+        when rule[:type] == :blob then Base64.decode64(value)
+        when rule[:type] == :time then Time.at(value)
+        when rule[:type] == :big_decimal then BigDecimal.new(value)
+        else value
+        end
+      end
+
+    end
+
+  end
+end

data/lib/aws/core/lazy_error_classes.rb

@@ -0,0 +1,90 @@
+# Copyright 2011-2013 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
+
+    # Provides lazy creation of error classes via {#const_missing}.  
+    #
+    # Extend this module provides 3 benefits to another module:
+    #
+    # * A method that accepts strings and returns error classes.
+    # * Thread-safe dynamic error class creation via {#const_missing}
+    # * An error grammar for parsing AWS xml errors
+    #
+    # Here is an example of how it works:
+    #
+    #  Class Foo 
+    #    module Errors
+    #      extend AWS::Core::LazyErrorClasses
+    #    end
+    #  end
+    #
+    #  Foo::Errors.error_class('NoSuchKey')
+    #  #=> Foo::Errors::NoSuckKey
+    #
+    #  Foo::Errors.error_class('Nested.Error.Klasses')
+    #  #=> Foo::Errors::Nested::Error::Klasses
+    #
+    # The errors returned from {#error_class} are subclasses
+    # of {AWS::Errors::Base}.
+    #
+    module LazyErrorClasses
+
+      # This grammar parses the defualt AWS XML error format  
+      BASE_ERROR_GRAMMAR = XML::Grammar.customize do
+        element("Error") do
+          ignore
+        end
+      end
+
+      # @private
+      def self.extended base
+
+        unless base.const_defined?(:GRAMMAR)
+          base.const_set(:GRAMMAR, BASE_ERROR_GRAMMAR)
+        end
+      
+        mutex = Mutex.new
+        MetaUtils.extend_method(base, :const_missing_mutex) { mutex }
+
+      end
+  
+      # Defines a new error class.
+      # @param [String,Symbol] constant
+      # @return [nil]
+      def const_missing constant
+        const_missing_mutex.synchronize do
+          const_set(constant, Class.new(Errors::Base) { extend LazyErrorClasses })
+        end
+      end
+
+      # Converts the error code into an error class constant.
+      #
+      #   AWS::EC2::Errors.error_class('Non.Existent.Error')
+      #   #=> AWS::EC2::Errors::Non::Existent::Error
+      # 
+      # @param [String] code An AWS error code.
+      #
+      # @return [Class] Returns the error class defiend by the error code.
+      #
+      def error_class code
+        module_eval("#{self}::#{code.gsub('.Range','Range').gsub(".","::")}")
+      end
+  
+    end
+
+  end
+end