simple_aws 1.0.0 → 1.1.0

data/History.md

@@ -0,0 +1,12 @@
+SimpleAWS Changelog
+===================
+
+1.1
+---
+
+* Change AWS:: to SimpleAWS:: and require 'aws/...' to require 'simple_aws/...'
+
+1.0
+---
+
+* Initial release!

data/README.md

@@ -33,14 +33,14 @@ It's well know that AWS has its share of warts and wtfs. SimpleAWS doesn't try t
 First of all, calling actions are implemented as ruby methods, handled through mainly through `method_missing` (S3 and CloudFront are the two current exceptions). You can call the AWS actions by AWSName or by ruby_name, they both work:
 
 ``` ruby
-ec2 = AWS::EC2.new key, secret
+ec2 = SimpleAWS::EC2.new key, secret
 ec2.describe_instances
 ```
 
 or
 
 ``` ruby
-ec2 = AWS::EC2.new key, secret
+ec2 = SimpleAWS::EC2.new key, secret
 ec2.DescribeInstances
 ```
 
@@ -53,7 +53,7 @@ Adding parameters to your method calls follows similar rules, with some Quality
 You can't get simpler than just using the names of the parameters as defined in the AWS docs:
 
 ``` ruby
-ec2 = AWS::EC2.new key, secret
+ec2 = SimpleAWS::EC2.new key, secret
 ec2.describe_instances({
   "Filter.1.Name" => "instance-state-name",
   "Filter.1.Value.1" => "running"
@@ -66,7 +66,7 @@ ec2.describe_instances({
 Ruby Arrays will automatically be built into the "Key.n" format you see in the AWS docs:
 
 ``` ruby
