amazon-ec2 0.9.15 → 0.9.17

data/.gitignore

@@ -6,3 +6,6 @@ doc
 .yardoc
 pkg
 .idea
+.bundle
+.rvmrc
+perftools

data/ChangeLog

@@ -1,3 +1,28 @@
+* (In progress) Close issue #22, allow detach_volume to take a boolean as a string or TrueClass FalseClass
+
+=== 0.9.17 2010-11-21
+ * Converted from Jeweler to Bundler, 'bundle install' to install dependencies
+ * Adding ability to launch t1.micro instances for ec2 regular and spot price instances
+ * Adding support for describe/modify/reset instance attributes with tests.
+ * Updated to API version : 2010-08-31
+ * Added experimental support for EC2 create_tags, describe_tags, delete_tags
+ * Added experimental Eucalyptus support, provide by Sang-Min Park from Eucalyptus.
+ * Instead of having hard coded "/" as URL path, the path can be given to as an option. Setup.rb is changed such that server, port, path, and use_ssl can be correctly set up.
+ * RDS :db_security_groups should be an Array, not a String.
+ * Use HmacSHA256 signatures instead of SHA1 (preferred by AWS and improves support for Eucalyptus)
+ * added AWS::EC2::Base#get_password_data for GetPasswordData API (Windows instances)
+ * Fix #26.  Raise an exception immediately if the response is a 5xx Server Error.
+ * Applied experimental CloudWatch Monitoring Patch by fred-secludit, removes limitations on which server to connect to, and better handles statistics and dimensions.
+ * Changed AWS::EC2::Instance from a module to a class to help along an experiment by bdigital
+ * Zarro open boogs.  Zarro Open pull requests. W00t
+
+=== 0.9.16 2010-07-07
+ * Less strict checking on which server endpoints you can pass in as an environment var.
+ * Moved ec2sh script to awshell to better reflect the more comprehensive nature of the gem.
+ * Better instructions on using awshell upon running
+ * awshell now sets up handles for all of the various services we use, not just @ec2 (+ @as, @rds, @elb, @cw)
+ * awshell prints out the various server endpoints that it will actually use in the shell (you can override with env vars).
+
 === 0.9.11 2010-04-23
  * RDS#create_db_instance : renamed misspelled :backend_retention_period option to :backup_retention_period.
  * Better handling of FixNum options in a few methods.

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in amazon-ec2.gemspec
+gemspec
+
+

data/Gemfile.lock

