gapinc-cobbler 2.0.0

data/spec/unit/cobbler/common/debug_spec.rb

@@ -0,0 +1,44 @@
+#! /usr/bin/env ruby
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class TestDebug
+    include Cobbler::Common::Debug
+end
+
+describe Cobbler::Common::Debug do
+    
+    it "should provide a way to set and query a debug flag" do
+        TestDebug.should respond_to(:debug_enabled)
+        TestDebug.should respond_to(:debug_enabled=)
+    end
+
+    it "should provide a way to set and query an output engine" do
+        TestDebug.should respond_to(:output)
+        TestDebug.should respond_to(:output=)
+    end    
+    
+    it "should provide a method to print debug messages on class and instance level" do
+        TestDebug.should respond_to(:debug)
+        TestDebug.new.should respond_to(:debug)
+    end
+    
+    it "should not have debugging enabled by default" do
+        TestDebug.debug_enabled.should == false
+    end
+    
+    it "should not print out a debug message if the debug flag is not set" do
+        output = Object.new
+        output.expects(:puts).with('foo').never
+        TestDebug.output = output
+        TestDebug.debug('foo')
+    end
+
+    it "should print out a debug message if the debug flag is set" do
+        TestDebug.debug_enabled = true
+        output = Object.new
+        output.expects(:puts).with('foo').once
+        TestDebug.output = output
+        TestDebug.debug('foo')
+    end
+
+end

data/spec/unit/cobbler/common/finders_spec.rb

@@ -0,0 +1,101 @@
+#! /usr/bin/env ruby
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class TestFinder
+    
+    def initialize(a,b)
+        
+    end
+    
+    include Cobbler::Common::Debug
+    include Cobbler::Connection::Handling
+    include Cobbler::Common::Lifecycle    
+    include Cobbler::Common::Finders
+end
+
+describe Cobbler::Common::Finders do
+    it "should provide a way to find all" do
+        TestFinder.should respond_to(:find)
+    end
+    it "should provide a way to find one" do
+        TestFinder.should respond_to(:find_one)
+    end
+    
+    describe "lookup" do
+        it "should raise an exception if we don't know how to lookup all" do
+            api_methods = Object.new
+            api_methods.stubs(:[]).with(:find_all).returns(nil)
+            TestFinder.stubs(:api_methods).returns(api_methods)
+            lambda{ TestFinder.find_all }.should raise_error(Exception)
+        end
+        
+        it "should raise an exception if we don't know how to lookup an item" do
+            api_methods = Object.new
+            api_methods.stubs(:[]).with(:find_one).returns(nil)
+            TestFinder.stubs(:api_methods).returns(api_methods)
+            lambda{ TestFinder.find_one('foo') }.should raise_error(Exception)
+        end
+        
+        it "should use the :find_one api_method to lookup an item" do
+            TestFinder.api_methods[:find_one] = 'find_one'
+            connection = Object.new
+            TestFinder.expects(:connect).returns(connection)
+            TestFinder.stubs(:make_call).with('find_one','foo').returns({})
+            item = TestFinder.find_one('foo')
+            item.should be_nil
+        end
+        
+        it "should return nil if api returns '~'" do
+            TestFinder.api_methods[:find_one] = 'find_one'
+            connection = Object.new
+            TestFinder.expects(:connect).returns(connection)
+            TestFinder.stubs(:make_call).with('find_one','foo').returns('~')
+            item = TestFinder.find_one('foo')
+            item.should be_nil
+        end        
+        
+        describe "is unsuccessful" do
+            it "should return an empty array if nothing is found" do
+                TestFinder.stubs(:in_transaction).returns([])
+                TestFinder.find.should be_empty
+            end
+            it "should return nil if nothing is found" do
+                TestFinder.stubs(:in_transaction).returns({})
+                TestFinder.find_one('foo').should be_nil
+            end
+        end
+        
+        describe "successfully all items" do
+            before(:each) do
+                TestFinder.stubs(:in_transaction).returns([1,2])
+            end
+            it "should return an array of Objects of itself if something is found" do
+                items = TestFinder.find
+                items.should have(2).items
+                items.first.should be_a(TestFinder)
+                items.last.should be_a(TestFinder)
+            end
+            
+            it "should pass each found item to the passed block but return the found items" do
+                items = TestFinder.find do |item|
+                    item.should be_a(TestFinder)
+                end
+                items.should have(2).items
+                items.first.should be_a(TestFinder)
+                items.last.should be_a(TestFinder)                
+            end
+        end
+        
+        describe "successfully one item" do
+            it "should return an item" do
+                TestFinder.stubs(:in_transaction).returns({:a => 1})
+                TestFinder.find_one('foo').should be_a(TestFinder)
+            end
+            
+            it "should return nil if nothing is found" do
+                TestFinder.stubs(:in_transaction).returns({})
+                TestFinder.find_one('foo').should be_nil
+            end
+        end
+    end
+end

