bbrowning-deltacloud-client 0.0.9.7-java

data/specs/initialization_spec.rb

@@ -0,0 +1,60 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+require 'specs/spec_helper'
+
+describe "initializing the client" do
+
+  it "should parse valid API URIs" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.api_host.should eql( API_HOST )
+    client.api_port.should eql( API_PORT.to_i )
+    client.api_path.should eql( API_PATH )
+  end
+
+  it "should discover entry points upon connection" do
+    DeltaCloud.new( "name", "password", API_URL ) do |client|
+      client.entry_points[:hardware_profiles].should eql( "#{API_URL}/hardware_profiles" )
+      client.entry_points[:images].should            eql( "#{API_URL}/images" )
+      client.entry_points[:instances].should         eql( "#{API_URL}/instances" )
+      client.entry_points[:storage_volumes].should   eql( "#{API_URL}/storage_volumes" )
+      client.entry_points[:storage_snapshots].should eql( "#{API_URL}/storage_snapshots" )
+    end
+  end
+
+  it "should provide the current driver name via client" do
+    DeltaCloud.new( "name", "password", API_URL ) do |client|
+      client.driver_name.should eql( 'mock' )
+    end
+  end
+
+  it "should provide the current driver name without client" do
+    DeltaCloud.driver_name( API_URL ).should eql( 'mock' )
+  end
+
+  describe "without a block" do
+    before( :each ) do
+      reload_fixtures
+    end
+    it "should connect without a block" do
+      client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+      client.images.should_not be_nil
+    end
+  end
+
+end

data/specs/instance_states_spec.rb

@@ -0,0 +1,78 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+
+require 'specs/spec_helper'
+
+=begin
+Spec::Matchers.define :include_transition do |action,to|
+  match do |transitions|
+    found = transitions.find{|e| e.action.to_s == action.to_s && e.to.to_s == to.to_s }
+    ! found.nil?
+  end
+end
+=end
+
+describe "instance-states" do
+
+  it_should_behave_like "all resources"
+
+  it "should allow retrieval of instance-state information" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance_states = client.instance_states
+      instance_states.should_not be_nil
+      instance_states.should_not be_empty
+
+      instance_states[0].name.should eql( 'start' )
+      instance_states[0].transitions.size.should eql( 1 )
+      instance_states[0].transitions[0].should_not be_auto
+
+      instance_states[1].name.should eql( 'pending' )
+      instance_states[1].transitions.size.should eql( 1 )
+      instance_states[1].transitions[0].should be_auto
+
+      instance_states[2].name.should eql( 'running' )
+      instance_states[2].transitions.size.should eql( 2 )
+      includes_transition( instance_states[2].transitions, :reboot, :running ).should be_true
+      includes_transition( instance_states[2].transitions, :stop, :stopped ).should be_true
+    end
+  end
+
+  it "should allow retrieval of a single instance-state blob" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance_state = client.instance_state( :pending )
+      instance_state.should_not be_nil
+      instance_state.name.should eql( 'pending' )
+      instance_state.transitions.size.should eql( 1 )
+      instance_state.transitions[0].should be_auto
+
+      instance_state = client.instance_state( :running )
+      instance_state.name.should eql( 'running' )
+      instance_state.transitions.size.should eql( 2 )
+      includes_transition( instance_state.transitions, :reboot, :running ).should be_true
+      includes_transition( instance_state.transitions, :stop, :stopped ).should be_true
+    end
+  end
+
+  def includes_transition( transitions, action, to )
+    found = transitions.find{|e| e.action.to_s == action.to_s && e.to.to_s == to.to_s }
+    ! found.nil?
+  end
+
+
+end

data/specs/instances_spec.rb

@@ -0,0 +1,191 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+
+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( DeltaCloud::API::Image )
+        instance.hardware_profile.should_not be_nil
+        instance.hardware_profile.should be_a( DeltaCloud::API::HardwareProfile )
+        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( "inst0" )
+      instance.should_not be_nil
+      instance.name.should_not be_nil
+      instance.name.should eql( 'Mock Instance With Profile Change' )
+      instance.uri.should_not be_nil
+      instance.uri.should be_a( String )
+      instance.owner_id.should eql( "mockuser" )
+      instance.public_addresses.first.should eql( "img1.inst0.public.com" )
+      instance.image.should_not be_nil
+      instance.image.uri.should eql( API_URL + "/images/img1" )
+      instance.hardware_profile.should_not be_nil
+      instance.hardware_profile.should_not be_nil
+      instance.hardware_profile.uri.should eql( API_URL + "/hardware_profiles/m1-large" )
+      instance.hardware_profile.memory.value.should eql(10240.0)
+      instance.hardware_profile.storage.value.should eql(850.0)
+      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 match( %r{#{API_URL}/instances/inst[0-9]+} )
+      instance.id.should match( /inst[0-9]+/ )
+      instance.name.should eql( 'TestInstance' )
+      instance.image.id.should eql( 'img1' )
+      instance.hardware_profile.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 match( %r{#{API_URL}/instances/inst[0-9]+} )
+      instance.id.should match( /inst[0-9]+/ )
+      instance.image.id.should eql( 'img1' )
+      instance.hardware_profile.id.should eql( 'm1-large' )
+      instance.realm.id.should eql( 'eu' )
+    end
+  end
+
+  it "should allow creation of new instances with specific hardware profile" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1',
+                                         :hardware_profile=>'m1-xlarge' )
+      instance.should_not be_nil
+      instance.uri.should match( %r{#{API_URL}/instances/inst[0-9]+} )
+      instance.id.should match( /inst[0-9]+/ )
+      instance.image.id.should eql( 'img1' )
+      instance.hardware_profile.id.should eql( 'm1-xlarge' )
+      instance.realm.id.should eql( 'us' )
+    end
+  end
+
+  it "should allow creation of new instances with specific hardware profile overriding memory" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      hwp = { :id => 'm1-xlarge', :memory => 32768 }
+      instance = client.create_instance( 'img1', :hardware_profile=> hwp )
+      instance.should_not be_nil
+      instance.uri.should match( %r{#{API_URL}/instances/inst[0-9]+} )
+      instance.id.should match( /inst[0-9]+/ )
+      instance.image.id.should eql( 'img1' )
+      instance.hardware_profile.id.should eql( 'm1-xlarge' )
+      instance.hardware_profile.memory.value.should eql(12288.0)
+      instance.realm.id.should eql( 'us' )
+    end
+  end
+
+  it "should allow creation of new instances with specific realm and hardware profile" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instance = client.create_instance( 'img1', :realm=>'eu',
+                                         :hardware_profile=>'m1-xlarge' )
+      instance.should_not be_nil
+      instance.uri.should match( %r{#{API_URL}/instances/inst[0-9]+} )
+      instance.id.should match( /inst[0-9]+/ )
+      instance.image.id.should eql( 'img1' )
+      instance.hardware_profile.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,64 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+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 = client.realm( 'eu' )
+      realm.should_not be_nil
+      realm.id.should eql( 'eu' )
+      realm.name.should eql( 'Europe' )
+      realm.state.should eql( 'AVAILABLE' )
+    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,30 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+
+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,52 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+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 = 3001 ) if api_port.nil?
+( api_port = 3001 ) if api_port == ''
+
+API_HOST = api_host
+API_PORT = api_port
+API_PATH = '/api'
+
+API_URL = "http://#{API_HOST}:#{API_PORT}#{API_PATH}"
+API_NAME     = 'mockuser'
+API_PASSWORD = 'mockpassword'
+
+$: << 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'