deltacloud-client 0.0.2

data/specs/instances_spec.rb

@@ -0,0 +1,171 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+require 'specs/spec_helper'
+
+describe "instances" do
+
+  it_should_behave_like "all resources"
+
+  it "should allow retrieval of all instances" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instances = client.instances
+      instances.should_not be_empty
+      instances.each do |instance|
+        instance.uri.should_not be_nil
+        instance.uri.should be_a( String )
+        instance.owner_id.should_not be_nil
+        instance.owner_id.should be_a( String )
+        instance.image.should_not be_nil
+        instance.image.should be_a( DCloud::Image )
+        instance.flavor.should_not be_nil
+        instance.flavor.should be_a( DCloud::Flavor )
+        instance.state.should_not be_nil
+        instance.state.should be_a( String )
+        instance.public_addresses.should_not be_nil
+        instance.public_addresses.should_not be_empty
+        instance.public_addresses.should be_a( Array )
+        instance.private_addresses.should_not be_nil
+        instance.private_addresses.should_not be_empty
+        instance.private_addresses.should be_a( Array )
+      end
+    end
+  end
+
+  it "should allow navigation from instance to image" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instances = client.instances
+      instances.should_not be_empty
+      instance = instances.first
+      instance.image.should_not be_nil
+      instance.image.description.should_not be_nil
+      instance.image.description.should be_a(String)
+    end
+  end
+
+  it "should allow retrieval of a single instance" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.instance( "inst1" )
+      instance.should_not be_nil
+      instance.name.should_not be_nil
+      instance.name.should eql( 'MockUserInstance' )
+      instance.uri.should_not be_nil
+      instance.uri.should be_a( String )
+      instance.owner_id.should eql( "mockuser" )
+      instance.public_addresses.first.should eql( "img3.inst1.public.com" )
+      instance.image.should_not be_nil
+      instance.image.uri.should eql( API_URL + "/images/img3" )
+      instance.flavor.should_not be_nil
+      instance.flavor.uri.should eql( API_URL + "/flavors/m1-small" )
+      instance.state.should eql( "RUNNING" )
+      instance.actions.should_not be_nil
+    end
+  end
+
+  it "should allow creation of new instances with reasonable defaults" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1', :name=>'TestInstance' )
+      instance.should_not be_nil
+      instance.uri.should eql( API_URL + '/instances/inst3' )
+      instance.id.should eql( 'inst3' )
+      instance.name.should eql( 'TestInstance' )
+      instance.image.id.should eql( 'img1' )
+      instance.flavor.id.should eql( 'm1-large' )
+      instance.realm.id.should eql( 'us' )
+    end
+  end
+
+  it "should allow creation of new instances with specific realm" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1', :realm=>'eu' )
+      instance.should_not be_nil
+      instance.uri.should eql( API_URL + '/instances/inst3' )
+      instance.id.should eql( 'inst3' )
+      instance.image.id.should eql( 'img1' )
+      instance.flavor.id.should eql( 'm1-large' )
+      instance.realm.id.should eql( 'eu' )
+    end
+  end
+
+  it "should allow creation of new instances with specific flavor" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1', :flavor=>'m1-xlarge' )
+      instance.should_not be_nil
+      instance.uri.should eql( API_URL + '/instances/inst3' )
+      instance.id.should eql( 'inst3' )
+      instance.image.id.should eql( 'img1' )
+      instance.flavor.id.should eql( 'm1-xlarge' )
+      instance.realm.id.should eql( 'us' )
+    end
+  end
+
+  it "should allow creation of new instances with specific realm and flavor" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1', :realm=>'eu', :flavor=>'m1-xlarge' )
+      instance.should_not be_nil
+      instance.uri.should eql( API_URL + '/instances/inst3' )
+      instance.id.should eql( 'inst3' )
+      instance.image.id.should eql( 'img1' )
+      instance.flavor.id.should eql( 'm1-xlarge' )
+      instance.realm.id.should eql( 'eu' )
+    end
+  end
+
+  it "should allow fetching of instances by id" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.instance( 'inst1' )
+      instance.should_not be_nil
+      instance.uri.should_not be_nil
+      instance.uri.should be_a( String )
+    end
+  end
+
+  it "should allow fetching of instances by URI" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.fetch_instance( API_URL + '/instances/inst1' )
+      instance.should_not be_nil
+      instance.uri.should eql( API_URL + '/instances/inst1' )
+      instance.id.should eql( 'inst1' )
+    end
+  end
+
+  describe "performing actions on instances" do
+    it "should allow actions that are valid" do
+      DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+        instance = client.instance( 'inst1' )
+        instance.should_not be_nil
+        instance.state.should eql( "RUNNING" )
+        instance.uri.should eql( API_URL + '/instances/inst1' )
+        instance.id.should eql( 'inst1' )
+        instance.stop!
+        instance.state.should eql( "STOPPED" )
+        instance.start!
+        instance.state.should eql( "RUNNING" )
+      end
+    end
+
+    it "should not allow actions that are invalid" do
+      DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+        instance = client.instance( 'inst1' )
+        instance.should_not be_nil
+        instance.state.should eql( "RUNNING" )
+        lambda{instance.start}.should raise_error
+      end
+    end
+  end
+end