data/spec/unit/cobbler/common/lifecycle_spec.rb

@@ -0,0 +1,192 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class TestLifecycle
+    
+    def initialize(a=nil,b=nil)
+        @definitions = Hash.new(a)
+    end
+    
+    include Cobbler::Common::Debug
+    include Cobbler::Connection::Handling
+    include Cobbler::Common::Lifecycle
+    
+    cobbler_field :name
+    cobbler_field :foo, :locked => true
+    cobbler_field :findme, :findable => 'find_me'
+    cobbler_field :super_field, :locked => true, :findable => 'find_super'
+    
+    cobbler_fields :foo1, :foo2
+    
+    cobbler_collection :coll1
+    cobbler_collection :coll2, :packing => Hash
+    cobbler_collection :coll3, :store => :foobar
+end
+
+class TestLifecycle2
+    def initialize(a,b); end
+    include Cobbler::Common::Debug    
+    include Cobbler::Connection::Handling
+    include Cobbler::Common::Lifecycle
+    cobbler_field :name, :locked => false, :findable => false
+    cobbler_lifecycle :find_all => 'foobar', :find_one => false
+end
+
+describe Cobbler::Common::Lifecycle do
+    
+    it "should provide a bunch of api_methods for that object" do
+        TestLifecycle.api_methods.keys.should_not be_empty
+    end
+    
+    [ :find_all, :find_one, :handle, :remove, :save, :new, :modify].each do |method|
+        it "should provide an api_method for #{method} and be derived from the classname" do
+            TestLifecycle.api_methods[method].should_not be_nil
+            TestLifecycle.api_methods[method].should =~ /test_lifecycle/
+        end
+    end
+    
+    describe "defining lifecycle" do
+        it "should provide a way to define a lifecycle" do
+            TestLifecycle.should respond_to(:cobbler_lifecycle)
+        end
+        
+        it "should set the api_method according to the one we defined" do
+            TestLifecycle2.api_methods[:find_all].should == 'foobar'
+            TestLifecycle2.api_methods[:find_one].should be_false
+        end
+        
+        [ :handle, :remove, :save, :new, :modify].each do |method|
+            it "should define method #{method}" do
+                TestLifecycle2.api_methods[method].should_not be_nil
+                TestLifecycle2.api_methods[method].should =~ /test_lifecycle/
+            end
+            
+        end
+    end
+    
+    describe "define a cobbler field" do
+        it "should provide a way to define a cobbler field" do
+            TestLifecycle.should respond_to(:cobbler_field)
+        end
+        
+        it "should provide a way to define multiple cobbler fields" do
+            TestLifecycle.should respond_to(:cobbler_fields)
+        end
+        
+        it "should add this field to the record fields" do
+            TestLifecycle.cobbler_record_fields.should include(:name)
+        end
+        
+        it "should add the name field as findable" do
+            TestLifecycle.should respond_to(:find_by_name)
+        end
+
+        it "should lock the name field" do
+            TestLifecycle.locked_fields.should include(:name)
+        end
+
+        it "should not add the name field as findable if we mark it" do
+            TestLifecycle2.should_not respond_to(:find_by_name)
+        end
+
+        it "should lock the name field" do
+            TestLifecycle2.locked_fields.should_not include(:name)
+        end        
+        
+        it "should be available as getter and setter on an instance" do
+            test = TestLifecycle.new
+            test.should respond_to(:name)
+            test.should respond_to(:name=)
+        end
+        
+        it "should handle cobbler_fields over to cobbler_field" do
+            test = TestLifecycle.new
+            [:foo1,:foo2].each do |field|
+                test.should respond_to(field)
+                test.should respond_to(:"#{field}=")
+                TestLifecycle.cobbler_record_fields.should include(field)
+            end
+        end
+        
+        it "should be possible to mark that field as locked" do
+            TestLifecycle.locked_fields.should include(:foo)
+            TestLifecycle.locked_fields.should include(:super_field)
+        end
+        
+        it "should be possible to mark a field as findable" do
+            TestLifecycle.should respond_to(:find_by_findme)
+            TestLifecycle.should respond_to(:find_by_super_field)
+        end
+        
+        describe "which is findable" do
+            before(:each) do
+                connection = Object.new
+                TestLifecycle.expects(:connect).returns(connection)
+            end
+
+            it "should lookup that field" do
+                TestLifecycle.expects(:make_call).with('get_test_lifecycle','foo').returns('a')
+                item = TestLifecycle.find_by_name('foo')
+                item.should be_a(TestLifecycle)
+            end
+            it "should lookup the field with the appropriate api method" do
+                TestLifecycle.expects(:make_call).with('find_super','foo').returns('a')
+                item = TestLifecycle.find_by_super_field('foo')
+                item.should be_a(TestLifecycle)
+            end
+            
+            it "should return nil if nothing is found" do
+                TestLifecycle.expects(:make_call).with('get_test_lifecycle','foo').returns(nil)
+                TestLifecycle.find_by_name('foo').should be_nil
+            end
+        end
+    end
+    describe "define a cobbler collection" do
+        it "should provide a way to define a cobbler collection" do
+            TestLifecycle.should respond_to(:cobbler_collection)
+        end
+        
+        it "should provide accessor and setter for a collection" do
+            TestLifecycle.new.should respond_to(:coll1)
+            TestLifecycle.new.should respond_to(:coll1=)
+        end
+        
+        it "should add the collection to the fields" do
+            TestLifecycle.cobbler_record_fields.should include(:coll1)
+            TestLifecycle.cobbler_record_fields.should include(:coll2)
+        end
+        
+        it "should set a default type to be an array" do
+            TestLifecycle.new.coll1.should be_a(Array)
+        end
+
+        it "should be possible to set packing as Hash" do
+            TestLifecycle.new.coll2.should be_a(Hash)
+        end
+        
+        it "should be possible to define a special store callback" do
+            TestLifecycle.cobbler_record_fields.should_not include(:coll3)
+            TestLifecycle.cobbler_collections_store_callbacks.should include(:foobar)
+        end
+    end
+    
+    describe "assigning new values" do
+        it "should not be added to the original definitions" do
+            test = TestLifecycle.new
+            test.name = 'foo'
+            test.name.should == 'foo'
+            test.definitions['name'].should_not == 'foo'
+            test.user_definitions['name'].should == 'foo'
+        end
+        
+        it "should always be added to the user_definitions if it as collection" do
+            test = TestLifecycle.new
+            test.coll1.should == []
+            test.coll1 = [1,2]
+            test.coll1.should == [1,2]
+            test.user_definitions['coll1'].should == [1,2]
+            test.coll1 << 3
+            test.coll1 == [1,2,3]
+        end
+    end
+    
+end

