oca 3.0.1

data/lib/OpenNebula.rb

@@ -0,0 +1,144 @@
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2011, OpenNebula Project Leads (OpenNebula.org)             #
+#                                                                            #
+# Licensed 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.                                             #
+#--------------------------------------------------------------------------- #
+
+begin # require 'rubygems'
+    require 'rubygems'
+rescue Exception
+end
+
+require 'xmlrpc/client'
+require 'digest/sha1'
+require 'rexml/document'
+require 'pp'
+
+require 'OpenNebula/XMLUtils'
+require 'OpenNebula/VirtualMachine'
+require 'OpenNebula/VirtualMachinePool'
+require 'OpenNebula/VirtualNetwork'
+require 'OpenNebula/VirtualNetworkPool'
+require 'OpenNebula/Image'
+require 'OpenNebula/ImagePool'
+require 'OpenNebula/User'
+require 'OpenNebula/UserPool'
+require 'OpenNebula/Host'
+require 'OpenNebula/HostPool'
+require 'OpenNebula/Template'
+require 'OpenNebula/TemplatePool'
+require 'OpenNebula/Group'
+require 'OpenNebula/GroupPool'
+require 'OpenNebula/Acl'
+require 'OpenNebula/AclPool'
+
+module OpenNebula
+
+    # -------------------------------------------------------------------------
+    # The Error Class represents a generic error in the OpenNebula
+    # library. It contains a readable representation of the error.
+    # Any function in the OpenNebula module will return an Error
+    # object in case of error.
+    # -------------------------------------------------------------------------
+    class Error
+        attr_reader :message
+
+        # +message+ a description of the error
+        def initialize(message=nil)
+            @message=message
+        end
+
+        def to_str()
+            @message
+        end
+    end
+
+    # -------------------------------------------------------------------------
+    # Returns true if the object returned by a method of the OpenNebula
+    # library is an Error
+    # -------------------------------------------------------------------------
+    def self.is_error?(value)
+        value.class==OpenNebula::Error
+    end
+
+    # -------------------------------------------------------------------------
+    # The client class, represents the connection with the core and handles the
+    # xml-rpc calls.
+    # -------------------------------------------------------------------------
+    class Client
+        attr_accessor :one_auth
+
+        begin
+            require 'xmlparser'
+            XMLPARSER=true
+        rescue LoadError
+            XMLPARSER=false
+        end
+
+        def initialize(secret=nil, endpoint=nil, hash=true)
+            if secret
+                one_secret = secret
+            elsif ENV["ONE_AUTH"] and !ENV["ONE_AUTH"].empty? and File.file?(ENV["ONE_AUTH"])
+                one_secret=File.read(ENV["ONE_AUTH"])
+            elsif File.file?(ENV["HOME"]+"/.one/one_auth")
+                one_secret=File.read(ENV["HOME"]+"/.one/one_auth")
+            else
+                raise "ONE_AUTH file not present"
+            end
+
+            tokens = one_secret.chomp.split(':')
+
+            if tokens.length > 2
+                @one_auth = one_secret
+            elsif tokens.length == 2
+                if hash
+                    pass = Digest::SHA1.hexdigest(tokens[1])
+                else
+                    pass = tokens[1]
+                end
+                @one_auth = "#{tokens[0]}:#{pass}"
+            else
+                raise "Authorization file malformed"
+            end
+
+            if endpoint
+                @one_endpoint=endpoint
+            elsif ENV["ONE_XMLRPC"]
+                @one_endpoint=ENV["ONE_XMLRPC"]
+            else
+                @one_endpoint="http://localhost:2633/RPC2"
+            end
+
+            @server=XMLRPC::Client.new2(@one_endpoint)
+        end
+
+        def call(action, *args)
+
+            if XMLPARSER
+                @server.set_parser(XMLRPC::XMLParser::XMLStreamParser.new)
+            end
+
+            begin
+                response = @server.call_async("one."+action, @one_auth, *args)
+
+                if response[0] == false
+                    Error.new(response[1])
+                else
+                    response[1] #response[1..-1]
+                end
+            rescue Exception => e
+                Error.new(e.message)
+            end
+        end
+    end
+end

data/lib/oca.rb

@@ -0,0 +1 @@
+require 'OpenNebula.rb'

data/test/HostPool_spec.rb