@@ -0,0 +1,29 @@
+PATH
+  remote: .
+  specs:
+    amazon-ec2 (0.9.17)
+      xml-simple (>= 1.0.12)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    mocha (0.9.9)
+      rake
+    perftools.rb (0.5.4)
+    rake (0.8.7)
+    rcov (0.9.9)
+    test-spec (0.10.0)
+    xml-simple (1.0.12)
+    yard (0.6.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  amazon-ec2!
+  mocha (>= 0.9.9)
+  perftools.rb (>= 0.5.4)
+  rcov (>= 0.9.9)
+  test-spec (>= 0.10.0)
+  xml-simple (>= 1.0.12)
+  yard (>= 0.6.2)

data/README.rdoc

@@ -22,59 +22,32 @@ or the official EC2 website at http://aws.amazon.com/ec2
 
 == Installation
 
-This gem follows the standard conventions for installation on any system with Ruby and RubyGems installed.  If you have worked with gems before this will look very familiar.
+This gem follows the standard conventions for installation on any system with Ruby and RubyGems installed and uses Bundler for gem installation and build management.  If you have worked with gems before this will look very familiar.
 
 === Get an AWS account
 
 Before you can make use of this gem you will need an Amazon Web Services developer account which you can sign up for at https://aws-portal.amazon.com/gp/aws/developer/registration/index.html.  This account must also be specifically enabled for Amazon EC2 usage.  AWS will provide you with an 'AWS Access Key ID' and a 'Secret Access Key' which will allow you to authenticate any API calls you make and ensure correct billing to you for usage of the service.  Take note of these (and keep them secret!).
 
-=== Install required gem pre-requisites
-
-The following gems should be installed automatically as part of your install of amazon-ec2. Most of them are needed for testing build dependencies but they should be painless to install even if you don't plan on running the tests or building this gem manually on your own.
-
-  XmlSimple (required)
-  Mocha (optional for testing)
-  Rcov (optional for testing)
-  Test-Spec (optional for testing)
-
-
 === Install the amazon-ec2 gem (Canonical Release)
 
-This is the standard install for stable releases from Gemcutter.
-
-  # Install the stable release gem from Gemcutter (one time only) ( learn more here : http://gemcutter.org/pages/faq )
-  sudo gem install gemcutter
-
-  # Set Gemcutter to be your canonical gems source (one time only)
-  sudo gem tumble
+This is the standard install for stable releases from RubyGems.
 
   # Install the gem
-  sudo gem install amazon-ec2
-
-  # OR if you want to skip the Gemcutter setup
-  sudo gem install amazon-ec2 -s http://gemcutter.org
+  [sudo] gem install amazon-ec2
 
 
 === Install from local Git clone (for amazon-ec2 developers)
 
-GitHub has unfortunately given up on the feature they had where they would build gems
-when pushed to git.  Too bad.  So to install from git, you'll need to clone and build.
+To install from git for adding features or fixing bugs, you'll need to clone and build.
 
   git clone git://github.com/grempe/amazon-ec2.git
   cd amazon-ec2
-  rake gemspec
+  bundle install
+  rake test
   rake build
   rake install
 
 
-=== EXPERIMENTAL : Install the amazon-ec2 gem using Rip (for more bleeding edge versions)
-
-For those who intend to do development on the gem, or want the bleeding edge.  Install Rip as described at hellorip.com.
-
-  # (Experimental) Install using Rip (hellorip.com) instead of RubyGems
-  rip install git://github.com/grempe/amazon-ec2.git
-
-
 == Using amazon-ec2
 
 The library exposes one main interface class AWS::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.
@@ -84,7 +57,7 @@ The public methods on AWS::EC2::Base closely mirror the EC2 Query API, and as su
 
 === Setting up
 
-The 'ec2sh' and 'ec2-gem-example.rb' scripts which will be introduced to you shortly expect your AWS EC2 credentials to be stored as shell environment variables which are accessible to those scripts. This makes them convenient to use whenever you need to do a quick query to see what images you have available to you, what's running now, or to start or stop an instance on EC2. You'll find 'ec2sh' to be a very handy tool. I'll describe only the OS X route for setting up (of course the setup steps will vary depending on your particular system and preferred shell). If you don't want to do it this way, feel free to copy these scripts from the gem dir to any location where you can run them from and modify them directly to include your credentials.
+The 'awshell' and 'ec2-gem-example.rb' scripts which will be introduced to you shortly expect your AWS EC2 credentials to be stored as shell environment variables which are accessible to those scripts. This makes them convenient to use whenever you need to do a quick query to see what images you have available to you, what's running now, or to start or stop an instance on EC2. You'll find 'awshell' to be a very handy tool. I'll describe only the OS X route for setting up (of course the setup steps will vary depending on your particular system and preferred shell). If you don't want to do it this way, feel free to copy these scripts from the gem dir to any location where you can run them from and modify them directly to include your credentials.
 
 Edit the file ~/.bash_login and add the following to the existing contents:
 
@@ -130,16 +103,16 @@ An example Ruby script which exercises the library a bit more is installed for y
 
 Since we also package this sample file in the gem's bin/ dir you should also be able to run it from anywhere on your shell path (once you have set your environment variables as described above).
 
-==== Using the 'ec2sh' command shell
+==== Using the 'awshell' command shell
 
-The 'ec2sh' command shell is actually a standard 'irb' Ruby shell, with the main difference being we read your AWS credentials from your environment and pre-configure a connection string for you. This lets you run any EC2 command very simply. This has proven to be a valuable tool during the development of this gem and you should try it out. Since we install this tool in your system path as part of the installation of this gem, you should be able to simply run 'ec2sh' from any terminal command prompt on your local system. You'll see some basic instructions for use, and a few examples when you start 'ec2sh'. Go ahead and try it out now. We'll wait...
+The 'awshell' command shell is actually a standard 'irb' Ruby shell, with the main difference being we read your AWS credentials from your environment and pre-configure a connection string for you. This lets you run any EC2 command very simply. This has proven to be a valuable tool during the development of this gem and you should try it out. Since we install this tool in your system path as part of the installation of this gem, you should be able to simply run 'awshell' from any terminal command prompt on your local system. You'll see some basic instructions for use, and a few examples when you start 'awshell'. Go ahead and try it out now. We'll wait...
 
 If you're not in front of a terminal shell now (perhaps you're browsing this site on your iPhone) this is what you would see:
 
 
