mss-sdk 1.0.0

data/lib/mss/core/inflection.rb

@@ -0,0 +1,55 @@
+# 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
+#
+#
+# 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 MSS
+  module Core
+
+    # @api private
+    module Inflection
+
+      def ruby_name mss_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[mss_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/mss/core/ini_parser.rb

@@ -0,0 +1,41 @@
+# Copyright 2011-2014 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
+#
+#
+# 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 MSS
+  module Core
+
+    # @api private
+    module IniParser
+
+      def self.parse(ini)
+        current_section = {}
+        map = {}
+        ini.split(/\r?\n/).each do |line|
+          line = line.split(/^|\s;/).first # remove comments
+          section = line.match(/^\s*\[([^\[\]]+)\]\s*$/) unless line.nil?
+          if section
+            current_section = section[1]
+          elsif current_section
+            item = line.match(/^\s*(.+?)\s*=\s*(.+)\s*$/) unless line.nil?
+            if item
+              map[current_section] = map[current_section] || {}
+              map[current_section][item[1]] = item[2]
+            end
+          end  
+        end
+        map
+      end
+
+    end
+
+  end
+end

data/lib/mss/core/json_client.rb

@@ -0,0 +1,46 @@
+# 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
+#
+#
+# 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 MSS
+  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/mss/core/json_parser.rb

@@ -0,0 +1,75 @@
+# 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
+#
+#
+# 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 MSS
+  module Core
+
+    # @api 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) && !values[key].nil?
+            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/mss/core/json_request_builder.rb

@@ -0,0 +1,34 @@
+# 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
+#
+#
+# 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 MSS
+  module Core
+
+    # @api 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/mss/core/json_response_parser.rb

@@ -0,0 +1,78 @@
+# 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
+#
+#
+# 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 MSS
+  module Core
+
+    # @api 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/mss/core/lazy_error_classes.rb

@@ -0,0 +1,107 @@
+# 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
+#
+#
+# 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 MSS
+  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 MSS xml errors
+    #
+    # Here is an example of how it works:
+    #
+    #     Class Foo
+    #       module Errors
+    #         extend MSS::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 {MSS::Errors::Base}.
+    #
+    module LazyErrorClasses
+
+      # This grammar parses the defualt MSS XML error format
+      BASE_ERROR_GRAMMAR = XML::Grammar.customize do
+        element("Error") do
+          ignore
+        end
+      end
+
+      # @api 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
+          # It's possible the constant was defined by another thread while
+          # this thread was waiting on the mutex, check before setting.
+          if error_const_set?(constant)
+            const_get(constant)
+          else
+            const_set(constant, Class.new(Errors::Base) { extend LazyErrorClasses })
+          end
+        end
+      end
+
+      # Converts the error code into an error class constant.
+      #
+      #     MSS::EC2::Errors.error_class('Non.Existent.Error')
+      #     #=> MSS::EC2::Errors::Non::Existent::Error
+      #
+      # @param [String] code An MSS 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
+
+      private
+
+      # @return [Boolean] Returns true if the constant is defined in the
+      #   current module.
+      def error_const_set?(constant)
+        # Not using #const_defined? because in Ruby 1.9+, it returns true for
+        # constants not defined directly on the current module.
+        constant = constant.to_sym
+        # In Ruby 1.8, #constants returns an array of strings,
+        # in Ruby 1.9+, #constants returns an array of symbols.
+        constants.any? { |c| c.to_sym == constant }
+      end
+
+    end
+  end
+end