deltacloud-client 1.0.5 → 1.1.0

data/tests/buckets_test.rb

@@ -0,0 +1,141 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Buckets" do
+
+  it "should allow retrieval of all buckets" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      buckets = client.buckets
+      buckets.wont_be_empty
+      buckets.each do |bucket|
+        bucket.uri.wont_be_nil
+        bucket.uri.must_be_kind_of String
+        bucket.name.wont_be_nil
+        bucket.name.must_be_kind_of String
+      end
+    end
+  end
+
+  it "should allow retrieval of a named bucket" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      bucket = client.bucket("bucket1")
+      bucket.wont_be_nil
+      bucket.uri.must_equal API_URL + "/buckets/bucket1"
+      bucket.size.must_equal 3.0
+      bucket.name.wont_be_nil
+      bucket.name.must_be_kind_of String
+      blob_list = bucket.blob_list.split(", ")
+      blob_list.size.must_equal bucket.size.to_i
+    end
+  end
+
+end
+
+describe "Operations on buckets" do
+
+  it "should allow creation of a new bucket" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      new_bucket = client.create_bucket({'id' => "my_new_bucket"})
+      new_bucket.wont_be_nil
+      new_bucket.uri.must_equal API_URL + "/buckets/my_new_bucket"
+      new_bucket.name.wont_be_nil
+      new_bucket.name.must_be_kind_of String
+      new_bucket.name.must_equal "my_new_bucket"
+    end
+  end
+
+  it "should allow deletion of an existing bucket" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      new_bucket = client.bucket("my_new_bucket")
+      new_bucket.wont_be_nil
+      new_bucket.name.must_equal "my_new_bucket"
+      client.destroy_bucket('id' => "my_new_bucket").must_be_nil
+    end
+  end
+
+  it "should throw error if you delete a non existing bucket" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda {
+      client.destroy_bucket({'id' => "i_dont_exist"}).must_be_nil
+      }.must_raise DeltaCloud::HTTPError::DeltacloudError
+    end
+  end
+
+end
+
+describe "Blobs" do
+
+  it "should allow retrieval of a bucket's blobs" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      bucket = client.bucket("bucket1")
+      bucket.wont_be_nil
+      blob_list = bucket.blob_list.split(", ")
+      blob_list.size.must_equal bucket.size.to_i
+      blob_list.each do |b_id|
+        blob = client.blob("bucket" => bucket.name, :id => b_id)
+        blob.bucket.wont_be_nil
+        blob.bucket.must_be_kind_of String
+        blob.bucket.must_equal bucket.name
+        blob.content_length.wont_be_nil
+        blob.content_length.must_be_kind_of Float
+        blob.content_length.must_be :'>=', 0
+        blob_data = client.blob_data("bucket" => bucket.name, :id => b_id)
+        blob_data.size.to_f.must_equal blob.content_length
+        blob.last_modified.wont_be_nil
+      end
+    end
+  end
+
+end
+
+describe "Operations on blobs" do
+
+  it "should successfully create a new blob" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      blob_data = File.new("./blob_data_file", "w+")
+      blob_data.write("this is some blob data \n")
+      blob_data.rewind
+      some_new_blob = client.create_blob(
+        :id => "some_new_blob",
+        'bucket' => "bucket1",
+        'file_path' => blob_data.path
+      )
+      some_new_blob.wont_be_nil
+      some_new_blob.content_length.wont_be_nil
+      some_new_blob.content_length.must_equal 24.0
+      File.delete(blob_data.path)
+    end
+  end
+
+  it "should allow deletion of an existing blob" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      client.destroy_blob(:id=>"some_new_blob", 'bucket'=>"bucket1").must_be_nil
+    end
+  end
+
+  it "should throw error if you delete a non existing blob" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda {
+        client.destroy_blob(:id=>"no_such_blob", 'bucket'=>"bucket1").must_be_nil
+      }.must_raise DeltaCloud::HTTPError::DeltacloudError
+    end
+  end
+
+end

data/tests/client_test.rb

