grempe-amazon-ec2 0.2.14 → 0.2.15

data/CHANGELOG

@@ -1,3 +1,6 @@
+=== 0.2.15 2008-08-20
+ * Updated gem install instructions, and dependency specifications in the gemspec.
+
 === 0.2.14 2008-06-30
  * Merged patch from 'orionz' which adds support for EC2 Availability Zones.  Thanks!
 

data/README.rdoc

@@ -32,20 +32,29 @@ The following gems should be installed automatically as part of your install of
 
 === Install the amazon-ec2 gem
 
+  # ONE TIME ONLY
+  # It is highly recommended that you are running RubyGems version >= 1.2.0
+  # See : http://blog.segment7.net/articles/2008/06/21/rubygems-1-2-0
+  sudo gem update --system
+
   # ONE TIME ONLY
   # Execute this on each machine where you install gems to add GitHub as a gem source
   # Do this only once or you'll end up with multiple entries in 'gem sources'
   gem sources -a http://gems.github.com/
 
-  # ONE TIME ONLY
-  # Only if you had a previous version of the gem installed from RubyForge before we moved to GitHub
-  # Say 'Y' to remove all previous versions and all binaries when prompted.  It won't hurt to do
-  # this in any case.
-  sudo gem uninstall amazon-ec2
+  # Install the stable release gem from RubyForge
+  sudo gem install amazon-ec2
 
-  # Finally install the gem
+  # OR
+
+  # Install the gem from the GitHub bleeding edge as a normal runtime install
   sudo gem install grempe-amazon-ec2
 
+  # OR
+
+  # Install the gem from the GitHub bleeding edge with all developer dependencies
+  sudo gem install grempe-amazon-ec2 --development
+
 == Using amazon-ec2
 
 The library exposes one main interface class EC2::Base.  It is through an instance of this class that you will perform all the operations for using the EC2 service including query string header signing.
@@ -147,15 +156,15 @@ If you're not in front of a terminal shell now (perhaps you’re browsing this s
 Try out the following bit of code. This should walk through each image returned by a call to #describe_images and print out its key data. Note in the example below that you cannot walk through the results of the #describe_images call with the '.each' iterator (You’ll get errors if you try). You need to instead walk through the Array of items which are in the 'imagesSet' embedded in the response. This reflects exactly the XML hierarchy of data returned from EC2 which we parse to Ruby OpenStruct objects (EC2::Response).
 
   #!/usr/bin/env ruby
-  
+
   require 'rubygems'
   require 'ec2'
-  
+
   ACCESS_KEY_ID = '--YOUR AWS ACCESS KEY ID--'
   SECRET_ACCESS_KEY = '--YOUR AWS SECRET ACCESS KEY--'
-  
+
   ec2 = EC2::Base.new(:access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY)
-  
+
   puts "----- listing images owned by 'amazon' -----"
   ec2.describe_images(:owner_id => "amazon").imagesSet.item.each do |image|
     # OpenStruct objects have members!
@@ -235,7 +244,7 @@ One of the key benefits of this new version of the library is that all responses
 
   $ ec2sh
   >> puts @ec2.describe_images(:owner_id => 'amazon').xml
-  
+
   <?xml version="1.0"?>
   <DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-19/">
       <imagesSet>

data/lib/EC2/availability_zones.rb

@@ -0,0 +1,42 @@
+#--
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:grempe@rubyforge.org)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://amazon-ec2.rubyforge.org
+#++
+
+module EC2
+
+  class Base
+
+    #Amazon Developer Guide Docs:
+    #
+    # The DescribeAvailabilityZones operation describes availability zones that are currently 
+    # available to the account and their states. 
+    #
+    # An optional list of zone names can be passed.
+    #
+    #Required Arguments:
+    #
+    # none
+    #
+    #Optional Arguments:
+    #
+    # :zone_name => Array (default : [])
+    #
+
+    def describe_availability_zones( options = {} )
+
+      options = { :zone_name => [] }.merge(options)
+
+      params = pathlist("ZoneName", options[:zone_name] )
+
+      return response_generator(:action => "DescribeAvailabilityZones", :params => params)
+
+    end
+  end
+end
+