data/spec/unit/cobbler/connection/common_spec.rb

@@ -0,0 +1,59 @@
+#! /usr/bin/env ruby
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class TestConnection
+    include Cobbler::Common::Debug
+    include Cobbler::Connection::Handling
+    include Cobbler::Connection::Common
+end
+
+describe Cobbler::Connection::Common do
+    it "should provide a method to test a connection" do
+        TestConnection.should respond_to(:test_connection)
+    end
+    
+    it "should provide a method to start a sync" do
+        TestConnection.should respond_to(:sync)
+    end
+    
+    describe "testing a connection" do
+        
+        before(:each) do
+            connection = Object.new
+            TestConnection.expects(:connect).returns(connection)
+        end
+        
+        it "should return false if login fails" do
+            TestConnection.expects(:login).returns(nil)
+            TestConnection.test_connection.should be_false
+        end
+        it "should return true if login succeeds and logout" do
+            TestConnection.expects(:login).returns("true")
+            TestConnection.expects(:logout)
+            TestConnection.test_connection.should be_true
+        end
+    end
+    
+    with_real_cobbler(TestConnection) do |cobbler_yml|
+        describe "testing a real connection" do
+            before(:each) do
+                TestConnection.hostname = yml['hostname']
+                TestConnection.username = yml['username']
+                TestConnection.password = yml['password']
+            end
+            
+            it "should "
+        end
+    end
+    
+    describe "syncing a cobbler" do
+        it "should send the sync command" do
+            connection = 
+            TestConnection.expects(:connect).returns(Object.new)
+            TestConnection.expects(:login).returns('foobar')
+            TestConnection.expects(:logout)
+            TestConnection.expects(:make_call).with('sync','foobar')
+            TestConnection.sync
+        end
+    end
+end