@@ -0,0 +1,59 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "initializing the client" do
+
+  it "should parse valid API URIs" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    client.api_host.must_equal API_HOST
+    client.api_port.must_equal API_PORT.to_i
+    client.api_path.must_equal API_PATH
+  end
+
+  it "should discover entry points upon connection" do
+    DeltaCloud.new( "name", "password", API_URL ) do |client|
+      client.entry_points[:hardware_profiles].must_equal "#{API_URL}/hardware_profiles"
+      client.entry_points[:images].must_equal "#{API_URL}/images"
+      client.entry_points[:instances].must_equal "#{API_URL}/instances"
+      client.entry_points[:storage_volumes].must_equal "#{API_URL}/storage_volumes"
+      client.entry_points[:storage_snapshots].must_equal "#{API_URL}/storage_snapshots"
+      client.entry_points[:buckets].must_equal "#{API_URL}/buckets"
+      client.entry_points[:keys].must_equal "#{API_URL}/keys"
+    end
+  end
+
+  it "should provide the current driver name via client" do
+    DeltaCloud.new( "name", "password", API_URL ) do |client|
+      client.driver_name.must_equal 'mock'
+    end
+  end
+
+  it "should provide the current driver name without client" do
+    DeltaCloud.driver_name( API_URL ).must_equal 'mock'
+  end
+
+  describe "without a block" do
+    it "should connect without a block" do
+      client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+      client.images.wont_be_nil
+    end
+  end
+
+end

data/tests/content_negotiation_test.rb