-  hostname:/tmp/rails/amazon_test glenn$ ec2sh
+  hostname:/tmp/rails/amazon_test glenn$ awshell
 
-    'ec2sh' usage :
+    'awshell' usage :
     This is an interactive 'irb' command shell that allows you to use all
     commands available to the amazon-ec2 gem.  You'll find this to be a
     great tool to help you debug issues and practice running commands
@@ -191,7 +164,8 @@ Try out the following bit of code. This should walk through each image returned
 
 === Ruby on Rails usage example:
 
-<b>config/environment.rb</b>
+
+<b>Rails 2.3.x - config/environment.rb</b>
 
   Rails::Initializer.run do |config|
    ...
@@ -200,6 +174,12 @@ Try out the following bit of code. This should walk through each image returned
   end
 
 
+<b>Rails 3.x.x - Gemfile</b>
+
+  ...
+  gem "amazon-ec2", :require => "AWS"
+
+
 <b>app/controllers/my_controller.rb</b>
 
   [some controller code ...]
@@ -259,7 +239,7 @@ Try out the following bit of code. This should walk through each image returned
 
 === Important notes regarding the structure of AWS::Response Objects
 
-One of the key benefits of this new version of the library is that all responses from EC2 are bundled up in a real data structure and no longer require parsing of text. The hash returned is populated directly from the XML given to us by EC2 in response to any command we issue. This means that future changes to the API and what is returned by EC2 will be handled transparently by the gem. This is a huge benefit. What this means though, is that you may have to do a little homework on what actually gets returned by EC2 as XML. For example, when you make a #describe_images call in 'ec2sh' what AWS returns behind the scenes looks like:
+One of the key benefits of this new version of the library is that all responses from EC2 are bundled up in a real data structure and no longer require parsing of text. The hash returned is populated directly from the XML given to us by EC2 in response to any command we issue. This means that future changes to the API and what is returned by EC2 will be handled transparently by the gem. This is a huge benefit. What this means though, is that you may have to do a little homework on what actually gets returned by EC2 as XML. For example, when you make a #describe_images call in 'awshell' what AWS returns behind the scenes looks like:
 
   <?xml version="1.0"?>
   <DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-19/">
@@ -316,7 +296,7 @@ So, for example, if you wanted to get the image ID of the third image listed in
   >> puts @ec2.describe_images(:owner_id => 'amazon').imagesSet.item[2].imageId
   ami-23b6534a
 
