simple_aws 0.0.1a

data/lib/aws/ec2.rb

@@ -0,0 +1,22 @@
+require 'aws/api'
+require 'aws/call_types/action_param'
+
+module AWS
+
+  ##
+  # Amazon's Elastic Computing Cloud
+  #
+  # http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html
+  #
+  # 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.
+  ##
+  class EC2 < API
+    endpoint "ec2"
+    use_https true
+    version "2011-11-01"
+
+    include CallTypes::ActionParam
+  end
+
+end

data/lib/aws/elb.rb

@@ -0,0 +1,21 @@
+require 'aws/api'
+require 'aws/call_types/action_param'
+
+module AWS
+
+  ##
+  # Amazon's Elastic Load Balancing API
+  #
+  # http://docs.amazonwebservices.com/ElasticLoadBalancing/latest/APIReference/
+  #
+  # 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.
+  ##
+  class ELB < API
+    endpoint "elasticloadbalancing"
+    use_https true
+    version "2011-11-15"
+
+    include CallTypes::ActionParam
+  end
+end

data/lib/aws/iam.rb

@@ -0,0 +1,22 @@
+require 'aws/api'
+require 'aws/call_types/action_param'
+
+module AWS
+
+  ##
+  # Amazon's Identity and Access Management
+  #
+  # http://docs.amazonwebservices.com/IAM/latest/APIReference/
+  #
+  # 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.
+  ##
+  class IAM < API
+    endpoint "iam"
+    use_https true
+    version "2010-05-08"
+
+    include CallTypes::ActionParam
+  end
+
+end

data/samples/ec2.rb

@@ -0,0 +1,41 @@
+$: << File.expand_path("../../lib", __FILE__)
+
+require 'aws/ec2'
+
+##
+# Expects your Amazon keys to be in the environment, something like
+#
+# export AWS_KEY="KEY"
+# export AWS_SECRET="SECRET"
+##
+
+ec2 = AWS::EC2.new ENV["AWS_KEY"], ENV["AWS_SECRET"]
+
+puts "", "Standard Only Addresses", ""
+
+ec2.describe_addresses("Filter" => {"Name" => "domain", "Value" => "standard"}).addresses_set.each do |address|
+  puts "IP: #{address.public_ip}"
+  puts "Instance ID: #{address.instance_id}"
+  puts "Domain: #{address.domain}"
+  puts ""
+end
+
+puts "", "VPC Only addresses", ""
+
+ec2.describe_addresses("Filter" => {"Name" => "domain", "Value" => "vpc"}).addresses_set.each do |address|
+  puts "IP: #{address.public_ip}"
+  puts "Instance ID: #{address.instance_id}"
+  puts "Domain: #{address.domain}"
+  puts "Allocation ID: #{address.allocation_id}"
+  puts "Association ID: #{address.association_id}"
+  puts ""
+end
+
+puts "", "Ask for both explicitly", ""
+
+ec2.describe_addresses("Filter" => {"Name" => "domain", "Value" => ["standard", "vpc"]}).addresses_set.each do |address|
+  puts "IP: #{address.public_ip}"
+  puts "Instance ID: #{address.instance_id}"
+  puts "Domain: #{address.domain}"
+  puts ""
+end

data/samples/elb.rb

@@ -0,0 +1,26 @@
+$: << File.expand_path("../../lib", __FILE__)
+
+require 'aws/elb'
+
+##
+# Expects your Amazon keys to be in the environment, something like
+#
+# export AWS_KEY="KEY"
+# export AWS_SECRET="SECRET"
+##
+
+$elb = AWS::ELB.new ENV["AWS_KEY"], ENV["AWS_SECRET"]
+
+puts "", "Your Load Balancers", ""
+
+$elb.describe_load_balancers.load_balancer_descriptions.each do |elb|
+  puts "Name: #{elb.load_balancer_name}"
+  puts "HealthCheck: #{elb.health_check.inspect}"
+
+  elb.listener_descriptions.each do |desc|
+    l = desc.listener
+    puts "Listener: #{l.protocol}:#{l.load_balancer_port} => #{l.instance_protocol}:#{l.instance_port}"
+  end
+
+  puts ""
+end

data/samples/iam.rb

@@ -0,0 +1,30 @@
+$: << File.expand_path("../../lib", __FILE__)
+
+require 'aws/iam'
+
+##
+# Expects your Amazon keys to be in the environment, something like
+#
+# export AWS_KEY="KEY"
+# export AWS_SECRET="SECRET"
+##
+
+$iam = AWS::IAM.new ENV["AWS_KEY"], ENV["AWS_SECRET"]
+
+puts "", "You are", ""
+
+user = $iam.get_user.user
+puts "Id: #{user.user_id}"
+puts "Name: #{user.user_name}"
+puts "Arn: #{user.arn}"
+puts "Create Date: #{Time.parse user.create_date}"
+
+puts "", "Your SSL Certificates", ""
+
+$iam.list_server_certificates.server_certificate_metadata_list.each do |cert|
+  puts "Id: #{cert.server_certificate_id}"
+  puts "Path: #{cert.path}"
+  puts "Arn: #{cert.arn}"
+  puts "UploadDate: #{cert.upload_date}"
+  puts ""
+end