data/specs/realms_spec.rb

@@ -0,0 +1,65 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'specs/spec_helper'
+
+describe "realms" do
+
+  it_should_behave_like "all resources"
+
+  it "should allow retrieval of all realms" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      realms = client.realms
+      realms.should_not be_empty
+      realms.each do |realm|
+        realm.uri.should_not be_nil
+        realm.uri.should be_a(String)
+        realm.id.should_not be_nil
+        realm.id.should be_a(String)
+        realm.name.should_not be_nil
+        realm.name.should be_a(String)
+      end
+    end
+  end
+
+
+  it "should allow fetching a realm by id" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      realm = client.realm( 'us' )
+      realm.should_not be_nil
+      realm.id.should eql( 'us' )
+      realm.name.should eql( 'United States' )
+      realm.state.should eql( 'AVAILABLE' )
+      realm.limit.should eql( :unlimited )
+      realm = client.realm( 'eu' )
+      realm.should_not be_nil
+      realm.id.should eql( 'eu' )
+      realm.name.should eql( 'Europe' )
+      realm.state.should eql( 'AVAILABLE' )
+      realm.limit.should eql( :unlimited )
+    end
+  end
+
+  it "should allow fetching a realm by URI" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      realm = client.fetch_realm( API_URL + '/realms/us' )
+      realm.should_not be_nil
+      realm.id.should eql( 'us' )
+    end
+  end
+
+end

data/specs/shared/resources.rb

@@ -0,0 +1,29 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+shared_examples_for "all resources" do
+
+  before(:each) do
+    reload_fixtures
+  end
+
+  after(:each) do
+    #clean_fixtures
+  end
+
+end

data/specs/spec_helper.rb

@@ -0,0 +1,54 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'rubygems'
+require 'yaml'
+require 'fileutils'
+
+api_host = ENV['API_HOST']
+( api_host = 'localhost' ) if api_host.nil?
+( api_host = 'localhost' ) if api_host == ''
+
+api_port = ENV['API_PORT']
+( api_port = 3000 ) if api_port.nil?
+( api_port = 3000 ) if api_port == ''
+
+API_HOST = api_host
+API_PORT = api_port
+API_PATH = '/api'
+
+API_URL = "http://#{API_HOST}:#{API_PORT}#{API_PATH}"
+
+credentials = YAML.load( File.read( File.dirname( __FILE__ ) + '/../credentials.yml' ) )
+
+API_NAME     = credentials['name']
+API_PASSWORD = credentials['password']
+
+$: << File.dirname( __FILE__ ) + '/../lib'
+require 'deltacloud'
+
+def clean_fixtures
+  FileUtils.rm_rf( File.dirname( __FILE__ ) + '/data' )
+end
+
+def reload_fixtures
+  clean_fixtures
+  FileUtils.cp_r( File.dirname( __FILE__) + '/fixtures', File.dirname( __FILE__ ) + '/data' )
+end
+
+$: << File.dirname( __FILE__ )
+require 'shared/resources'

data/specs/storage_snapshot_spec.rb

