vi_api_lib 0.1.0 → 0.1.1

data/History.txt

@@ -1,3 +1,17 @@
+=== 0.1.1 / 2009-04-21
+
+* 3 bug fixes:
+  * Use correkt managed type for unknown object types.
+  * Use base class for DateTime objects.
+  * Avoid nil dereference on empty property set.
+
+* 1 major anhancement:
+  * Add interaction functionality to VirtualMachine.
+
+* 2 minor enhancements:
+  * Add task_manager to session.
+  * Add accessor for type names in SOAP response.
+
 === 0.1.0 / 2009-04-20
 
 * First Gem Release

data/Manifest.txt

@@ -14,6 +14,7 @@ lib/vmware/objects/folder.rb
 lib/vmware/objects/host_system.rb
 lib/vmware/objects/managed_entity.rb
 lib/vmware/objects/network.rb
+lib/vmware/objects/task_manager.rb
 lib/vmware/objects/virtual_machine.rb
 lib/vmware/session.rb
 lib/vmware/soap/vim25.rb

data/README

@@ -1,6 +1,6 @@
 = Ruby VMware 2.5 Web Services API
 
-http://vi_api_lib.rubyforge.org
+http://rubyforge.org/projects/vi-api-lib/
 
 ================================
 Copyright 2009 Paglo Labs, Inc. All rights reserved.
@@ -20,7 +20,7 @@ See the examples directory for an example of how to use the library.
 
 == INSTALL:
 
-* gem install vi_api_lib
+* gem install --no-rdoc --no-ri vi_api_lib
 
 == LICENSE:
 

data/lib/vmware/objects/data_object.rb

@@ -25,6 +25,9 @@ class VMware::DataObject
     
     @cached_properties = prop_hash
   end
+  def soap_type
+    @values.class.to_s
+  end
   
   #
   # Return a specific property.
@@ -64,7 +67,7 @@ class VMware::DataObject
   end
   
   def self.is_base_class(val)
-    val.nil? or val.is_a? String or val.is_a? TrueClass or val.is_a? FalseClass or val.is_a? Numeric
+    val.nil? or val.is_a? String or val.is_a? TrueClass or val.is_a? FalseClass or val.is_a? Numeric or val.is_a? DateTime
   end
   
 end

data/lib/vmware/objects/managed_entity.rb

@@ -8,8 +8,9 @@ class VMware::ManagedEntity
   #
   # Create a wrapper for managed object based on a ManagedObjectReference
   #
-  def initialize(session, object_reference)
+  def initialize(session, object_reference, managed_type=nil)
     @session, @object_reference = session, object_reference
+    @managed_type = managed_type
     
     # We cache properties for more efficient access.
     @cached_properties = nil
@@ -31,7 +32,7 @@ class VMware::ManagedEntity
 
     # Which properties to return.
     prop_spec = PropertySpec.new
-    prop_spec.type = self.class.to_s.gsub(/^.*::/, "")
+    prop_spec.type = @managed_type || self.class.to_s.gsub(/^.*::/, "")
     prop_spec.pathSet = prop_list
     prop_spec.all = prop_list.empty?
 
@@ -59,7 +60,7 @@ class VMware::ManagedEntity
       prop_set = object_list[0].propSet
       prop_set.each do |prop|
         prop_hash[prop.name] = VMware::DataObject::soap_to_data_object(prop.val)
-      end
+      end unless prop_set.nil?
     rescue SOAP::FaultError => e
       puts e.inspect
     end

data/lib/vmware/objects/task_manager.rb

@@ -0,0 +1,13 @@
+class VMware::Task < VMware::ManagedEntity
+  # nothing usefull in here
+  # just to suppress warning
+end
+class VMware::TaskManager < VMware::ManagedEntity
+  def recent_tasks
+    tasks = self["recentTask"]
+    return [] if tasks.nil?
+    tasks.collect do |task|
+      @session.managed_object_wrapper_factory("Task", task)['info']
+    end
+  end
+end

data/lib/vmware/objects/virtual_machine.rb

@@ -1,12 +1,14 @@
 class VMware::VirtualMachine < VMware::ManagedEntity
    
   def networks
+    return [] if self['network'].nil?
     self["network"].collect do |network|
       @session.managed_object_wrapper_factory("Network", network)
     end
   end
   
   def datastores
+    return [] if self['datastore'].nil?
     self["datastore"].collect do |datastore|
       @session.managed_object_wrapper_factory("Datastore", datastore)
     end
@@ -16,4 +18,25 @@ class VMware::VirtualMachine < VMware::ManagedEntity
     @session.managed_object_wrapper_factory("ResourcePool", self["resourcePool"])
   end
   
+  def powerOnVM_Task
+    @session.powerOnVM_Task PowerOnVMRequestType.new self.object_reference
+  end
+  def powerOffVM
+    @session.powerOffVM PowerOffVMRequestType.new self.object_reference
+  end
+  def shutdownGuest
+    @session.shutdownGuest ShutdownGuestRequestType.new self.object_reference
+  end
+  def markAsTemplate
+    @session.markAsTemplate MarkAsTemplateRequestType.new self.object_reference
+  end
+  def suspendVM_Task
+    @session.suspendVM_Task SuspendVMRequestType.new self.object_reference
+  end
+  def resetVM_Task
+    @session.resetVM_Task ResetVMRequestType.new self.object_reference
+  end
+  def rebootGuest
+    @session.rebootGuest RebootGuestRequestType.new self.object_reference
+  end
 end

data/lib/vmware/session.rb

@@ -31,6 +31,9 @@ class VMware::Session
   def root_folder
     managed_object_wrapper_factory("Folder", @sic.rootFolder)
   end
+  def task_manager
+    managed_object_wrapper_factory("TaskManager", @sic.taskManager)
+  end
   
   #
   # Login to the server.
@@ -54,7 +57,7 @@ class VMware::Session
       eval("VMware::#{type}.new(self, reference)")
     rescue
       puts "WARNING: Unknown managed object type: #{type}"
-      VMware::ManagedEntity.new(self, reference)
+      VMware::ManagedEntity.new(self, reference, type)
     end
   end
   

data/lib/vmware.rb

@@ -17,4 +17,5 @@ require 'vmware/objects/host_system'
 require 'vmware/objects/network'
 require 'vmware/objects/virtual_machine'
 require 'vmware/objects/compute_resource'
-require 'vmware/objects/datastore'
+require 'vmware/objects/datastore'
+require 'vmware/objects/task_manager'

data/rakefile

@@ -12,7 +12,7 @@ Hoe.new('vi_api_lib', version) do |p|
   p.extra_rdoc_files = ['COPYING']
 end
 
-task :default => :debug_gem
+task :default => :clean
 
 desc "make new history entry with increased major version number"
 task 'make_major_history' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: vi_api_lib
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors: 
 - Chris Waters
@@ -62,6 +62,7 @@ files:
 - lib/vmware/objects/host_system.rb
 - lib/vmware/objects/managed_entity.rb
 - lib/vmware/objects/network.rb
+- lib/vmware/objects/task_manager.rb
 - lib/vmware/objects/virtual_machine.rb
 - lib/vmware/session.rb
 - lib/vmware/soap/vim25.rb
@@ -69,7 +70,7 @@ files:
 - lib/vmware/soap/vim25MappingRegistry.rb
 - rakefile
 has_rdoc: true
-homepage: http://vi_api_lib.rubyforge.org
+homepage: http://rubyforge.org/projects/vi-api-lib/
 post_install_message: 
 rdoc_options: 
 - --main