-ec2 = AWS::EC2.new key, secret
+ec2 = SimpleAWS::EC2.new key, secret
 ec2.describe_instances({
   "Filter.1.Name" => "instance-state-name",
   "Filter.1.Value" => ["running", "pending"]
@@ -78,7 +78,7 @@ ec2.describe_instances({
 You can take this the next step and use a Ruby Hash to make this even cleaner:
 
 ``` ruby
-ec2 = AWS::EC2.new key, secret
+ec2 = SimpleAWS::EC2.new key, secret
 ec2.describe_instances({
   "Filter" => [
     {"Name" => "instance-state-name", "Value" => ["running", "pending"]}
@@ -88,36 +88,36 @@ ec2.describe_instances({
 
 ### Response Parsing
 
-All requests return an AWS::Response object which does a few cleanup tasks on the resulting XML to make it easier to query and to hide some of the worst warts an XML body tends to have.
+All requests return an SimpleAWS::Response object which does a few cleanup tasks on the resulting XML to make it easier to query and to hide some of the worst warts an XML body tends to have.
 
-First of all, wherever AWS returns a list of items, they often get wrapped up in an `<item>` or `<member>` wrapper tag. AWS::Response gets rid of those tags and gives you a flat array to work with.
+First of all, wherever AWS returns a list of items, they often get wrapped up in an `<item>` or `<member>` wrapper tag. SimpleAWS::Response gets rid of those tags and gives you a flat array to work with.
 
-Second, the resulting XML can have one or two wrapper objects that do nothing but encapsulate the information you're interested in. AWS::Response also jumps past these wrapper objects so you have direct access to the data in the response.
+Second, the resulting XML can have one or two wrapper objects that do nothing but encapsulate the information you're interested in. SimpleAWS::Response also jumps past these wrapper objects so you have direct access to the data in the response.
 
-All response objects are infinitely deep queryable via methods or Hash access. See the samples, tests, and AWS::Response for more details and examples of usage. At all times you can easily inspect the current Response object for the entire response body, or just the rest of the body at the current depth level.
+All response objects are infinitely deep queryable via methods or Hash access. See the samples, tests, and SimpleAWS::Response for more details and examples of usage. At all times you can easily inspect the current Response object for the entire response body, or just the rest of the body at the current depth level.
 
 Implemented APIs
 ----------------
 
 These are the Amazon APIs that SimpleAWS currently handles:
 
-* {AWS::S3 S3}
-* {AWS::EC2 EC2}
-* {AWS::ELB ELB}
-* {AWS::IAM IAM}
-* {AWS::MapReduce MapReduce}
-* {AWS::AutoScaling Auto Scaling}
-* {AWS::RDS RDS}
-* {AWS::ElastiCache ElastiCache}
-* {AWS::ElasticBeanstalk Elastic Beanstalk}
-* {AWS::CloudFormation CloudFormation}
-* {AWS::SNS SNS}
-* {AWS::CloudWatch CloudWatch}
-* {AWS::ImportExport ImportExport}
-* {AWS::MechanicalTurk MechanicalTurk}
-* {AWS::SQS SQS}
-* {AWS::SES SES}
-* {AWS::CloudFront CloudFront}
+* {SimpleAWS::S3 S3}
+* {SimpleAWS::EC2 EC2}
+* {SimpleAWS::ELB ELB}
+* {SimpleAWS::IAM IAM}
+* {SimpleAWS::MapReduce MapReduce}
+* {SimpleAWS::AutoScaling Auto Scaling}
+* {SimpleAWS::RDS RDS}
+* {SimpleAWS::ElastiCache ElastiCache}
+* {SimpleAWS::ElasticBeanstalk Elastic Beanstalk}
+* {SimpleAWS::CloudFormation CloudFormation}
+* {SimpleAWS::SNS SNS}
+* {SimpleAWS::CloudWatch CloudWatch}
+* {SimpleAWS::ImportExport ImportExport}
+* {SimpleAWS::MechanicalTurk MechanicalTurk}
+* {SimpleAWS::SQS SQS}
+* {SimpleAWS::SES SES}
+* {SimpleAWS::CloudFront CloudFront}
 
 Not Currently Implemented
 -------------------------

data/lib/{aws → simple_aws}/api.rb

@@ -1,8 +1,8 @@
-require 'aws/core/util'
-require 'aws/core/connection'
-require 'aws/core/request'
+require 'simple_aws/core/util'
+require 'simple_aws/core/connection'
+require 'simple_aws/core/request'
 
-module AWS
+module SimpleAWS
 
   ##
   # Base class for all endpoint handler classes.

data/lib/{aws → simple_aws}/auto_scaling.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon Auto Scaling
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class AutoScaling < API
     endpoint "autoscaling"

data/lib/{aws → simple_aws}/call_types/action_param.rb

@@ -1,8 +1,8 @@
-require 'aws/core/util'
-require 'aws/core/request'
-require 'aws/core/connection'
+require 'simple_aws/core/util'
+require 'simple_aws/core/request'
+require 'simple_aws/core/connection'
 
-module AWS
+module SimpleAWS
   module CallTypes
 
     ##
@@ -14,7 +14,7 @@ module AWS
     # with either the Ruby-fied name, or the full CamelCase name, and pass in
     # options required as the parameters.
     #
-    # All responses will be wrapped up in an {AWS::Response AWS::Response} object.
+    # All responses will be wrapped up in an {SimpleAWS::Response SimpleAWS::Response} object.
     ##
     module ActionParam
       ##
@@ -22,8 +22,8 @@ module AWS
       # actions and return the results
       ##
       def method_missing(name, *args)
-        request = AWS::Request.new :post, self.uri, "/"
-        request.params["Action"] = AWS::Util.camelcase(name.to_s)
+        request = SimpleAWS::Request.new :post, self.uri, "/"
+        request.params["Action"] = SimpleAWS::Util.camelcase(name.to_s)
 
         if args.any? && args.first.is_a?(Hash)
           insert_params_from request, args.first
@@ -35,7 +35,7 @@ module AWS
       protected
 
       def send_request(request)
-        connection = AWS::Connection.new
+        connection = SimpleAWS::Connection.new
         connection.call finish_and_sign_request(request)
       end
 

data/lib/{aws → simple_aws}/cloud_formation.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's CloudFormation
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class CloudFormation < API
     endpoint "cloudformation"

data/lib/{aws → simple_aws}/cloud_front.rb

@@ -1,7 +1,7 @@
-require 'aws/api'
-require 'aws/core/util'
+require 'simple_aws/api'
+require 'simple_aws/core/util'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's CloudFront
@@ -52,7 +52,7 @@ module AWS
   #
   #   cloud_front.post "/distribution", :body => raw_body_xml
   #
-  # All responses are wrapped in an AWS::Response object.
+  # All responses are wrapped in an SimpleAWS::Response object.
   ##
   class CloudFront < API
     endpoint "cloudfront"
@@ -69,9 +69,9 @@ module AWS
     # @param path [String] The path of the resource at hand
     # @param options [Hash] Options as defined above
     #
-    # @return [AWS::Response] The results of the request
+    # @return [SimpleAWS::Response] The results of the request
     #
-    # @raise [AWS::UnsuccessfulResponse, AWS::UnknownErrorResponse] on response errors
+    # @raise [SimpleAWS::UnsuccessfulResponse, SimpleAWS::UnknownErrorResponse] on response errors
     ##
     def get(path, options = {})
       call :get, path, options
@@ -83,9 +83,9 @@ module AWS
     # @param path [String] The path of the resource at hand
     # @param options [Hash] Options as defined above
     #
-    # @return [AWS::Response] The results of the request
+    # @return [SimpleAWS::Response] The results of the request
     #
-    # @raise [AWS::UnsuccessfulResponse, AWS::UnknownErrorResponse] on response errors
+    # @raise [SimpleAWS::UnsuccessfulResponse, SimpleAWS::UnknownErrorResponse] on response errors
     ##
     def post(path, options = {})
       call :post, path, options
@@ -97,9 +97,9 @@ module AWS
     # @param path [String] The path of the resource at hand
     # @param options [Hash] Options as defined above
     #
-    # @return [AWS::Response] The results of the request
+    # @return [SimpleAWS::Response] The results of the request
     #
-    # @raise [AWS::UnsuccessfulResponse, AWS::UnknownErrorResponse] on response errors
+    # @raise [SimpleAWS::UnsuccessfulResponse, SimpleAWS::UnknownErrorResponse] on response errors
     ##
     def put(path, options = {})
       call :put, path, options
@@ -111,9 +111,9 @@ module AWS
     # @param path [String] The path of the resource at hand
     # @param options [Hash] Options as defined above
     #
-    # @return [AWS::Response] The results of the request
+    # @return [SimpleAWS::Response] The results of the request
     #
-    # @raise [AWS::UnsuccessfulResponse, AWS::UnknownErrorResponse] on response errors
+    # @raise [SimpleAWS::UnsuccessfulResponse, SimpleAWS::UnknownErrorResponse] on response errors
     ##
     def delete(path, options = {})
       call :delete, path, options
@@ -126,12 +126,12 @@ module AWS
     # @param path [String] The path of the resource at hand
     # @param options [Hash] Options as defined above
     #
-    # @return [AWS::Response] The results of the request
+    # @return [SimpleAWS::Response] The results of the request
     #
-    # @raise [AWS::UnsuccessfulResponse, AWS::UnknownErrorResponse] on response errors
+    # @raise [SimpleAWS::UnsuccessfulResponse, SimpleAWS::UnknownErrorResponse] on response errors
     ##
     def call(method, path, options = {})
-      request = AWS::Request.new method, self.uri, "/#{self.version}#{path}"
+      request = SimpleAWS::Request.new method, self.uri, "/#{self.version}#{path}"
 
       (options[:params] || {}).each do |k, v|
         request.params[k] = v
@@ -145,13 +145,13 @@ module AWS
         raise ":xml must be a Hash" unless xml.is_a?(Hash)
 
         namespace = "http://cloudfront.amazonaws.com/doc/#{self.version}"
-        request.body = AWS::Util.build_xml_from xml, namespace
+        request.body = SimpleAWS::Util.build_xml_from xml, namespace
         request.headers["Content-Type"] = "text/xml"
       else
         request.body = options[:body]
       end
 
-      connection = AWS::Connection.new
+      connection = SimpleAWS::Connection.new
       connection.call finish_and_sign_request(request)
     end
 

data/lib/{aws → simple_aws}/cloud_watch.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Cloud Watch
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class CloudWatch < API
     endpoint "monitoring"

data/lib/{aws → simple_aws}/core/connection.rb

@@ -1,7 +1,7 @@
 require 'httparty'
 require 'openssl'
 
-require 'aws/core/response'
+require 'simple_aws/core/response'
 
 ##
 # Monkey-patch body_stream usage into HTTParty
@@ -27,7 +27,7 @@ module HTTParty
   end
 end
 
-module AWS
+module SimpleAWS
 
   ##
   # Custom response parser to handle the various craziness of the AWS API
@@ -55,11 +55,11 @@ module AWS
   class Connection
 
     ##
-    # Send an AWS::Request to AWS proper, returning an AWS::Response.
+    # Send an SimpleAWS::Request to AWS proper, returning an SimpleAWS::Response.
     # Will raise if the request has an error
     ##
     def call(request)
-      AWS::Response.new(
+      SimpleAWS::Response.new(
         HTTP.send(request.method,
           request.uri,
           :query => request.params,

data/lib/{aws → simple_aws}/core/request.rb

@@ -1,4 +1,4 @@
-module AWS
+module SimpleAWS
 
   ##
   # Defines all request information needed to run a request against an AWS API
@@ -44,7 +44,7 @@ module AWS
   # specified in the API, and the values must be Hashes, Arrays, or serializable
   # values like Fixnum, Boolean, or String.
   #
-  # A more detailed example can be found in test/aws/request_test.rb where you'll
+  # A more detailed example can be found in test/simple_aws/request_test.rb where you'll
   # see how to use many levels of nesting to build your AWS request.
   ##
   class Request

data/lib/{aws → simple_aws}/core/response.rb

@@ -1,6 +1,6 @@
-require 'aws/core/util'
+require 'simple_aws/core/util'
 
-module AWS
+module SimpleAWS
 
   class UnsuccessfulResponse < RuntimeError
     attr_reader :code
@@ -133,8 +133,8 @@ module AWS
       def key_matching(name)
         return nil if @local_root.is_a? Array
 
-        lower_base_aws_name = AWS::Util.camelcase name.to_s, :lower
-        upper_base_aws_name = AWS::Util.camelcase name.to_s
+        lower_base_aws_name = SimpleAWS::Util.camelcase name.to_s, :lower
+        upper_base_aws_name = SimpleAWS::Util.camelcase name.to_s
 
         keys = @local_root.keys
 

data/lib/{aws → simple_aws}/core/util.rb

@@ -1,6 +1,6 @@
 require 'nokogiri'
 
-module AWS
+module SimpleAWS
   ##
   # Collection of helper methods used in the library
   ##

data/lib/{aws → simple_aws}/ec2.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Elastic Computing Cloud
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class EC2 < API
     endpoint "ec2"

data/lib/{aws → simple_aws}/elasti_cache.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's ElastiCache
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class ElastiCache < API
     endpoint "elasticache"

data/lib/{aws → simple_aws}/elastic_beanstalk.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Elastic Beanstalk
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class ElasticBeanstalk < API
     endpoint "elasticbeanstalk"

data/lib/{aws → simple_aws}/elb.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Elastic Load Balancing API
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class ELB < API
     endpoint "elasticloadbalancing"

data/lib/{aws → simple_aws}/iam.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Identity and Access Management
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class IAM < API
     endpoint "iam"

data/lib/{aws → simple_aws}/import_export.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Import / Export
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS.
   # This API does not support region specifiers.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class ImportExport < API
     endpoint "importexport"

data/lib/{aws → simple_aws}/map_reduce.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Elastic MapReduce
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class MapReduce < API
     endpoint "elasticmapreduce"

data/lib/{aws → simple_aws}/mechanical_turk.rb

@@ -1,7 +1,7 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Mechanical Turk
@@ -15,8 +15,8 @@ module AWS
   # For a more fleshed out object API for interacting with MechanicalTurk, you should
   # give rturk a try here: https://github.com/mdp/rturk
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class MechanicalTurk < API
     endpoint "mechanicalturk"

data/lib/{aws → simple_aws}/rds.rb

@@ -1,8 +1,8 @@
-require 'aws/api'
-require 'aws/call_types/action_param'
-require 'aws/signing/version2'
+require 'simple_aws/api'
+require 'simple_aws/call_types/action_param'
+require 'simple_aws/signing/version2'
 
-module AWS
+module SimpleAWS
 
   ##
   # Amazon's Relational Database Service
@@ -12,8 +12,8 @@ module AWS
   # All requests are POST and always through HTTPS. Use the third parameter to
   # #initialize if you need to talk to a region other than us-east-1.
   #
-  # @see AWS::CallTypes::ActionParam Calling rules
-  # @see AWS::Response Response handling
+  # @see SimpleAWS::CallTypes::ActionParam Calling rules
+  # @see SimpleAWS::Response Response handling
   ##
   class RDS < API
     endpoint "rds"