mss-sdk 1.0.0

data/lib/mss/core/query_client.rb

@@ -0,0 +1,40 @@
+# 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 QueryClient < Core::Client
+
+      protected
+
+      def self.request_builder_for api_config, operation
+        QueryRequestBuilder.new(api_config[:api_version], operation)
+      end
+
+      def self.response_parser_for api_config, operation
+        QueryResponseParser.new(operation[:outputs])
+      end
+
+      def extract_error_details response
+        if
+          response.http_response.status >= 300 and
+          body = response.http_response.body and
+          error = errors_module::GRAMMAR.parse(body) and
+          error[:code]
+        then
+          [error[:code], error[:message]]
+        end
+      end
+
+    end
+  end
+end

data/lib/mss/core/query_error_parser.rb

@@ -0,0 +1,23 @@
+# 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 QueryErrorParser
+
+
+    end
+
+  end
+end

data/lib/mss/core/query_request_builder.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
+
+    # @api private
+    class QueryRequestBuilder
+
+      def initialize api_version, operation
+        @api_version = api_version
+        @operation_name = operation[:name]
+        @grammar = OptionGrammar.customize(operation[:inputs])
+      end
+
+      def populate_request request, options
+
+          now = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ')
+
+          request.headers['Content-Type'] =
+            "application/x-www-form-urlencoded; charset=utf-8"
+
+          request.add_param 'Timestamp', now
+          request.add_param 'Version', @api_version
+          request.add_param 'Action', @operation_name
+
+          @grammar.request_params(options).each do |param|
+            request.add_param(param)
+          end
+          request.body = request.url_encoded_params
+
+      end
+
+    end
+
+  end
+end

data/lib/mss/core/query_response_parser.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 QueryResponseParser
+
+      def initialize parsing_rules
+        @parser = XML::Parser.new(parsing_rules)
+      end
+
+      def extract_data response
+        @parser.parse(response.http_response.body)
+      end
+
+      def simulate
+        @parser.simulate
+      end
+
+    end
+
+  end
+end

data/lib/mss/core/region.rb

@@ -0,0 +1,84 @@
+# 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
+
+    # Represents an MSS region.  A region has a name and provides access
+    # to service interface objects.
+    #
+    #   mss = MSS.regions['us-west-1']
+    #
+    #   mss.dynamo_db.tables.map(&:name)
+    #   mss.ec2.instances.map(&:id)
+    #
+    # Regions provide helper methods for each service.
+    #
+    # @attr_reader [AutoScaling] auto_scaling
+    # @attr_reader [CloudFormation] cloud_formation
+    # @attr_reader [CloudFront] cloud_front
+    # @attr_reader [CloudSearch] cloud_search
+    # @attr_reader [CloudTrail] cloud_trail
+    # @attr_reader [CloudWatch] cloud_watch
+    # @attr_reader [DataPipeline] data_pipeline
+    # @attr_reader [DirectConnect] direct_connect
+    # @attr_reader [DynamoDB] dynamo_db
+    # @attr_reader [EC2] ec2
+    # @attr_reader [ElasticBeanstalk] elastic_beanstalk
+    # @attr_reader [ElasticTranscoder] elastic_transcoder
+    # @attr_reader [ElastiCache] elasticache
+    # @attr_reader [ELB] elb
+    # @attr_reader [EMR] emr
+    # @attr_reader [Glacier] glacier
+    # @attr_reader [IAM] iam
+    # @attr_reader [ImportExport] import_export
+    # @attr_reader [Kinesis] kinesis
+    # @attr_reader [OpsWorks] ops_works
+    # @attr_reader [RDS] rds
+    # @attr_reader [Redshift] redshift
+    # @attr_reader [Route53] route_53
+    # @attr_reader [S3] s3
+    # @attr_reader [SimpleEmailService] ses
+    # @attr_reader [SimpleDB] simple_db
+    # @attr_reader [SNS] sns
+    # @attr_reader [SQS] sqs
+    # @attr_reader [StorageGateway] storage_gateway
+    # @attr_reader [STS] sts
+    # @attr_reader [Support] support
+    # @attr_reader [SimpleWorkflow] swf
+    #
+    class Region
+
+      # @param [String] name
+      # @option options [Configuration] :config (MSS.config)
+      def initialize name, options = {}
+        @name = name
+        @config = options[:config] || MSS.config
+        @config = @config.with(:region => name)
+      end
+
+      # @return [String] The name of this region (e.g. 'us-west-1').
+      attr_reader :name
+
+      # @return [Configuration]
+      attr_reader :config
+
+      MSS::SERVICES.values.each do |svc|
+        define_method(svc.method_name) do
+          MSS.const_get(svc.class_name).new(:config => config)
+        end
+        alias_method(svc.method_alias, svc.method_name) if svc.method_alias
+      end
+
+    end
+  end
+end

data/lib/mss/core/region_collection.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
+#
+#
+# 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 'uri'
+require 'net/http'
+require 'json'
+
+module MSS
+  module Core
+
+    # Provides a mechnasim to discover available regions.  This can useful if
+    # you want to perform an operation for a service in every region.
+    #
+    #   # call the EC2 DescribeInstances operation in each region
+    #   MSS.regions.each do |region|
+    #     resp = region.ec2.client.describe_instances
+    #   end
+    #
+    # You can also use this collection as a shortcut for creating
+    # a service interface with a given region.
+    #
+    #   s3 = MSS.regions['us-west-1'].s3
+    #
+    # This collection enumerates and returns {Region} objects.
+    #
+    # @see Region
+    class RegionCollection
+
+      include Enumerable
+
+      # @option options [Configuration] :config (MSS.config)
+      # @option options [ServiceInterface] :service (nil)
+      # @api private
+      def initialize options = {}
+        @config = options[:config] || MSS.config
+        @service = options[:service]
+      end
+
+      # @return [Configuration]
+      attr_reader :config
+
+      # @param [String] name
+      # @return [Region] Returns a {Region} with the given name.
+      def [] name
+        Region.new(name, :config => config)
+      end
+
+      # Enumerates public regions (non US Gov regions).
+      # @yieldparam [region] Region
+      def each &block
+        public_regions.each do |region_name|
+          yield(self[region_name])
+        end
+      end
+
+      private
+
+      # @return [Array<String>] Returns an array of non-gov-cloud region names.
+      def public_regions
+        return ['us-east-1'] if @service and @service.global_endpoint?
+        data = Endpoints.endpoints
+        regions = @service ?
+          data['services'][@service.endpoint_prefix] :
+          data['regions'].keys
+        regions.reject{ |r| r =~ /us-gov/ }.reject{ |r| r =~ /^cn-/ }
+      end
+
+    end
+  end
+end