@@ -0,0 +1,82 @@
+$: << '../' \
+   << './'
+
+require 'OpenNebula'
+require 'helpers/MockClient'
+
+module OpenNebula
+
+    describe "Host using NOKOGIRI" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            client = MockClient.new()
+            @host_pool = HostPool.new(client)
+        end
+        
+        it "should update the HOST_POOL info" do
+            rc = @host_pool.info()
+            rc.nil?.should eql(true)
+        end
+
+        it "should iterate the HOST_POOL elements and get info from them" do
+            rc = @host_pool.each{ |host|
+                host.class.to_s.should eql("OpenNebula::Host")
+                if host.id == 0
+                    host.name.should eql('dummyhost')
+                    host['STATE'].should eql('2')
+                    host['IM_MAD'].should eql('im_dummy')
+                    host['HOST_SHARE/MEM_USAGE'].should eql('1572864')
+                    host['HOST_SHARE/CPU_USAGE'].should eql('300')
+                    host['HOST_SHARE/FREE_MEM'].should eql('16777216')
+                    host['HOST_SHARE/RUNNING_VMS'].should eql('3')
+                elsif host.id == 1
+                    host.name.should eql('thost')
+                    host['STATE'].should eql('2')
+                    host['IM_MAD'].should eql('im_dummy')
+                    host['HOST_SHARE/MEM_USAGE'].should eql('0')
+                    host['HOST_SHARE/CPU_USAGE'].should eql('0')
+                    host['HOST_SHARE/FREE_MEM'].should eql('16777216')
+                    host['HOST_SHARE/RUNNING_VMS'].should eql('0')
+                end
+            }
+        end
+    end
+    
+    describe "Host using REXML" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            client = MockClient.new()
+            @host_pool = HostPool.new(client)
+        end
+        
+        it "should update the HOST_POOL info" do
+            rc = @host_pool.info()
+            rc.nil?.should eql(true)
+        end
+
+        it "should iterate the HOST_POOL elements and get info from them" do
+            rc = @host_pool.each{ |host|
+                host.class.to_s.should eql("OpenNebula::Host")
+                if host.id == 0
+                    host.name.should eql('dummyhost')
+                    host['STATE'].should eql('2')
+                    host['IM_MAD'].should eql('im_dummy')
+                    host['HOST_SHARE/MEM_USAGE'].should eql('1572864')
+                    host['HOST_SHARE/CPU_USAGE'].should eql('300')
+                    host['HOST_SHARE/FREE_MEM'].should eql('16777216')
+                    host['HOST_SHARE/RUNNING_VMS'].should eql('3')
+                elsif host.id == 1
+                    host.name.should eql('thost')
+                    host['STATE'].should eql('2')
+                    host['IM_MAD'].should eql('im_dummy')
+                    host['HOST_SHARE/MEM_USAGE'].should eql('0')
+                    host['HOST_SHARE/CPU_USAGE'].should eql('0')
+                    host['HOST_SHARE/FREE_MEM'].should eql('16777216')
+                    host['HOST_SHARE/RUNNING_VMS'].should eql('0')
+                end
+            }
+        end
+    end
+end

data/test/Host_spec.rb