data/simple_aws.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name     = "simple_aws"
+  s.version  = "0.0.1a"
+  s.platform = Gem::Platform::RUBY
+  s.authors  = ["Jason Roelofs"]
+  s.email    = ["jameskilton@gmail.com"]
+
+#  s.homepage = ""
+
+  s.summary     = "The simplest and easiest to use and maintain AWS communication library"
+  s.description = "The simplest and easiest to use and maintain AWS communication library"
+
+  s.add_dependency "ox"
+  s.add_dependency "httparty"
+
+  s.add_dependency "jruby-openssl" if RUBY_PLATFORM == 'java'
+
+  s.files         = `git ls-files`.split "\n"
+  s.test_files    = `git ls-files -- test/*`.split "\n"
+  s.require_paths = ['lib']
+end

data/test/aws/api_test.rb

@@ -0,0 +1,101 @@
+require 'test_helper'
+require 'aws/api'
+
+describe AWS::API do
+
+  class TestAPI < AWS::API
+  end
+
+  describe ".endpoint" do
+    it "allows definition of an endpoint for an API implementation" do
+      TestAPI.endpoint "test-endpoint"
+    end
+  end
+
+  describe ".default_region" do
+    it "allows specification of a default endpoint" do
+      TestAPI.default_region "us-west-1"
+    end
+  end
+
+  describe ".use_https" do
+    it "can be told to use HTTPS over HTTP" do
+      TestAPI.use_https true
+    end
+  end
+
+  describe ".version" do
+    it "allows specifying version of the API" do
+      TestAPI.version "2011-01-04"
+    end
+  end
+
+  describe "#initialize" do
+    it "takes AWS key and secret on construction" do
+      obj = TestAPI.new "access_key", "secret_key"
+      obj.access_key.must_equal "access_key"
+      obj.secret_key.must_equal "secret_key"
+    end
+
+    it "can also take a region" do
+      obj = TestAPI.new "access_key", "secret_key", "region"
+      obj.region.must_equal "region"
+    end
+
+    it "makes version available" do
+      TestAPI.version "2011-02-02"
+      obj = TestAPI.new "access_key", "secret_key"
+      obj.version.must_equal "2011-02-02"
+    end
+  end
+
+  describe "#region" do
+    it "uses default region if none given on constructor" do
+      TestAPI.default_region "us-west-1"
+      obj = TestAPI.new "access_key", "secret_key"
+
+      obj.region.must_equal "us-west-1"
+    end
+  end
+
+  describe "#uri" do
+    before do
+      TestAPI.endpoint nil
+      TestAPI.default_region nil
+      TestAPI.use_https nil
+    end
+
+    it "returns the full URI to the API endpoint in question" do
+      TestAPI.endpoint "testing-endpoint"
+      TestAPI.default_region nil
+
+      obj = TestAPI.new "key", "secret"
+      obj.uri.must_equal "http://testing-endpoint.amazonaws.com"
+    end
+
+    it "adds the region to the URI if specified in default_region" do
+      TestAPI.endpoint "testing-endpoint"
+      TestAPI.default_region "us-east-1"
+
+      obj = TestAPI.new "key", "secret"
+      obj.uri.must_equal "http://testing-endpoint.us-east-1.amazonaws.com"
+    end
+
+    it "adds the region to the URI if specified in constructor" do
+      TestAPI.endpoint "testing-endpoint"
+      TestAPI.default_region "us-east-1"
+
+      obj = TestAPI.new "key", "secret", "eu-west-1"
+      obj.uri.must_equal "http://testing-endpoint.eu-west-1.amazonaws.com"
+    end
+
+    it "uses http/https according to use_https" do
+      TestAPI.endpoint "testing-endpoint"
+      TestAPI.default_region nil
+      TestAPI.use_https true
+
+      obj = TestAPI.new "key", "secret"
+      obj.uri.must_equal "https://testing-endpoint.amazonaws.com"
+    end
+  end
+end

data/test/aws/call_types/action_param_test.rb

@@ -0,0 +1,52 @@
+require 'test_helper'
+require 'aws/api'
+require 'aws/call_types/action_param'
+
+describe AWS::CallTypes::ActionParam do
+
+  class ActionParamTesting < AWS::API
+    endpoint "aptest"
+    version "2011-01-01"
+    use_https true
+
+    include AWS::CallTypes::ActionParam
+  end
+
+  it "builds and signs AWS requests on methods it doesn't know about" do
+    AWS::Connection.any_instance.expects(:call).with do |request|
+      request.method.must_equal :post
+      request.uri.must_equal "https://aptest.amazonaws.com/"
+
+      params = request.params
+      params.wont_be_nil
+
+      params["Action"].must_equal "DescribeInstances"
+      params["Version"].must_equal "2011-01-01"
+      params["AWSAccessKeyId"].must_equal "key"
+      params["SignatureMethod"].must_equal "HmacSHA256"
+      params["SignatureVersion"].must_equal "2"
+
+      params["Signature"].wont_be_nil
+
+      Time.parse(params["Timestamp"]).wont_be_nil
+      true
+    end.returns
+
+    obj = ActionParamTesting.new "key", "secret"
+    obj.describe_instances
+  end
+
+  it "takes a hash parameter and gives it to the request" do
+    AWS::Connection.any_instance.expects(:call).with do |request|
+
+      params = request.params
+      params["ParamA"].must_equal 1
+      params["ParamB"].must_equal "Death to Smoochy"
+
+      true
+    end.returns
+
+    obj = ActionParamTesting.new "key", "secret"
+    obj.describe_instances "ParamA" => 1, "ParamB" => "Death to Smoochy"
+  end
+end