-EC2 will typically return sets of things (imagesSet, reservationSet, etc.) which we map to ruby Arrays (.imagesSet.item in the example above). If you want to iterate over a response set you will need to iterate over this array. The Arrays will typically contain additional AWS::Response objects that represent each individual item. You'll find that you can use the 'ec2sh' to help you understand the structure more completely if you try issuing commands there as a way to practice seeing what will be returned and making sure you get exactly what you want.
+EC2 will typically return sets of things (imagesSet, reservationSet, etc.) which we map to ruby Arrays (.imagesSet.item in the example above). If you want to iterate over a response set you will need to iterate over this array. The Arrays will typically contain additional AWS::Response objects that represent each individual item. You'll find that you can use the 'awshell' to help you understand the structure more completely if you try issuing commands there as a way to practice seeing what will be returned and making sure you get exactly what you want.
 
 === Handling Exceptions
 If for some reason an error occurs when executing a method (e.g. its arguments were
@@ -355,11 +335,11 @@ Please follow these steps if you want to send a patch or a GitHub pull request:
 * Fork grempe/amazon-ec2
 * Create a topic branch: `git checkout -b my_fix`
 * Make sure you add tests for your changes and that they all pass with 'rake test'
-* Don't change files that you don't own like the gemspec or VERSION
+* Don't change files that you don't own like the gemspec or version.rb
 * Commit your changes, one change/fix per commit
 * Push your fixes branch: `git push origin my_fix`
-* Open an Issue referencing your branch.
-* Please do not push to `master` on your fork. This will make everyone’s life easier.
+* Open an Issue on GitHub referencing your branch and send a pull request.
+* Please do not push to `master` on your fork. Using a feature/bugfix branch will make everyone’s life easier.
 
 
 Enjoy!

data/Rakefile

@@ -1,26 +1,5 @@
-require 'rubygems'
-require 'rake'
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "amazon-ec2"
-    gem.summary = %Q{Amazon EC2 Ruby Gem}
-    gem.description = %Q{A Ruby library for accessing the Amazon Web Services EC2, ELB, RDS, Cloudwatch, and Autoscaling APIs.}
-    gem.email = "glenn@rempe.us"
-    gem.homepage = "http://github.com/grempe/amazon-ec2"
-    gem.authors = ["Glenn Rempe"]
-    gem.rdoc_options = ["--title", "amazon-ec2 documentation", "--line-numbers", "--main", "README.rdoc"]
-    gem.rubyforge_project = 'amazon-ec2'
-    gem.add_dependency('xml-simple', '>= 1.0.12')
-    gem.add_development_dependency('mocha', '>= 0.9.8')
-    gem.add_development_dependency('test-spec', '>= 0.10.0')
-    gem.add_development_dependency('rcov', '>= 0.9.6')
-    gem.add_development_dependency('perftools.rb', '>= 0.3.9')
-  end
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: [sudo] gem install jeweler"
-end
+require 'bundler'
+Bundler::GemHelper.install_tasks
 
 require 'rake/testtask'
 Rake::TestTask.new(:test) do |test|
@@ -71,7 +50,7 @@ end
 
 desc "Generate a perftools.rb profile"
 task :profile do
-  system("CPUPROFILE=perftools/ec2prof RUBYOPT='-r/Library/Ruby/Gems/1.8/gems/perftools.rb-0.3.2/lib/perftools.bundle' ruby -r'rubygems' bin/ec2-gem-profile.rb")
+  system("CPUPROFILE=perftools/ec2prof RUBYOPT='-r/Users/glenn/.rvm/gems/ruby-1.8.7-p302@amazon-ec2/gems/perftools.rb-0.5.4/lib/perftools.bundle' ruby -r'rubygems' bin/ec2-gem-profile.rb")
   system("pprof.rb --text --ignore=Gem perftools/ec2prof > perftools/ec2prof-results.txt")
   system("pprof.rb --dot --ignore=Gem perftools/ec2prof > perftools/ec2prof-results.dot")
 end

data/amazon-ec2.gemspec

@@ -1,151 +1,36 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
 # -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "AWS/version"
 
 Gem::Specification.new do |s|
-  s.name = %q{amazon-ec2}
-  s.version = "0.9.15"
+  s.name        = "amazon-ec2"
+  s.version     = AWS::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Glenn Rempe"]
+  s.email       = ["glenn@rempe.us"]
+  s.homepage    = "http://github.com/grempe/amazon-ec2"
+  s.summary     = "Amazon EC2 Ruby gem"
+  s.description = "A Ruby library for accessing the Amazon Web Services EC2, ELB, RDS, Cloudwatch, and Autoscaling APIs."
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Glenn Rempe"]
-  s.date = %q{2010-06-10}
-  s.description = %q{A Ruby library for accessing the Amazon Web Services EC2, ELB, RDS, Cloudwatch, and Autoscaling APIs.}
-  s.email = %q{glenn@rempe.us}
-  s.executables = ["ec2-gem-example.rb", "ec2-gem-profile.rb", "ec2sh", "setup.rb"]
+  s.rubyforge_project = "amazon-ec2"
+
+  s.rdoc_options = ["--title", "amazon-ec2 documentation", "--line-numbers", "--main", "README.rdoc"]
   s.extra_rdoc_files = [
     "ChangeLog",
-     "LICENSE",
-     "README.rdoc",
-     "README_dev.rdoc"
-  ]
-  s.files = [
-    ".gitignore",
-     ".yardopts",
-     "ChangeLog",
-     "LICENSE",
-     "README.rdoc",
-     "README_dev.rdoc",
-     "Rakefile",
-     "VERSION",
-     "amazon-ec2.gemspec",
-     "bin/ec2-gem-example.rb",
-     "bin/ec2-gem-profile.rb",
-     "bin/ec2sh",
-     "bin/setup.rb",
-     "deps.rip",
-     "lib/AWS.rb",
-     "lib/AWS/Autoscaling.rb",
-     "lib/AWS/Autoscaling/autoscaling.rb",
-     "lib/AWS/Cloudwatch.rb",
-     "lib/AWS/Cloudwatch/monitoring.rb",
-     "lib/AWS/EC2.rb",
-     "lib/AWS/EC2/availability_zones.rb",
-     "lib/AWS/EC2/console.rb",
-     "lib/AWS/EC2/devpay.rb",
-     "lib/AWS/EC2/elastic_ips.rb",
-     "lib/AWS/EC2/image_attributes.rb",
-     "lib/AWS/EC2/images.rb",
-     "lib/AWS/EC2/instances.rb",
-     "lib/AWS/EC2/keypairs.rb",
-     "lib/AWS/EC2/products.rb",
-     "lib/AWS/EC2/security_groups.rb",
-     "lib/AWS/EC2/snapshots.rb",
-     "lib/AWS/EC2/spot_instance_requests.rb",
-     "lib/AWS/EC2/spot_prices.rb",
-     "lib/AWS/EC2/subnets.rb",
-     "lib/AWS/EC2/volumes.rb",
-     "lib/AWS/ELB.rb",
-     "lib/AWS/ELB/load_balancers.rb",
-     "lib/AWS/RDS.rb",
-     "lib/AWS/RDS/rds.rb",
-     "lib/AWS/exceptions.rb",
-     "lib/AWS/responses.rb",
-     "perftools/ec2prof",
-     "perftools/ec2prof-results.dot",
-     "perftools/ec2prof-results.txt",
-     "perftools/ec2prof.symbols",
-     "test/test_Autoscaling_groups.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",
-     "test/test_EC2_images.rb",
-     "test/test_EC2_instances.rb",
-     "test/test_EC2_keypairs.rb",
-     "test/test_EC2_products.rb",
-     "test/test_EC2_responses.rb",
-     "test/test_EC2_s3_xmlsimple.rb",
-     "test/test_EC2_security_groups.rb",
-     "test/test_EC2_snapshots.rb",
-     "test/test_EC2_spot_instance_requests.rb",
-     "test/test_EC2_spot_prices.rb",
-     "test/test_EC2_subnets.rb",
-     "test/test_EC2_volumes.rb",
-     "test/test_ELB_load_balancers.rb",
-     "test/test_RDS.rb",
-     "test/test_helper.rb",
-     "wsdl/2007-08-29.ec2.wsdl",
-     "wsdl/2008-02-01.ec2.wsdl",
-     "wsdl/2008-05-05.ec2.wsdl",
-     "wsdl/2008-12-01.ec2.wsdl",
-     "wsdl/2009-10-31.ec2.wsdl",
-     "wsdl/2009-11-30.ec2.wsdl"
-  ]
-  s.homepage = %q{http://github.com/grempe/amazon-ec2}
-  s.rdoc_options = ["--title", "amazon-ec2 documentation", "--line-numbers", "--main", "README.rdoc"]
-  s.require_paths = ["lib"]
-  s.rubyforge_project = %q{amazon-ec2}
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Amazon EC2 Ruby Gem}
-  s.test_files = [
-    "test/test_Autoscaling_groups.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",
-     "test/test_EC2_images.rb",
-     "test/test_EC2_instances.rb",
-     "test/test_EC2_keypairs.rb",
-     "test/test_EC2_products.rb",
-     "test/test_EC2_responses.rb",
-     "test/test_EC2_s3_xmlsimple.rb",
-     "test/test_EC2_security_groups.rb",
-     "test/test_EC2_snapshots.rb",
-     "test/test_EC2_spot_instance_requests.rb",
-     "test/test_EC2_spot_prices.rb",
-     "test/test_EC2_subnets.rb",
-     "test/test_EC2_volumes.rb",
-     "test/test_ELB_load_balancers.rb",
-     "test/test_helper.rb",
-     "test/test_RDS.rb"
+    "LICENSE",
+    "README.rdoc"
   ]
 
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+  s.add_dependency('xml-simple', '>= 1.0.12')
+  s.add_development_dependency('mocha', '>= 0.9.9')
+  s.add_development_dependency('test-spec', '>= 0.10.0')
+  s.add_development_dependency('rcov', '>= 0.9.9')
+  s.add_development_dependency('perftools.rb', '>= 0.5.4')
+  s.add_development_dependency('yard', '>= 0.6.2')
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<xml-simple>, [">= 1.0.12"])
-      s.add_development_dependency(%q<mocha>, [">= 0.9.8"])
-      s.add_development_dependency(%q<test-spec>, [">= 0.10.0"])
-      s.add_development_dependency(%q<rcov>, [">= 0.9.6"])
-      s.add_development_dependency(%q<perftools.rb>, [">= 0.3.9"])
-    else
-      s.add_dependency(%q<xml-simple>, [">= 1.0.12"])
-      s.add_dependency(%q<mocha>, [">= 0.9.8"])
-      s.add_dependency(%q<test-spec>, [">= 0.10.0"])
-      s.add_dependency(%q<rcov>, [">= 0.9.6"])
-      s.add_dependency(%q<perftools.rb>, [">= 0.3.9"])
-    end
-  else
-    s.add_dependency(%q<xml-simple>, [">= 1.0.12"])
-    s.add_dependency(%q<mocha>, [">= 0.9.8"])
-    s.add_dependency(%q<test-spec>, [">= 0.10.0"])
-    s.add_dependency(%q<rcov>, [">= 0.9.6"])
-    s.add_dependency(%q<perftools.rb>, [">= 0.3.9"])
-  end
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
 end
 