@@ -0,0 +1,220 @@
+$: << '../' \
+   << './'
+
+require 'OpenNebula'
+require 'helpers/MockClient'
+
+module OpenNebula
+
+    describe "Host using NOKOGIRI" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            @xml = Host.build_xml(7)
+            
+            client = MockClient.new()
+            @host = Host.new(@xml,client)
+        end
+
+        it "should create a Nokogiri Node" do
+            @xml.class.to_s.should eql('Nokogiri::XML::NodeSet')
+        end
+
+        it "should allocate the new HOST" do
+            @host.allocate(nil,nil,nil,nil)
+
+            @host.id.should eql(7)
+        end
+        
+        it "should update the HOST info" do
+            @host.info()
+            
+            @host.id.should eql(7)
+            @host.name.should eql('dummyhost')
+            @host.state.should eql(2)
+            @host.state_str.should eql('MONITORED')
+            @host.short_state_str.should eql('on')
+        end
+
+        it "should enable the HOST" do
+            rc = @host.enable()
+
+            rc.should eql(nil)
+        end
+
+        it "should disable the HOST" do
+            rc = @host.disable()
+
+            rc.should eql(nil)
+        end
+
+        it "should delete the HOST" do
+            rc = @host.delete()
+
+            rc.should eql(nil)
+        end
+
+        it "should access an attribute using []" do
+            @host['ID'].should eql('7')
+            @host['NAME'].should eql('dummyhost')
+            @host['STATE'].should eql('2')
+            @host['IM_MAD'].should eql('im_dummy')
+            @host['LAST_MON_TIME'].should eql('1277733596')
+            @host['HOST_SHARE/MEM_USAGE'].should eql('1572864')
+            @host['HOST_SHARE/CPU_USAGE'].should eql('300')
+            @host['HOST_SHARE/FREE_CPU'].should eql('800')
+            @host['HOST_SHARE/RUNNING_VMS'].should eql('3')
+            @host['TEMPLATE/CPUSPEED'].should eql('2.2GHz')
+            @host['TEMPLATE/HYPERVISOR'].should eql('dummy')
+            @host['TEMPLATE/TOTALMEMORY'].should eql('16777216')
+        end
+    end
+
+    describe "Host using REXML" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            @xml = Host.build_xml(7)
+            
+            client = MockClient.new()
+            @host = Host.new(@xml,client)
+        end
+
+        it "should create a REXML Element" do
+            @xml.class.to_s.should eql('REXML::Element')
+        end
+
+        it "should allocate the new HOST" do
+            @host.allocate(nil,nil,nil,nil)
+
+            @host.id.should eql(7)
+        end
+        
+        it "should update the HOST info" do
+            @host.info()
+            
+            @host.id.should eql(7)
+            @host.name.should eql('dummyhost')
+            @host.state.should eql(2)
+            @host.state_str.should eql('MONITORED')
+            @host.short_state_str.should eql('on')
+        end
+
+        it "should enable the HOST" do
+            rc = @host.enable()
+
+            rc.should eql(nil)
+        end
+
+        it "should disable the HOST" do
+            rc = @host.disable()
+
+            rc.should eql(nil)
+        end
+
+        it "should delete the HOST" do
+            rc = @host.delete()
+
+            rc.should eql(nil)
+        end
+
+        it "should access an attribute using []" do
+            @host['ID'].should eql('7')
+            @host['NAME'].should eql('dummyhost')
+            @host['STATE'].should eql('2')
+            @host['IM_MAD'].should eql('im_dummy')
+            @host['LAST_MON_TIME'].should eql('1277733596')
+            @host['HOST_SHARE/MEM_USAGE'].should eql('1572864')
+            @host['HOST_SHARE/CPU_USAGE'].should eql('300')
+            @host['HOST_SHARE/FREE_CPU'].should eql('800')
+            @host['HOST_SHARE/RUNNING_VMS'].should eql('3')
+            @host['TEMPLATE/CPUSPEED'].should eql('2.2GHz')
+            @host['TEMPLATE/HYPERVISOR'].should eql('dummy')
+            @host['TEMPLATE/TOTALMEMORY'].should eql('16777216')
+        end
+    end
+
+
+    describe "Host using NOKOGIRI without id" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            @xml = Host.build_xml()
+            
+            client = MockClient.new()
+            @host = Host.new(@xml,client)
+        end
+
+        it "should create a Nokogiri Node" do
+            @xml.class.to_s.should eql('Nokogiri::XML::NodeSet')
+        end
+        
+        it "should get Error getting info" do
+            rc = @host.info()        
+            
+            OpenNebula.is_error?(rc).should eql(true)
+            @host.id.should eql(nil)
+            @host.name.should eql(nil)
+        end
+
+        it "should enable the HOST" do
+            rc = @host.enable()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should disable the HOST" do
+            rc = @host.disable()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should get Error deleting the HOST" do
+            rc = @host.delete()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+    end
+
+    describe "Host using REXML without id" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            @xml = Host.build_xml()
+            
+            client = MockClient.new()
+            @host = Host.new(@xml,client)
+        end
+
+        it "should create a REXML Element" do
+            @xml.class.to_s.should eql('REXML::Element')
+        end
+        
+        it "should get Error getting info" do
+            rc = @host.info()
+            
+            OpenNebula.is_error?(rc).should eql(true)
+            @host.id.should eql(nil)
+            @host.name.should eql(nil)
+        end
+
+        it "should enable the HOST" do
+            rc = @host.enable()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should disable the HOST" do
+            rc = @host.disable()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should get Error deleting the HOST" do
+            rc = @host.delete()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+    end
+
+end

data/test/UserPool_spec.rb