data/test/test_EC2_availability_zones.rb

@@ -0,0 +1,49 @@
+#--
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:grempe@rubyforge.org)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://amazon-ec2.rubyforge.org
+#++
+
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+context "EC2 availability zones" do
+
+  setup do
+    @ec2 = EC2::Base.new( :access_key_id => "not a key", :secret_access_key => "not a secret" )
+
+    @describe_availability_zones_response_body = <<-RESPONSE
+    <DescribeAvailabilityZonesResponse xmlns="http://ec2.amazonaws.com/doc/2008-02-01/">
+      <availabilityZoneInfo>
+        <item>
+          <zoneName>us-east-1a</zoneName>
+          <zoneState>available</zoneState>
+        </item>
+        <item>
+          <zoneName>us-east-1b</zoneName>
+          <zoneState>available</zoneState>
+        </item>
+      </availabilityZoneInfo>
+    </DescribeAvailabilityZonesResponse>
+	 RESPONSE
+
+ end
+
+  specify "should be able to be described with describe_availability_zones" do
+    @ec2.stubs(:make_request).with('DescribeAvailabilityZones', { "ZoneName.1" => "us-east-1a", "ZoneName.2" => "us-east-1b" }).
+      returns stub(:body => @describe_availability_zones_response_body, :is_a? => true)
+    @ec2.describe_availability_zones( :zone_name => ["us-east-1a", "us-east-1b"] ).should.be.an.instance_of EC2::Response
+
+    response = @ec2.describe_availability_zones( :zone_name => ["us-east-1a", "us-east-1b"] )
+
+    response.availabilityZoneInfo.item[0].zoneName.should.equal "us-east-1a"
+    response.availabilityZoneInfo.item[0].zoneState.should.equal "available"
+
+    response.availabilityZoneInfo.item[1].zoneName.should.equal "us-east-1b"
+    response.availabilityZoneInfo.item[1].zoneState.should.equal "available"
+  end
+
+end

data/test/test_helper.rb

@@ -8,7 +8,7 @@
 # Home::      http://amazon-ec2.rubyforge.org
 #++
 
-%w[ test/unit rubygems test/spec mocha stubba ].each { |f|
+%w[ test/unit rubygems test/spec mocha ].each { |f|
   begin
     require f
   rescue LoadError

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: grempe-amazon-ec2
 version: !ruby/object:Gem::Version 
-  version: 0.2.14
+  version: 0.2.15
 platform: ruby
 authors: 
 - Glenn Rempe
@@ -9,7 +9,7 @@ autorequire: EC2
 bindir: bin
 cert_chain: []
 
-date: 2008-06-25 00:00:00 -07:00
+date: 2008-08-13 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -19,7 +19,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
+        version: 1.0.11
     version: 
 - !ruby/object:Gem::Dependency 
   name: mocha
@@ -28,7 +28,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
+        version: 0.9.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: test-spec
@@ -37,7 +37,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
+        version: 0.9.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: rcov
@@ -46,7 +46,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
+        version: 0.8.1.2.0
     version: 
 description: An interface library that allows Ruby applications to easily connect to the HTTP 'Query API' for the Amazon Web Services Elastic Compute Cloud (EC2) and manipulate cloud servers.
 email: glenn.rempe@gmail.com
@@ -66,6 +66,7 @@ files:
 - CHANGELOG
 - Rakefile
 - lib/EC2
+- lib/EC2/availability_zones.rb
 - lib/EC2/console.rb
 - lib/EC2/elastic_ips.rb
 - lib/EC2/exceptions.rb
@@ -78,6 +79,7 @@ files:
 - lib/EC2/security_groups.rb
 - lib/EC2.rb
 - test/test_EC2.rb
+- test/test_EC2_availability_zones.rb
 - test/test_EC2_console.rb
 - test/test_EC2_elastic_ips.rb
 - test/test_EC2_image_attributes.rb