rackspace_cloudservers_api 0.0.2

data/lib/right_rackspace.rb

@@ -0,0 +1,46 @@
+#
+# Copyright (c) 2009 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'benchmark'
+require 'net/https'
+require 'uri'
+require "base64"
+require 'rubygems'
+require 'json'
+require 'right_http_connection'
+
+$:.unshift(File.dirname(__FILE__))
+require 'benchmark_fix'
+require 'support'
+require 'rackspace_base'
+require 'rackspace'
+
+module RightRackspace #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/support.rb

@@ -0,0 +1,124 @@
+# If ActiveSupport is loaded, then great - use it.  But we don't 
+# want a dependency on it, so if it's not present, define the few
+# extensions that we want to use...
+unless defined? ActiveSupport::CoreExtensions
+  # These are ActiveSupport-;like extensions to do a few handy things in the gems
+  # Derived from ActiveSupport, so the AS copyright notice applies:
+  #
+  #
+  #
+  # Copyright (c) 2005 David Heinemeier Hansson
+  #
+  # Permission is hereby granted, free of charge, to any person obtaining
+  # a copy of this software and associated documentation files (the
+  # "Software"), to deal in the Software without restriction, including
+  # without limitation the rights to use, copy, modify, merge, publish,
+  # distribute, sublicense, and/or sell copies of the Software, and to
+  # permit persons to whom the Software is furnished to do so, subject to
+  # the following conditions:
+  #
+  # The above copyright notice and this permission notice shall be
+  # included in all copies or substantial portions of the Software.
+  #
+  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+  # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+  # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+  # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+  # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+  #++
+  #
+  #
+  class String #:nodoc:
+
+    # Constantize tries to find a declared constant with the name specified
+    # in the string. It raises a NameError when the name is not in CamelCase
+    # or is not initialized.
+    #
+    # Examples
+    #   "Module".constantize #=> Module
+    #   "Class".constantize #=> Class
+    def constantize()
+      unless /\A(?:::)?([A-Z]\w*(?:::[A-Z]\w*)*)\z/ =~ self
+        raise NameError, "#{self.inspect} is not a valid constant name!"
+      end
+
+      Object.module_eval("::#{$1}", __FILE__, __LINE__)
+    end
+
+    def camelize()
+      self.dup.split(/_/).map{ |word| word.capitalize }.join('')
+    end
+
+  end
+
+
+  class Object #:nodoc:
+    # "", "   ", nil, [], and {} are blank
+    def blank?
+      if respond_to?(:empty?) && respond_to?(:strip)
+        empty? or strip.empty?
+      elsif respond_to?(:empty?)
+        empty?
+      else
+        !self
+      end
+    end
+  end
+
+  class NilClass #:nodoc:
+    def blank?
+      true
+    end
+  end
+
+  class FalseClass #:nodoc:
+    def blank?
+      true
+    end
+  end
+
+  class TrueClass #:nodoc:
+    def blank?
+      false
+    end
+  end
+
+  class Array #:nodoc:
+    alias_method :blank?, :empty?
+  end
+
+  class Hash #:nodoc:
+    alias_method :blank?, :empty?
+    
+    # Return a new hash with all keys converted to symbols.
+    def symbolize_keys
+      inject({}) do |options, (key, value)|
+        options[key.to_sym] = value
+        options
+      end
+    end
+  end
+
+  class String #:nodoc:
+    def blank?
+      empty? || strip.empty?
+    end
+  end
+
+  class Numeric #:nodoc:
+    def blank?
+      false
+    end
+  end
+end
+
+# We also use String#first from 1.8.7 that doesn't exist in 1.8.6
+unless String.instance_methods.include? "first"
+  class String
+    def first
+      self
+    end
+  end
+end

data/test/_test_credentials.rb