@@ -0,0 +1,76 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+require 'specs/spec_helper'
+
+describe "storage snapshot" do
+
+  it_should_behave_like "all resources"
+
+  it "allow retrieval of all storage volumes owned by the current user" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_snapshots = client.storage_snapshots
+      storage_snapshots.should_not be_nil
+      storage_snapshots.should_not be_empty
+      ids = storage_snapshots.collect{|e| e.id}
+      ids.size.should eql( 2 )
+      ids.should include( 'snap2' )
+      ids.should include( 'snap3' )
+    end
+  end
+
+  it "should allow fetching of storage volume by id" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_snapshot = client.storage_snapshot( 'snap2' )
+      storage_snapshot.should_not be_nil
+      storage_snapshot.id.should eql( 'snap2' )
+      storage_snapshot.storage_volume.capacity.should eql( 1.0 )
+      storage_snapshot.storage_volume.id.should eql( 'vol2' )
+    end
+  end
+
+  it "should allow fetching of storage volume by URI"  do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_snapshot = client.fetch_storage_snapshot( API_URL + '/storage_snapshots/snap2' )
+      storage_snapshot.should_not be_nil
+      storage_snapshot.id.should eql( 'snap2' )
+      storage_snapshot.storage_volume.capacity.should eql( 1.0 )
+      storage_snapshot.storage_volume.id.should eql( 'vol2' )
+    end
+  end
+
+  it "should return nil for unknown storage volume by ID" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_snapshot = client.storage_snapshot( "bogus" )
+      storage_snapshot.should be_nil
+    end
+  end
+
+  it "should return nil for unknown storage volume by URI" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_snapshot = client.fetch_storage_snapshot( API_URL + '/storage_snapshots/bogus' )
+      storage_snapshot.should be_nil
+    end
+  end
+
+end

data/specs/storage_volume_spec.rb

@@ -0,0 +1,86 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+require 'specs/spec_helper'
+
+describe "storage volumes" do
+
+  it_should_behave_like "all resources"
+
+  it "allow retrieval of all storage volumes owned by the current user" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_volumes = client.storage_volumes
+      storage_volumes.should_not be_nil
+      storage_volumes.should_not be_empty
+      ids = storage_volumes.collect{|e| e.id}
+      ids.size.should eql( 2 )
+      ids.should include( 'vol2' )
+      ids.should include( 'vol3' )
+    end
+  end
+
+  it "should allow fetching of storage volume by id" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_volume = client.storage_volume( 'vol3' )
+      storage_volume.id.should eql( 'vol3' )
+      storage_volume.uri.should eql( API_URL + '/storage_volumes/vol3' )
+      storage_volume.state.should eql( 'IN-USE' )
+      storage_volume.capacity.should eql( 1.0 )
+      storage_volume.device.should eql( '/dev/sda1' )
+      storage_volume.instance.should_not be_nil
+      storage_volume.instance.id.should eql( 'inst1' )
+      storage_volume.instance.flavor.architecture.should eql( 'i386' )
+    end
+  end
+
+  it "should allow fetching of storage volume by URI" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_volume = client.fetch_storage_volume( API_URL + '/storage_volumes/vol3' )
+      storage_volume.should_not be_nil
+      storage_volume.id.should eql( 'vol3' )
+      storage_volume.uri.should eql( API_URL + '/storage_volumes/vol3' )
+      storage_volume.state.should eql( 'IN-USE' )
+      storage_volume.capacity.should eql( 1.0 )
+      storage_volume.device.should eql( '/dev/sda1' )
+      storage_volume.instance.should_not be_nil
+      storage_volume.instance.id.should eql( 'inst1' )
+      storage_volume.instance.flavor.architecture.should eql( 'i386' )
+    end
+  end
+
+  it "should return nil for unknown storage volume by ID" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_volume = client.storage_volume( 'bogus' )
+      storage_volume.should be_nil
+    end
+  end
+
+  it "should return nil for unknown storage volume by URI" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.connect do |client|
+      storage_volume = client.fetch_storage_volume( API_URL + '/storage_volumes/bogus' )
+      storage_volume.should be_nil
+    end
+  end
+
+
+end