@@ -0,0 +1,127 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+def client; RestClient::Resource.new(API_URL); end
+
+def headers(header)
+  encoded_credentials = ["#{API_NAME}:#{API_PASSWORD}"].pack("m0").gsub(/\n/,'')
+  { :authorization => "Basic " + encoded_credentials }.merge(header)
+end
+
+describe "return JSON" do
+
+  it 'should return JSON when using application/json, */*' do
+    header_hash = {
+      # FIXME: There is a bug in rack-accept that cause to respond with HTML
+      # to the configuration below.
+      #
+      # 'Accept' => "application/json, */*"
+      'Accept' => "application/json"
+    }
+    client.get(header_hash) do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^application\/json/
+    end
+  end
+
+  it 'should return JSON when using just application/json' do
+    header_hash = {
+      'Accept' => "application/json"
+    }
+    client.get(header_hash) do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^application\/json/
+    end
+  end
+
+end
+
+describe "return HTML in different browsers" do
+
+  it "wants XML using format parameter" do
+    client.get(:params => { 'format' => 'xml' }, 'Accept' => 'application/xhtml+xml') do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^application\/xml/
+    end
+  end
+
+  it "raise 406 error on wrong accept" do
+    client['hardware_profiles'].get('Accept' => 'image/png;q=1') do |response, request, &block|
+      response.code.must_equal 406
+    end
+  end
+
+  it "wants HTML using format parameter and accept set to XML" do
+    client.get(:params => { 'format' => 'html'}, 'Accept' => 'application/xml') do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^text\/html/
+    end
+  end
+
+  it "doesn't have accept header" do
+    client.get('Accept' => '') do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^application\/xml/
+    end
+  end
+
+  it "can handle unknown formats" do
+    client.get('Accept' => 'format/unknown') do |response, request, &block|
+      response.code.must_equal 406
+    end
+  end
+
+  it "wants explicitly XML" do
+    client.get('Accept' => 'application/xml') do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^application\/xml/
+    end
+  end
+
+  it "Internet Explorer" do
+    header_hash = {
+      'Accept' => "image/gif, image/jpeg, image/pjpeg, image/pjpeg, application/x-shockwave-flash, application/x-ms-application, application/x-ms-xbap, application/vnd.ms-xpsdocument, application/xaml+xml, */*",
+      'User-agent' => "Mozilla/5.0 (Windows; U; MSIE 9.0; Windows NT 9.0; en-US)"
+    }
+    client.get(header_hash) do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^text\/html/
+    end
+  end
+
+  it "Mozilla Firefox" do
+    client.get('Accept' => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8") do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^text\/html/
+    end
+  end
+
+  it "Opera" do
+    header_hash = { 
+      'Accept' => "text/html, application/xml;q=0.9, application/xhtml+xml, image/png, image/jpeg, image/gif, image/x-xbitmap, */*;q=0.1",
+      'User-agent' => "Opera/9.80 (X11; Linux i686; U; ru) Presto/2.8.131 Version/11.11"
+    }
+    client.get(header_hash) do |response, request, &block|
+      response.code.must_equal 200
+      response.headers[:content_type].must_match /^text\/html/
+    end
+  end
+
+end

data/tests/errors_test.rb

@@ -0,0 +1,57 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "server error handler" do
+
+  it 'should capture HTTP 500 error as DeltacloudError' do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda { client.realm('500') }.must_raise DeltaCloud::HTTPError::DeltacloudError
+    end
+  end
+
+  it 'should capture HTTP 502 error as ProviderError' do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda { client.realm('502') }.must_raise DeltaCloud::HTTPError::ProviderError
+    end
+  end
+
+  it 'should capture HTTP 501 error as NotImplemented' do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda { client.realm('501') }.must_raise DeltaCloud::HTTPError::NotImplemented
+    end
+  end
+
+  it 'should capture HTTP 504 error as ProviderTimeout' do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda { client.realm('504') }.must_raise DeltaCloud::HTTPError::ProviderTimeout
+    end
+  end
+
+end
+
+describe "client error handler" do
+
+  it 'should capture HTTP 404 error as NotFound' do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      lambda { client.realm('non-existing-realm') }.must_raise DeltaCloud::HTTPError::NotFound
+    end
+  end
+
+end

data/tests/hardware_profiles_test.rb

@@ -0,0 +1,75 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+def prop_check(prop, value_class)
+  if prop.present?
+    prop.value.wont_be_nil
+    prop.value.must_be_kind_of value_class
+  end
+end
+
+describe "Hardware Profiles" do
+
+  it "should allow retrieval of all hardware profiles" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      hardware_profiles = client.hardware_profiles
+      hardware_profiles.wont_be_empty
+      hardware_profiles.each do |hwp|
+        hwp.uri.wont_be_nil
+        hwp.uri.must_be_kind_of String
+        prop_check(hwp.architecture, String) unless hwp.name.eql?("opaque")
+     end
+    end
+  end
+
+  it "should allow filtering of hardware_profiles by architecture" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      hardware_profiles = client.hardware_profiles( :architecture=>'i386' )
+      hardware_profiles.wont_be_empty
+      hardware_profiles.size.must_equal 1
+      hardware_profiles.first.architecture.value.must_equal 'i386'
+    end
+  end
+
+  it "should allow fetching a hardware_profile by id" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      hwp = client.hardware_profile( 'm1-small' )
+      hwp.wont_be_nil
+      hwp.id.must_equal 'm1-small'
+    end
+  end
+
+  it "should allow fetching different hardware_profiles" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    hwp1 = client.hardware_profile( 'm1-small' )
+    hwp2 = client.hardware_profile( 'm1-large' )
+    hwp1.storage.value.wont_equal hwp2.storage.value
+    hwp1.memory.value.wont_equal hwp2.memory.value
+  end
+
+  it "should allow fetching a hardware_profile by URI" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      hwp = client.fetch_hardware_profile( API_URL + '/hardware_profiles/m1-small' )
+      hwp.wont_be_nil
+      hwp.id.must_equal 'm1-small'
+    end
+  end
+
+end

data/tests/images_test.rb

@@ -0,0 +1,102 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Images" do
+
+  it "should allow retrieval of all images" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      images = client.images
+      images.wont_be_empty
+      images.size.must_equal 3
+      images.each do |image|
+        image.uri.wont_be_nil
+        image.uri.must_be_kind_of String
+        image.description.wont_be_nil
+        image.description.must_be_kind_of String
+        image.architecture.wont_be_nil
+        image.architecture.must_be_kind_of String
+        image.owner_id.wont_be_nil
+        image.owner_id.must_be_kind_of String
+      end
+    end
+  end
+
+  it "should allow retrieval of my own images" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      images = client.images( :owner_id=>:self )
+      images.wont_be_empty
+      images.size.must_equal 1
+      images.each do |image|
+        image.uri.wont_be_nil
+        image.uri.must_be_kind_of String
+        image.description.wont_be_nil
+        image.description.must_be_kind_of String
+        image.architecture.wont_be_nil
+        image.architecture.must_be_kind_of String
+        image.owner_id.wont_be_nil
+        image.owner_id.must_be_kind_of String
+      end
+    end
+  end
+
+  it "should allow retrieval of a single image by ID" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      image = client.image( 'img1' )
+      image.wont_be_nil
+      image.uri.must_equal API_URL + '/images/img1'
+      image.id.must_equal 'img1'
+      image.architecture.must_equal 'x86_64'
+    end
+  end
+
+  it "should allow retrieval of a single image by URI" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      image = client.fetch_image( API_URL + '/images/img1' )
+      image.wont_be_nil
+      image.uri.must_equal API_URL + '/images/img1'
+      image.id.must_equal 'img1'
+      image.architecture.must_equal 'x86_64'
+    end
+  end
+
+  describe "filtering by architecture" do
+    it "return matching images" do
+      DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+        images = client.images( :architecture=>'x86_64' )
+        images.wont_be_empty
+        images.each do |image|
+          image.architecture.must_equal 'x86_64'
+        end
+        images = client.images( :architecture=>'i386' )
+        images.wont_be_empty
+        images.each do |image|
+          image.architecture.must_equal 'i386'
+        end
+      end
+    end
+
+    it "should return an empty array for no matches" do
+      DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+        images = client.images( :architecture=>'8088' )
+        images.must_be_empty
+      end
+    end
+  end
+end

data/tests/instance_states_test.rb

@@ -0,0 +1,66 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Instance States" do
+
+  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.wont_be_nil
+      instance_states.wont_be_empty
+
+      instance_states[0].name.must_equal 'start'
+      instance_states[0].transitions.size.must_equal 1
+      instance_states[0].transitions[0].wont_equal :auto
+
+      instance_states[1].name.must_equal 'pending'
+      instance_states[1].transitions.size.must_equal 1
+      instance_states[1].transitions[0].wont_equal :auto
+
+      instance_states[2].name.must_equal 'running'
+      instance_states[2].transitions.size.must_equal 2
+      includes_transition( instance_states[2].transitions, :reboot, :running ).must_equal true
+      includes_transition( instance_states[2].transitions, :stop, :stopped ).must_equal 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.wont_be_nil
+      instance_state.name.must_equal 'pending'
+      instance_state.transitions.size.must_equal 1
+      instance_state.transitions[0].wont_equal :auto
+
+      instance_state = client.instance_state( :running )
+      instance_state.name.must_equal 'running'
+      instance_state.transitions.size.must_equal 2
+      includes_transition( instance_state.transitions, :reboot, :running ).must_equal true
+      includes_transition( instance_state.transitions, :stop, :stopped ).must_equal 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/tests/instances_test.rb

@@ -0,0 +1,203 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Instances" do
+
+  it "should allow retrieval of all instances" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      instances = client.instances
+      instances.wont_be_empty
+      instances.each do |instance|
+        instance.uri.wont_be_nil
+        instance.uri.must_be_kind_of String
+        instance.owner_id.wont_be_nil
+        instance.owner_id.must_be_kind_of String
+        instance.image.wont_be_nil
+        instance.image.to_s.must_match /DeltaCloud::API::.*::Image/
+        instance.hardware_profile.wont_be_nil
+        instance.hardware_profile.must_be_kind_of DeltaCloud::API::Base::HardwareProfile
+        instance.state.wont_be_nil
+        instance.state.must_be_kind_of String
+        instance.public_addresses.wont_be_nil
+        instance.public_addresses.wont_be_empty
+        instance.public_addresses.must_be_kind_of Array
+        instance.private_addresses.wont_be_nil
+        instance.private_addresses.wont_be_empty
+        instance.private_addresses.must_be_kind_of 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.wont_be_empty
+      instance = instances.first
+      instance.image.wont_be_nil
+      instance.image.description.wont_be_nil
+      instance.image.description.must_be_kind_of 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.wont_be_nil
+      instance.name.wont_be_nil
+      instance.name.must_equal 'Mock Instance With Profile Change'
+      instance.uri.wont_be_nil
+      instance.uri.must_be_kind_of String
+      instance.owner_id.must_equal "mockuser"
+      instance.public_addresses.first.class.must_equal Hash
+      instance.public_addresses.first[:type].must_equal 'hostname'
+      instance.public_addresses.first[:address].must_equal 'img1.inst0.public.com'
+      instance.image.wont_be_nil
+      instance.image.uri.must_equal API_URL + "/images/img1"
+      instance.hardware_profile.wont_be_nil
+      instance.hardware_profile.wont_be_nil
+      instance.hardware_profile.uri.must_equal API_URL + "/hardware_profiles/m1-large"
+      instance.hardware_profile.memory.value.must_equal '10240'
+      instance.hardware_profile.storage.value.must_equal '850'
+      instance.state.must_equal "RUNNING"
+      instance.actions.wont_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', :hardware_profile => 'm1-large' )
+      instance.wont_be_nil
+      instance.uri.must_match %r{#{API_URL}/instances/inst[0-9]+}
+      instance.id.must_match /inst[0-9]+/
+      instance.name.must_equal 'TestInstance'
+      instance.image.id.must_equal 'img1'
+      instance.hardware_profile.id.must_equal 'm1-large'
+      instance.realm.id.must_equal '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', :hardware_profile => 'm1-large' )
+      instance.wont_be_nil
+      instance.uri.must_match %r{#{API_URL}/instances/inst[0-9]+}
+      instance.id.must_match  /inst[0-9]+/
+      instance.image.id.must_equal 'img1'
+      instance.hardware_profile.id.must_equal 'm1-large'
+      instance.realm.id.must_equal '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.wont_be_nil
+      instance.uri.must_match  %r{#{API_URL}/instances/inst[0-9]+}
+      instance.id.must_match  /inst[0-9]+/
+      instance.image.id.must_equal 'img1'
+      instance.hardware_profile.id.must_equal 'm1-xlarge'
+      instance.realm.id.must_equal '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.wont_be_nil
+      instance.uri.must_match  %r{#{API_URL}/instances/inst[0-9]+}
+      instance.id.must_match  /inst[0-9]+/
+      instance.image.id.must_equal 'img1'
+      instance.hardware_profile.id.must_equal 'm1-xlarge'
+      instance.hardware_profile.memory.value.must_equal'12288'
+      instance.realm.id.must_equal '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.wont_be_nil
+      instance.uri.must_match  %r{#{API_URL}/instances/inst[0-9]+}
+      instance.id.must_match  /inst[0-9]+/
+      instance.image.id.must_equal 'img1'
+      instance.hardware_profile.id.must_equal 'm1-xlarge'
+      instance.realm.id.must_equal '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.wont_be_nil
+      instance.uri.wont_be_nil
+      instance.uri.must_be_kind_of 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.wont_be_nil
+      instance.uri.must_equal API_URL + '/instances/inst1'
+      instance.id.must_equal '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.wont_be_nil
+        instance.state.must_equal "RUNNING"
+        instance.uri.must_equal API_URL + '/instances/inst1'
+        instance.id.must_equal 'inst1'
+        instance.stop!
+        instance.state.must_equal "STOPPED"
+        instance.start!
+        instance.state.must_equal "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.wont_be_nil
+        unless instance.state.eql?("RUNNING")
+          instance.start!
+        end
+        instance.state.must_equal "RUNNING"
+        lambda{instance.start!}.must_raise NoMethodError
+      end
+    end
+
+    it "should not throw exception when destroying an instance" do
+      DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+        instance = client.create_instance( 'img1',
+                                           :name=>'TestDestroyInstance',
+                                           :hardware_profile => 'm1-xlarge' )
+        instance.stop!
+        instance.destroy!.must_be_nil
+      end
+    end
+  end
+end

data/tests/keys_test.rb

@@ -0,0 +1,81 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+def check_key(the_key, key_name = "")
+  the_key.wont_be_nil
+  the_key.id.must_be_kind_of String
+  the_key.id.must_equal key_name
+  the_key.actions.wont_be_nil
+  the_key.actions.size.must_equal 1
+  the_key.actions.first[0].must_equal "destroy"
+  the_key.actions.first[1].must_equal "#{API_URL}/keys/#{key_name}"
+  the_key.fingerprint.wont_be_nil
+  the_key.fingerprint.must_be_kind_of String
+  the_key.pem.wont_be_nil
+  the_key.pem.must_be_kind_of String
+end
+
+def create_key_if_necessary(client, key_name)
+  the_key = client.key(key_name)
+  unless the_key
+    client.create_key()
+  end
+end
+
+
+describe "Keys" do
+  it "should allow retrieval of all keys" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      client.keys.wont_be_empty
+    end
+  end
+end
+
+describe "Operations on Keys" do
+
+  it "should allow successful creation and destroy of a new key" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      new_key = client.create_key({:name => "my_new_key"})
+      check_key(new_key, "my_new_key")
+      the_key = client.key('my_new_key')
+      the_key.destroy!.must_be_nil
+    end
+  end
+
+  it "should allow retrieval of an existing named key" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      key_name = "test-key"
+      create_key_if_necessary(client, key_name)
+      the_key = client.key(key_name)
+      check_key(the_key, key_name)
+    end
+  end
+
+  it "should raise error if you create a key with the same name as an existing key" do
+    DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
+      name = "test-key"
+      create_key_if_necessary(client, name)
+      lambda{
+              client.create_key({:name => name})
+            }.must_raise DeltaCloud::HTTPError::Forbidden
+    end
+  end
+
+end

data/tests/realms_test.rb

@@ -0,0 +1,64 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Realms" do
+
+  before do
+    @client = DeltaCloud.new(API_NAME, API_PASSWORD, API_URL)
+  end
+
+  it "should allow retrieval of all realms" do
+    realms = @client.realms
+    realms.wont_be_empty
+    realms.each do |realm|
+      realm.uri.wont_be_nil
+      realm.uri.must_be_kind_of String
+      realm.id.wont_be_nil
+      realm.id.must_be_kind_of String
+      realm.name.wont_be_nil
+      realm.name.must_be_kind_of String
+    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.wont_be_nil
+      realm.id.must_equal 'us'
+      realm.name.must_equal 'United States'
+      realm.state.must_equal 'AVAILABLE'
+      realm = client.realm( 'eu' )
+      realm.wont_be_nil
+      realm.id.must_equal 'eu'
+      realm.name.must_equal 'Europe'
+      realm.state.must_equal '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.wont_be_nil
+      realm.id.must_equal 'us'
+    end
+  end
+
+end

data/tests/storage_snapshot_test.rb

@@ -0,0 +1,76 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Storage Snapshot" do
+
+  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 |c|
+      storage_snapshots = c.storage_snapshots
+      storage_snapshots.wont_be_nil
+      storage_snapshots.wont_be_empty
+      ids = storage_snapshots.collect{|e| e.id}
+      ids.size.must_equal 3
+      ids.must_include 'snap2'
+      ids.must_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 |c|
+      storage_snapshot = c.storage_snapshot( 'snap2' )
+      storage_snapshot.wont_be_nil
+      storage_snapshot.id.must_equal 'snap2'
+      storage_snapshot.storage_volume.capacity.must_equal 1.0
+      storage_snapshot.storage_volume.id.must_equal '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 |c|
+      storage_snapshot = c.fetch_storage_snapshot( API_URL + '/storage_snapshots/snap2' )
+      storage_snapshot.wont_be_nil
+      storage_snapshot.id.must_equal 'snap2'
+      storage_snapshot.storage_volume.capacity.must_equal 1.0
+      storage_snapshot.storage_volume.id.must_equal 'vol2'
+    end
+  end
+
+  it "should return nil for unknown storage volume by ID" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    lambda {
+      client.connect do |c|
+        c.storage_snapshot( "bogus" )
+      end
+    }.must_raise DeltaCloud::HTTPError::NotFound
+  end
+
+  it "should return nil for unknown storage volume by URI" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    lambda {
+      client.connect do |c|
+        c.fetch_storage_snapshot( API_URL + '/storage_snapshots/bogus' )
+      end
+    }.must_raise DeltaCloud::HTTPError::NotFound
+  end
+
+end

data/tests/storage_volume_test.rb

@@ -0,0 +1,86 @@
+# 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 'require_relative' if RUBY_VERSION =~ /^1\.8/
+
+require_relative './test_helper.rb'
+
+describe "Storage Volumes" do
+
+  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 |c|
+      storage_volumes = c.storage_volumes
+      storage_volumes.wont_be_nil
+      storage_volumes.wont_be_nil
+      ids = storage_volumes.collect{|e| e.id}
+      ids.size.must_equal 3
+      ids.must_include 'vol1'
+      ids.must_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 |c|
+      storage_volume = c.storage_volume( 'vol3' )
+      storage_volume.id.must_equal 'vol3'
+      storage_volume.uri.must_equal API_URL + '/storage_volumes/vol3'
+      storage_volume.capacity.must_equal 1.0
+      storage_volume.device.must_equal '/dev/sda1'
+      storage_volume.instance.wont_be_nil
+      storage_volume.instance.id.must_equal 'inst1'
+      ip = storage_volume.instance
+      ip.hardware_profile.architecture.value.must_equal '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 |c|
+      storage_volume = c.fetch_storage_volume( API_URL + '/storage_volumes/vol3' )
+      storage_volume.wont_be_nil
+      storage_volume.id.must_equal 'vol3'
+      storage_volume.uri.must_equal API_URL + '/storage_volumes/vol3'
+      storage_volume.capacity.must_equal 1.0
+      storage_volume.device.must_equal '/dev/sda1'
+      storage_volume.instance.wont_be_nil
+      storage_volume.instance.id.must_equal 'inst1'
+      ip = storage_volume.instance
+      ip.hardware_profile.architecture.value.must_equal 'i386'
+    end
+  end
+
+  it "should raise exception for unknown storage volume by ID" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    lambda {
+      client.connect do |c|
+        c.storage_volume( 'bogus' )
+      end
+    }.must_raise DeltaCloud::HTTPError::NotFound
+  end
+
+  it "should raise exception for unknown storage volume by URI" do
+    client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
+    lambda {
+      client.connect do |c|
+        client.fetch_storage_volume( API_URL + '/storage_volumes/bogus' )
+      end
+    }.must_raise DeltaCloud::HTTPError::NotFound
+  end
+
+
+end

data/tests/test_helper.rb

@@ -0,0 +1,16 @@
+require 'rubygems'
+require 'require_relative' if RUBY_VERSION =~ /^1\.8/
+require 'minitest/autorun'
+
+require_relative '../lib/deltacloud.rb'
+
+# Configuration:
+
+API_HOST = 'localhost'
+API_PORT = '3001'
+API_PATH = '/api'
+
+API_NAME = 'mockuser'
+API_PASSWORD = 'mockpassword'
+
+API_URL = "http://#{API_HOST}:#{API_PORT}#{API_PATH}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: deltacloud-client
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-12 00:00:00.000000000 Z
+date: 2013-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -76,6 +76,19 @@ files:
 - lib/instance_state.rb
 - lib/client_bucket_methods.rb
 - lib/errors.rb
+- tests/realms_test.rb
+- tests/content_negotiation_test.rb
+- tests/images_test.rb
+- tests/instances_test.rb
+- tests/errors_test.rb
+- tests/storage_snapshot_test.rb
+- tests/storage_volume_test.rb
+- tests/keys_test.rb
+- tests/hardware_profiles_test.rb
+- tests/buckets_test.rb
+- tests/instance_states_test.rb
+- tests/client_test.rb
+- tests/test_helper.rb
 - LICENSE
 - NOTICE
 homepage: http://www.deltacloud.org
@@ -102,4 +115,17 @@ rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Deltacloud REST Client
-test_files: []
+test_files:
+- tests/realms_test.rb
+- tests/content_negotiation_test.rb
+- tests/images_test.rb
+- tests/instances_test.rb
+- tests/errors_test.rb
+- tests/storage_snapshot_test.rb
+- tests/storage_volume_test.rb
+- tests/keys_test.rb
+- tests/hardware_profiles_test.rb
+- tests/buckets_test.rb
+- tests/instance_states_test.rb
+- tests/client_test.rb
+- tests/test_helper.rb