@@ -0,0 +1,41 @@
+class TestCredentials
+
+  @@username = nil
+  @@auth_key = nil
+
+  def self.username
+    @@username
+  end
+  def self.username=(newval)
+    @@username = newval
+  end
+  def self.auth_key
+    @@auth_key
+  end
+  def self.auth_key=(newval)
+    @@auth_key = newval
+  end
+
+# Make sure you have environment vars set:
+#
+# export RACKSPACE_USERNAME ='your_rackspace_username'
+# export RACKSPACE_AUTH_KEY ='your_rackspace_auth_key'
+#
+# or you have a file: ~/.rightscale/test_rackspace_credentials.rb with text:
+#
+#  TestCredentials.username = 'your_rackspace_username'
+#  TestCredentials.auth_key = 'your_rackspace_auth_key'
+#
+  def self.get_credentials
+    Dir.chdir do
+      begin
+        Dir.chdir('./.rightscale') do
+          require 'test_rackspace_credentials'
+        end
+      rescue Exception => e
+        puts "Couldn't chdir to ~/.rightscale: #{e.message}"
+      end
+    end
+  end
+
+end

data/test/test_right_rackspace.rb

@@ -0,0 +1,301 @@
+# Unit test for Rackspace gem
+# Specify your gogrid account credentials as described in test_credentials.rb
+
+require File.dirname(__FILE__) + '/_test_credentials'
+require File.dirname(__FILE__) + '/../lib/right_rackspace'
+
+class TestRightRackspace < Test::Unit::TestCase
+
+  TEST_SERVER_NAME = 'right-rackspace-gem-test-server-0123456789'
+  TEST_IMAGE_ID  = 8
+  TEST_FLAVOR_ID = 2
+  TEST_METADATA  = {'key1' => 'value1', 'key2' => 'value2'}
+  TEST_PERSONALITIES = { '/home/1.txt' => 'WooHoo', '/home/2.rb' => 'puts "Hello World!"'}
+
+  def setup
+    $stdout.sync = true
+    ::TestCredentials.get_credentials
+    # TODO: remove :auth_endpoint and :service_endpoint when the service is released publicly
+    @rackspace = Rightscale::Rackspace::Interface.new(TestCredentials.username, TestCredentials.auth_key,
+     :logger => Logger.new('/dev/null'))
+  end
+
+  # -------------
+  # Helpers
+  # -------------
+
+  def get_test_server_id(detail=false)
+    @rackspace.list_servers(:detail => detail)['servers'].each do |server|
+      return server['id'] if server['name'] == TEST_SERVER_NAME
+    end
+    nil
+  end
+
+  def wail_until(reason, &block)
+    initial_time = Time.now
+    puts
+    print reason
+    loop do
+      break if block.call
+      print '*'
+      sleep 10
+    end
+    puts
+    puts "(waited: #{Time.now - initial_time} seconds)"
+    puts
+  end
+
+  def resources_test(name)
+#    puts ">>> Resource test: #{name}"
+    resource_type = ''
+    name.split('_').each_with_index do |w, i|
+      resource_type += (i==0 ? w.downcase : w.capitalize)
+    end
+    # get resources
+    resources = @rackspace.send("list_#{name}")[resource_type]
+    # assert the list is an Array
+    assert resources.is_a?(Array)
+    # assert the custom resource is not an empty Hash
+    resource = resources.first
+    if resource
+      assert  resource.is_a?(Hash)
+      assert !resource.blank?
+    end
+
+    # get the detailed list of resources
+    detailed_resources = @rackspace.send("list_#{name}", :detail => true)[resource_type]
+    assert detailed_resources.is_a?(Array)
+    # assert the custom detailed resource is not an empty Hash
+    detailed_resource = detailed_resources.first
+    if detailed_resource
+      assert  detailed_resource.is_a?(Hash)
+      assert !detailed_resource.blank?
+    end
+
+    # make sure the detailed resource contains more data then non detailed
+    if resource && detailed_resource
+      assert  detailed_resource.size > resource.size
+    end
+
+    # Make a custom resource tests
+    if resource
+      # singularise name (drop a tailing 's')
+      name.chop!
+      resource_type.chop!
+      single_resource = @rackspace.send("get_#{name}", resource['id'])[resource_type]
+      assert single_resource.is_a?(Hash)
+      assert single_resource['id']
+    end
+  end
+
+  def right_rackspace_level_caching_test(cache_key, *api_call_data)
+#    puts ">>> Rackspace gem level caching test: #{cache_key}"
+    # Assert there are no any exceptions while the caching is off
+    @rackspace.send(*api_call_data)
+    @rackspace.send(*api_call_data)
+    # Enable the caching
+    @rackspace.params[:caching] = true
+    # fill the internal cache with the response
+    first_response = @rackspace.send(*api_call_data)
+    # make another call and check the cache hit
+    assert_raise(Rightscale::Rackspace::NoChange) do
+      @rackspace.send(*api_call_data)
+    end
+    # get the data from the cache and make sure it is equal to the initial call
+    assert_equal first_response, @rackspace.cache[cache_key][:data]
+    # disable the caching
+    @rackspace.params[:caching] = false
+  end
+
+  def rackspace_service_level_caching_test(*api_call_data)
+#    puts ">>> Rackspace service caching test: #{cache_key}"
+    assert_raise(Rightscale::Rackspace::NoChange) do
+      opts = api_call_data.last.is_a?(Hash) ? api_call_data.pop : {}
+      opts[:vars] = { 'changes-since' => Time.now.utc }
+      api_call_data << opts
+      @rackspace.send(*api_call_data)
+    end
+  end
+
+  # -------------
+  # Tests
+  # -------------
+
+  def test_001_login
+    # should fail with a wrong username
+    username = @rackspace.username
+    @rackspace.username = 'ohohohoho'
+    assert_raise Rightscale::Rackspace::Error do
+      @rackspace.login
+    end
+    # should login successfully with the valid username
+    @rackspace.username = username
+    assert_nothing_raised  do
+      @rackspace.login
+    end
+  end
+
+  def test_003_limits
+#    right_rackspace_level_caching_test('/limits', :list_limits)
+    limits = nil
+    assert_nothing_raised do
+      limits = @rackspace.list_limits
+    end
+    assert limits.is_a?(Hash)
+    assert limits['limits'].is_a?(Hash)
+    assert limits['limits']['rate'].is_a?(Array)
+  end
+
+  def test_005_api_version
+    right_rackspace_level_caching_test('/', :list_api_versions)
+  end
+
+  def test_010_images
+    resources_test('images')
+    right_rackspace_level_caching_test('/images', :list_images)
+    right_rackspace_level_caching_test('/images/detail', :list_images, :detail => true)
+  end
+
+  def test_020_flavors
+    resources_test('flavors')
+    right_rackspace_level_caching_test('/flavors', :list_flavors)
+    right_rackspace_level_caching_test('/flavors/detail', :list_flavors, :detail => true)
+    rackspace_service_level_caching_test(:list_flavors)
+  end
+
+  def test_030_list_shared_ip_groups
+    resources_test('shared_ip_groups')
+    right_rackspace_level_caching_test('/shared_ip_groups', :list_shared_ip_groups)
+    right_rackspace_level_caching_test('/shared_ip_groups/detail', :list_shared_ip_groups, :detail => true)
+    rackspace_service_level_caching_test(:list_shared_ip_groups)
+  end
+
+  def test_040_servers
+    resources_test('servers')
+    right_rackspace_level_caching_test('/servers', :list_servers)
+    right_rackspace_level_caching_test('/servers/detail', :list_servers, :detail => true)
+    rackspace_service_level_caching_test(:list_servers)
+  end
+
+  def test_041_make_sure_the_test_server_is_off
+    id = get_test_server_id
+    if id
+      assert @rackspace.delete_server(id)
+      puts
+      puts "> The old test server is just deleted"
+      wail_until("> Wait until the old test server disappears from list_servers responses: ") do
+        id1 = get_test_server_id
+        id2 = get_test_server_id(true)
+        !id1 && !id2
+      end
+    end
+  end
+
+  def test_042_create_server
+    puts
+    puts "> Launch a new test server "
+    server = @rackspace.create_server(
+      :name          => TEST_SERVER_NAME,
+      :image_id      => TEST_IMAGE_ID,
+      :flavor_id     => TEST_FLAVOR_ID,
+      :metadata      => TEST_METADATA,
+      :personalities => TEST_PERSONALITIES
+    )
+    assert server.is_a?(Hash)
+    assert_equal TEST_SERVER_NAME, server['server']['name']
+    assert_equal TEST_METADATA,    server['server']['metadata']
+    assert_equal TEST_IMAGE_ID,    server['server']['imageId']
+    assert_equal TEST_FLAVOR_ID,   server['server']['flavorId']
+  end
+
+  # KD: 2009-08-26: That guys are having problems with caching
+  # Makesure the server appears in both list servers calls
+  def test_044_wait_for_the_server_active_state
+    wail_until("> Wait until the new test server appears in list_servers responses:") do
+      id1 = get_test_server_id
+      id2 = get_test_server_id(true)
+      id1 && id2
+    end
+  end
+
+  def test_045_wait_for_the_server_active_state
+    id = get_test_server_id
+    # wait a while the server is being built
+    wail_until('> Wait while the new test server is being built') do
+      @rackspace.get_server(id)['server']['status'] == 'ACTIVE'
+    end
+  end
+
+  def test_050_update_server_password
+    id = get_test_server_id
+    assert @rackspace.update_server(id, :password => '1234567890')
+    # wait as bit while the password is being changed
+    wail_until('> Wait while the password is being updated') do
+      @rackspace.get_server(id)['server']['status'] == 'ACTIVE'
+    end
+  end
+
+  def test_052_backup_schedule
+    id = get_test_server_id
+    # get a schedule
+    schedule = nil
+    assert_nothing_raised do
+      schedule = @rackspace.get_backup_schedule(id)
+    end
+    assert  schedule['backupSchedule'].is_a?(Hash)
+    assert !schedule['backupSchedule']['enabled']
+    # Set a new schedule
+    assert_nothing_raised do
+      assert @rackspace.update_backup_schedule(id, {:enabled => true, :daily => "H_0400_0600", :weekly => 'MONDAY'})
+    end
+    # delete the schedule
+    assert @rackspace.update_backup_schedule(id)
+  end
+
+  def test_054_list_addresses_test
+    id = get_test_server_id
+    # all addresses
+    addresses = nil
+    assert_nothing_raised do
+      addresses = @rackspace.list_addresses(id)
+    end
+    assert  addresses['addresses'].is_a?(Hash)
+    assert  addresses['addresses']['public'].is_a?(Array)
+    assert  addresses['addresses']['private'].is_a?(Array)
+    # public addresses
+    public_addresses = nil
+    assert_nothing_raised do
+      public_addresses = @rackspace.list_addresses(id, :public)
+    end
+    assert  public_addresses.is_a?(Hash)
+    assert  public_addresses['public'].is_a?(Array)
+    assert !public_addresses['public'].blank?
+    # private addresses
+    private_addresses = nil
+    assert_nothing_raised do
+      private_addresses = @rackspace.list_addresses(id, :private)
+    end
+    assert  private_addresses.is_a?(Hash)
+    assert  private_addresses['private'].is_a?(Array)
+    assert !private_addresses['private'].blank?
+  end
+
+  def test_060_delete_server
+    puts
+    puts "> Delete the test server "
+    assert_nothing_raised do
+      @rackspace.delete_server(get_test_server_id)
+    end
+  end
+
+  # KD: 2009-08-26:
+  # Makesure the server disappeared from both list servers calls
+  def test_061_wait_for_the_server_active_state
+    wail_until("> Wait until the test server disappears from list_servers responses:") do
+      id1 = get_test_server_id
+      id2 = get_test_server_id(true)
+      !id1 && !id2
+    end
+  end
+
+end