data/spec/unit/cobbler/connection/handling_spec.rb

@@ -0,0 +1,119 @@
+#! /usr/bin/env ruby
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class TestConnection
+    include Cobbler::Common::Debug
+    include Cobbler::Connection::Handling
+end
+
+describe Cobbler::Connection::Handling do
+    [:hostname, :username, :password].each do |field|
+        it "should provide getters and setters for #{field}" do
+            TestConnection.should respond_to(field)
+            TestConnection.should respond_to("#{field}=".to_sym)
+        end
+    end
+
+    it "should provide a way to query the version of the cobbler server" do
+        TestConnection.should respond_to(:remote_version)
+    end
+    
+    describe "querying remote version" do
+        before(:each) do
+            connection = Object.new
+            TestConnection.expects(:connect).returns(connection)
+            TestConnection.expects(:connection).returns(nil)
+        end        
+        
+        it "should return the version" do
+            TestConnection.expects(:make_call).with('version').returns("2.0")
+            TestConnection.remote_version.should == "2.0"
+        end
+    end
+    
+    it "should provide a way to login to the cobbler server" do
+        TestConnection.should respond_to(:login)
+    end
+    
+    describe "logging into cobbler server" do
+        
+        it "should call the login server" do
+            TestConnection.username = 'foobar'
+            TestConnection.password = 'password'
+            TestConnection.expects(:make_call).with('login','foobar','password')
+            TestConnection.login
+        end
+        
+        it "should not relogin if we are still logged in" do
+            TestConnection.username = 'foobar'
+            TestConnection.password = 'password'
+            TestConnection.expects(:make_call).with('login','foobar','password').returns("token")
+            TestConnection.login
+
+            TestConnection.username = 'foobar2'
+            TestConnection.password = 'password2'
+            TestConnection.expects(:make_call).with('login','foobar2','password2').never
+            TestConnection.login            
+        end
+    end
+    it "should provide a way to connect to the cobbler server" do
+        TestConnection.should respond_to(:connect)
+    end
+    
+    it "should connect to the cobbler server" do
+        TestConnection.hostname = 'localhost'
+        @connection = Object.new
+        XMLRPC::Client.expects(:new2).with('http://localhost/cobbler_api').returns(@connection)
+        TestConnection.send(:connect)
+    end
+    
+    describe "making a call" do
+        it "should raise an exception if no connection have been established so far" do
+            TestConnection.expects(:connection).returns(nil)
+            lambda { TestConnection.make_call('foobar') }.should raise_error(Exception)
+        end
+        
+        it "should pass all arguments to the connection and return the resul" do
+            connection = Object.new
+            connection.expects(:call).with('foo','bar').returns('juhu')
+            TestConnection.expects(:connection).twice.returns(connection)
+            TestConnection.make_call('foo','bar')
+        end
+    end
+    
+    describe "handling transactions" do
+        it "should initialze and end a connection" do
+            TestConnection.expects(:begin_transaction)
+            TestConnection.expects(:end_transaction)
+            TestConnection.send(:in_transaction) do
+               # 
+            end
+        end
+        
+        it "should cleanup the connection" do
+            TestConnection.expects(:connect).returns('foobar')
+            TestConnection.in_transaction do
+                #
+            end
+            TestConnection.send(:connection).should be_nil
+        end
+        
+        it "should login if you want a login and pass the token into the transaction and logout" do
+            connection = Object.new
+            TestConnection.expects(:login).returns('token')
+            TestConnection.expects(:logout)
+            TestConnection.expects(:connect).returns('foobar')
+            TestConnection.in_transaction(true) do |token|
+               token.should == 'token'
+            end            
+        end
+        
+        it "should ensure that the connection is cleaned up" do
+            TestConnection.expects(:connect).returns('foobar')
+            lambda { TestConnection.in_transaction do
+                raise "foobar"
+            end }.should raise_error(Exception)
+            TestConnection.send(:connection).should be_nil            
+        end
+    end
+end