data/bin/awshell

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby
+
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2010 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+# CREDITS : Credit for this bit of shameful ripoff coolness
+# goes to Marcel Molina and his AWS::S3 gem.  Thanks!
+
+aws_lib   = File.dirname(__FILE__) + '/../lib/AWS'
+setup = File.dirname(__FILE__) + '/setup'
+irb_name = RUBY_PLATFORM =~ /mswin32/ ? 'irb.bat' : 'irb'
+
+welcome_message = <<-MESSAGE
+
+Usage :
+
+This is an interactive Ruby 'irb' shell that allows you to use the
+AWS commands available in the 'amazon-ec2' gem.  This can be a
+great tool to help you debug issues and run commands
+against the live AWS servers.  You can do anything in this
+shell that you can in a normal irb shell.
+
+Config :
+
+You must set the following environment variables that contain your
+AWS credentials in your system shell for this to work.
+
+  AMAZON_ACCESS_KEY_ID
+  AMAZON_SECRET_ACCESS_KEY
+
+Each AWS service has its own default server endpoints. You can override
+the endpoints with the following environment variables set in your
+system shell:
+
+  EC2 :                     EC2_URL
+  Elastic Load Balancing :  ELB_URL
+  AutoScaling :             AS_URL
+  RDS :                     RDS_URL
+  CloudWatch :              AWS_CLOUDWATCH_URL
+
+For your convenience, the various AWS services are wired up in this shell
+to the following class variables.  You can execute methods on each of these:
+
+  @ec2   (Elastic Compute Cloud)
+  @elb   (Elastic Load Balancing)
+  @as    (AutoScaling)
+  @rds   (Relational Database Service)
+  @cw    (CloudWatch)
+
+You can make method calls on these instances to execute commands against
+the various services. Pre-pending a 'pp' should give you a pretty printed
+version of the response which may be easier to read.
+
+Examples:
+
+  returns : Pretty Print all ec2 public methods
+  >> pp @ec2.methods.sort
+
+  returns : Pretty Print a Hash describing your EC2 images
+  >> @ec2.describe_images(:owner_id => ['self'])
+
+  returns : an Array of AWS::Response objects, each an EC2 image and its data
+  >> @ec2.describe_images(:owner_id => ['self']).imagesSet.item
+  >> @ec2.describe_images(:owner_id => ['self']).imagesSet.item[0]
+
+MESSAGE
+
+if ( ENV['AMAZON_ACCESS_KEY_ID'] && ENV['AMAZON_SECRET_ACCESS_KEY'] )
+  puts welcome_message
+  exec "#{irb_name} -rubygems -r #{aws_lib} -r #{setup} --simple-prompt"
+else
+  puts "You must define AMAZON_ACCESS_KEY_ID and AMAZON_SECRET_ACCESS_KEY as shell environment variables before running #{$0}!"
+  puts welcome_message
+end
+