data/test/aws/core/connection_test.rb

@@ -0,0 +1,48 @@
+require 'test_helper'
+require 'aws/core/request'
+require 'aws/core/response'
+require 'aws/core/connection'
+
+describe AWS::Connection do
+
+  describe "#call" do
+
+    before do
+      @connection = AWS::Connection.new
+      @http_response = stub_everything(:success? => true, :parsed_response => {"value" => {}})
+    end
+
+    it "takes a basic request and runs it" do
+      request = AWS::Request.new(:get, "host.com", "/")
+
+      AWS::HTTP.expects(:get).with {|uri, options|
+        uri.must_equal "host.com/"
+      }.returns(@http_response)
+
+      @connection.call request
+    end
+
+    it "returns the response wrapped in our Response object" do
+      request = AWS::Request.new(:get, "host.com", "/")
+
+      AWS::HTTP.expects(:get).returns(@http_response)
+
+      response = @connection.call request
+      response.must_be_kind_of AWS::Response
+      response.body.must_equal "value" => {}
+    end
+
+    it "pulls parameters into the request" do
+      request = AWS::Request.new(:get, "host.com", "/")
+      request.params["Param1"] = "Something"
+
+      AWS::HTTP.expects(:get).with {|uri, options|
+        options[:query].wont_be_nil
+        options[:query]["Param1"].must_equal "Something"
+      }.returns(@http_response)
+
+      @connection.call request
+    end
+
+  end
+end

data/test/aws/core/request_test.rb

@@ -0,0 +1,86 @@
+require 'test_helper'
+require 'aws/core/request'
+
+describe AWS::Request do
+
+  before do
+    @request = AWS::Request.new :get, "https://example.com", "/action"
+  end
+
+  it "is constructed with a method, host and path" do
+    @request.wont_be_nil
+  end
+
+  it "builds full URI" do
+    @request.uri.must_equal "https://example.com/action"
+  end
+
+  it "knows it's HTTP method" do
+    @request.method.must_equal :get
+  end
+
+  it "can be given parameters to pass in" do
+    @request.params["Param1"] = "Value1"
+    @request.params["Param2"] = "Value2"
+
+    @request.params.must_equal "Param1" => "Value1", "Param2" => "Value2"
+  end
+
+  describe "hashes" do
+    it "converts hash params to AWS param names" do
+      @request.params["Filter"] = [
+        {"Name" => "filter1", "Value" => "value1"},
+        {"Name" => "filter2", "Value" => ["value14", "another filter"]}
+      ]
+
+      @request.params.must_equal({
+        "Filter.1.Name" => "filter1",
+        "Filter.1.Value" => "value1",
+        "Filter.2.Name" => "filter2",
+        "Filter.2.Value.1" => "value14",
+        "Filter.2.Value.2" => "another filter"
+      })
+    end
+
+    it "handles any depth of nesting" do
+      # Example of using EC2 AuthorizeSecurityGroupEgress
+      @request.params["IpPermissions"] = [
+        {"IpProtocol" => "udp", "FromPort" => 211, "ToPort" => 142,
+          "Groups" => [{"GroupId" => 28}, {"GroupId" => 14}],
+          "IpRanges" => [{"CidrIp" => 998}, {"CidrIp" => 12}]
+        }
+      ]
+
+      @request.params.must_equal({
+        "IpPermissions.1.IpProtocol" => "udp",
+        "IpPermissions.1.FromPort" => 211,
+        "IpPermissions.1.ToPort" => 142,
+        "IpPermissions.1.Groups.1.GroupId" => 28,
+        "IpPermissions.1.Groups.2.GroupId" => 14,
+        "IpPermissions.1.IpRanges.1.CidrIp" => 998,
+        "IpPermissions.1.IpRanges.2.CidrIp" => 12
+      })
+    end
+
+    it "wraps a singular hash into a single element array" do
+      @request.params["Filter"] = {"Name" => "filter1", "Value" => "value1"}
+
+      @request.params.must_equal({
+        "Filter.1.Name" => "filter1",
+        "Filter.1.Value" => "value1"
+      })
+    end
+  end
+
+  describe "arrays" do
+    it "converts array params to AWS param names" do
+      @request.params["Filter"] = ["value1", "value2", "value3"]
+
+      @request.params.must_equal({
+        "Filter.1" => "value1",
+        "Filter.2" => "value2",
+        "Filter.3" => "value3"
+      })
+    end
+  end
+end