@@ -0,0 +1,66 @@
+$: << '../' \
+   << './'
+
+require 'OpenNebula'
+require 'helpers/MockClient'
+
+module OpenNebula
+
+    describe "User using NOKOGIRI" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            client = MockClient.new()
+            @user_pool = UserPool.new(client)
+        end
+        
+        it "should update the USER_POOL info" do
+            rc = @user_pool.info()
+            rc.nil?.should eql(true)
+        end
+
+        it "should iterate the USER_POOL elements and get info from them" do
+            rc = @user_pool.each{ |user|
+                user.class.to_s.should eql("OpenNebula::User")
+                if user.id == 0
+                    user.name.should eql('oneadmin')
+                    user['PASSWORD'].should eql('f13a1234833436f71ab846572d251c0d40391e72')
+                    user['ENABLED'].should eql('1')
+                elsif user.id == 1
+                    user.name.should eql('dan')
+                    user['PASSWORD'].should eql('d22a12348334v33f71ba846572d25250d40701e72')
+                    user['ENABLED'].should eql('0')
+                end
+            }
+        end
+    end
+    
+    describe "User using REXML" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            client = MockClient.new()
+            @user_pool = UserPool.new(client)
+        end
+        
+        it "should update the USER_POOL info" do
+            rc = @user_pool.info()
+            rc.nil?.should eql(true)
+        end
+
+        it "should iterate the USER_POOL elements and get info from them" do
+            rc = @user_pool.each{ |user|
+                user.class.to_s.should eql("OpenNebula::User")
+                if user.id == 0
+                    user.name.should eql('oneadmin')
+                    user['PASSWORD'].should eql('f13a1234833436f71ab846572d251c0d40391e72')
+                    user['ENABLED'].should eql('1')
+                elsif user.id == 1
+                    user.name.should eql('dan')
+                    user['PASSWORD'].should eql('d22a12348334v33f71ba846572d25250d40701e72')
+                    user['ENABLED'].should eql('0')
+                end
+            }
+        end
+    end
+end

data/test/User_spec.rb

@@ -0,0 +1,146 @@
+$: << '../' \
+   << './'
+
+require 'OpenNebula'
+require 'helpers/MockClient'
+
+module OpenNebula
+
+    describe "User using NOKOGIRI" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            @xml = User.build_xml(3)
+            
+            client = MockClient.new()
+            @user = User.new(@xml,client)
+        end
+
+        it "should create a Nokogiri Node" do
+            @xml.class.to_s.should eql('Nokogiri::XML::NodeSet')
+        end
+
+        it "should allocate the new USER" do
+            @user.allocate(nil,nil)
+
+            @user.id.should eql(3)
+        end
+        
+        it "should update the USER info" do
+            @user.info()
+            
+            @user.id.should eql(3)
+            @user.name.should eql('dan')
+        end
+        
+        it "should delete the USER" do
+            rc = @user.delete()
+
+            rc.should eql(nil)
+        end
+
+        it "should access an attribute using []" do
+            @user['ID'].should eql('3')
+            @user['NAME'].should eql('dan')
+            @user['PASSWORD'].should eql('d22a12348334v33f71ba846572d25250d40701e72')
+            @user['ENABLED'].should eql('0')
+        end
+    end
+
+    describe "User using REXML" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            @xml = User.build_xml(3)
+            
+            client = MockClient.new()
+            @user = User.new(@xml,client)
+        end
+
+        it "should create a REXML Element" do
+            @xml.class.to_s.should eql('REXML::Element')
+        end
+
+        it "should allocate the new USER" do
+            @user.allocate(nil,nil)
+
+            @user.id.should eql(3)
+        end
+
+        it "should update the USER info" do
+            @user.info()
+
+            @user.id.should eql(3)
+            @user.name.should eql('dan')
+        end
+        
+        it "should delete the USER" do
+            rc = @user.delete()
+
+            rc.should eql(nil)
+        end
+
+        it "should access an attribute using []" do
+            @user['ID'].should eql('3')
+            @user['NAME'].should eql('dan')
+            @user['PASSWORD'].should eql('d22a12348334v33f71ba846572d25250d40701e72')
+            @user['ENABLED'].should eql('0')
+        end
+    end
+
+
+    describe "User using NOKOGIRI without id" do
+        before(:all) do
+            NOKOGIRI=true
+            
+            @xml = User.build_xml()
+            
+            client = MockClient.new()
+            @user = User.new(@xml,client)
+        end
+
+        it "should create a Nokogiri Node" do
+            @xml.class.to_s.should eql('Nokogiri::XML::NodeSet')
+        end
+
+        it "should get Error getting info" do
+            rc = @user.info()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should get Error deleting the USER" do
+            rc = @user.delete()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+    end
+
+    describe "User using REXML without id" do
+        before(:all) do
+            NOKOGIRI=false
+            
+            @xml = User.build_xml()
+            
+            client = MockClient.new()
+            @user = User.new(@xml,client)
+        end
+
+        it "should create a REXML Element" do
+            @xml.class.to_s.should eql('REXML::Element')
+        end
+        
+        it "should get Error getting info" do
+            rc = @user.info()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+
+        it "should get Error deleting the USER" do
+            rc = @user.delete()
+
+            OpenNebula.is_error?(rc).should eql(true)
+        end
+    end
+
+end