# -*- coding: utf-8 -*- ''' :codeauthor: :email:`Nicole Thomas ` :codeauthor: :email:`Alexandru Bleotu ` Tests for functions in salt.modules.vsphere ''' # Import Python Libs from __future__ import absolute_import # Import Salt Libs import salt.modules.vsphere as vsphere from salt.exceptions import CommandExecutionError, VMwareSaltError # Import Salt Testing Libs from tests.support.mixins import LoaderModuleMockMixin from tests.support.unit import TestCase, skipIf from tests.support.mock import ( MagicMock, patch, NO_MOCK, NO_MOCK_REASON, call ) # Globals HOST = '1.2.3.4' USER = 'root' PASSWORD = 'SuperSecret!' ERROR = 'Some Testing Error Message' @skipIf(NO_MOCK, NO_MOCK_REASON) class VsphereTestCase(TestCase, LoaderModuleMockMixin): ''' Unit TestCase for the salt.modules.vsphere module. ''' def setup_loader_modules(self): return {vsphere: {'__virtual__': MagicMock(return_value='vsphere')}} # Tests for get_coredump_network_config function def test_get_coredump_network_config_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.get_coredump_network_config, HOST, USER, PASSWORD, esxi_hosts='foo') def test_get_coredump_network_config_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'Error': ERROR}}, vsphere.get_coredump_network_config(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_coredump_network_config_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): with patch('salt.modules.vsphere._format_coredump_stdout', MagicMock(return_value={})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'Coredump Config': {}}}, vsphere.get_coredump_network_config(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_coredump_network_config_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): self.assertEqual({HOST: {'Error': ERROR}}, vsphere.get_coredump_network_config(HOST, USER, PASSWORD)) def test_get_coredump_network_config_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): with patch('salt.modules.vsphere._format_coredump_stdout', MagicMock(return_value={})): self.assertEqual({HOST: {'Coredump Config': {}}}, vsphere.get_coredump_network_config(HOST, USER, PASSWORD)) # Tests for coredump_network_enable function def test_coredump_network_enable_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.coredump_network_enable, HOST, USER, PASSWORD, True, esxi_hosts='foo') def test_coredump_network_enable_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'Error': ERROR}}, vsphere.coredump_network_enable(HOST, USER, PASSWORD, True, esxi_hosts=[host_1])) def test_coredump_network_enable_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): with patch('salt.modules.vsphere._format_coredump_stdout', MagicMock(return_value={})): enabled = True host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'Coredump Enabled': enabled}}, vsphere.coredump_network_enable(HOST, USER, PASSWORD, enabled, esxi_hosts=[host_1])) def test_coredump_network_enable_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): self.assertEqual({HOST: {'Error': ERROR}}, vsphere.coredump_network_enable(HOST, USER, PASSWORD, True)) def test_coredump_network_enable_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): with patch('salt.modules.vsphere._format_coredump_stdout', MagicMock(return_value={})): enabled = True self.assertEqual({HOST: {'Coredump Enabled': enabled}}, vsphere.coredump_network_enable(HOST, USER, PASSWORD, enabled)) # Tests for set_coredump_network_config function def test_set_coredump_network_config_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.set_coredump_network_config, HOST, USER, PASSWORD, 'loghost', 'foo', esxi_hosts='bar') def test_set_coredump_network_config_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'retcode': 1, 'success': False}}, vsphere.set_coredump_network_config(HOST, USER, PASSWORD, 'dump-ip.test.com', esxi_hosts=[host_1])) def test_set_coredump_network_config_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'retcode': 0, 'success': True}}, vsphere.set_coredump_network_config(HOST, USER, PASSWORD, 'dump-ip.test.com', esxi_hosts=[host_1])) def test_set_coredump_network_config_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1})): self.assertEqual({HOST: {'retcode': 1, 'success': False}}, vsphere.set_coredump_network_config(HOST, USER, PASSWORD, 'dump-ip.test.com')) def test_set_coredump_network_config_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0})): self.assertEqual({HOST: {'retcode': 0, 'success': True}}, vsphere.set_coredump_network_config(HOST, USER, PASSWORD, 'dump-ip.test.com')) # Tests for get_firewall_status function def test_get_firewall_status_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.get_firewall_status, HOST, USER, PASSWORD, esxi_hosts='foo') def test_get_firewall_status_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'success': False, 'Error': ERROR, 'rulesets': None}}, vsphere.get_firewall_status(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_firewall_status_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'rulesets': {}, 'success': True}}, vsphere.get_firewall_status(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_firewall_status_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): self.assertEqual({HOST: {'success': False, 'Error': ERROR, 'rulesets': None}}, vsphere.get_firewall_status(HOST, USER, PASSWORD)) def test_get_firewall_status_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): self.assertEqual({HOST: {'rulesets': {}, 'success': True}}, vsphere.get_firewall_status(HOST, USER, PASSWORD)) # Tests for enable_firewall_ruleset function def test_enable_firewall_ruleset_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.enable_firewall_ruleset, HOST, USER, PASSWORD, 'foo', 'bar', esxi_hosts='baz') # Tests for syslog_service_reload function def test_syslog_service_reload_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.syslog_service_reload, HOST, USER, PASSWORD, esxi_hosts='foo') # Tests for set_syslog_config function. # These tests only test the firewall=True and syslog_config == 'loghost' if block. # The rest of the function is tested in the _set_syslog_config_helper tests below. def test_set_syslog_config_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list, but we don't enter the 'loghost'/firewall loop. ''' self.assertRaises(CommandExecutionError, vsphere.set_syslog_config, HOST, USER, PASSWORD, 'foo', 'bar', esxi_hosts='baz') def test_set_syslog_config_esxi_hosts_not_list_firewall(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list, and we enter the 'loghost'/firewall loop. ''' self.assertRaises(CommandExecutionError, vsphere.set_syslog_config, HOST, USER, PASSWORD, 'loghost', 'foo', firewall=True, esxi_hosts='bar') def test_set_syslog_config_host_list_firewall_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts with 'loghost' as syslog_config. ''' with patch('salt.modules.vsphere.enable_firewall_ruleset', MagicMock(return_value={'host_1.foo.com': {'retcode': 1, 'stdout': ERROR}})): with patch('salt.modules.vsphere._set_syslog_config_helper', MagicMock(return_value={})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'enable_firewall': {'message': ERROR, 'success': False}}}, vsphere.set_syslog_config(HOST, USER, PASSWORD, 'loghost', 'foo', firewall=True, esxi_hosts=[host_1])) def test_set_syslog_config_host_list_firewall_success(self): ''' Tests successful function return with list of esxi_hosts with 'loghost' as syslog_config. ''' with patch('salt.modules.vsphere.enable_firewall_ruleset', MagicMock(return_value={'host_1.foo.com': {'retcode': 0}})): with patch('salt.modules.vsphere._set_syslog_config_helper', MagicMock(return_value={})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'enable_firewall': {'success': True}}}, vsphere.set_syslog_config(HOST, USER, PASSWORD, 'loghost', 'foo', firewall=True, esxi_hosts=[host_1])) def test_set_syslog_config_firewall_bad_retcode(self): ''' Tests error message given for a single ESXi host with 'loghost' as syslog_config. ''' with patch('salt.modules.vsphere.enable_firewall_ruleset', MagicMock(return_value={HOST: {'retcode': 1, 'stdout': ERROR}})): with patch('salt.modules.vsphere._set_syslog_config_helper', MagicMock(return_value={})): self.assertEqual({HOST: {'enable_firewall': {'message': ERROR, 'success': False}}}, vsphere.set_syslog_config(HOST, USER, PASSWORD, 'loghost', 'foo', firewall=True)) def test_set_syslog_config_firewall_success(self): ''' Tests successful function return for a single ESXi host with 'loghost' as syslog_config. ''' with patch('salt.modules.vsphere.enable_firewall_ruleset', MagicMock(return_value={HOST: {'retcode': 0}})): with patch('salt.modules.vsphere._set_syslog_config_helper', MagicMock(return_value={})): self.assertEqual({HOST: {'enable_firewall': {'success': True}}}, vsphere.set_syslog_config(HOST, USER, PASSWORD, 'loghost', 'foo', firewall=True)) # Tests for get_syslog_config function def test_get_syslog_config_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.get_syslog_config, HOST, USER, PASSWORD, esxi_hosts='foo') def test_get_syslog_config_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'message': ERROR, 'success': False}}, vsphere.get_syslog_config(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_syslog_config_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'success': True}}, vsphere.get_syslog_config(HOST, USER, PASSWORD, esxi_hosts=[host_1])) def test_get_syslog_config_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): self.assertEqual({HOST: {'message': ERROR, 'success': False}}, vsphere.get_syslog_config(HOST, USER, PASSWORD)) def test_get_syslog_config_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): self.assertEqual({HOST: {'success': True}}, vsphere.get_syslog_config(HOST, USER, PASSWORD)) # Tests for reset_syslog_config function def test_reset_syslog_config_no_syslog_config(self): ''' Tests CommandExecutionError is raised when a syslog_config parameter is missing. ''' self.assertRaises(CommandExecutionError, vsphere.reset_syslog_config, HOST, USER, PASSWORD) def test_reset_syslog_config_esxi_hosts_not_list(self): ''' Tests CommandExecutionError is raised when esxi_hosts is provided, but is not a list. ''' self.assertRaises(CommandExecutionError, vsphere.reset_syslog_config, HOST, USER, PASSWORD, syslog_config='test', esxi_hosts='foo') def test_reset_syslog_config_invalid_config_param(self): ''' Tests error message returned when an invalid syslog_config parameter is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={})): error = 'Invalid syslog configuration parameter' self.assertEqual({HOST: {'success': False, 'test': {'message': error, 'success': False}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='test')) def test_reset_syslog_config_host_list_bad_retcode(self): ''' Tests error message returned with list of esxi_hosts. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'success': False, 'logdir': {'message': ERROR, 'success': False}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='logdir', esxi_hosts=[host_1])) def test_reset_syslog_config_host_list_success(self): ''' Tests successful function return when an esxi_host is provided. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): host_1 = 'host_1.foo.com' self.assertEqual({host_1: {'success': True, 'loghost': {'success': True}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='loghost', esxi_hosts=[host_1])) def test_reset_syslog_config_bad_retcode(self): ''' Tests error message given for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): self.assertEqual({HOST: {'success': False, 'logdir-unique': {'message': ERROR, 'success': False}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='logdir-unique')) def test_reset_syslog_config_success(self): ''' Tests successful function return for a single ESXi host. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): self.assertEqual({HOST: {'success': True, 'default-rotate': {'success': True}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='default-rotate')) def test_reset_syslog_config_success_multiple_configs(self): ''' Tests successful function return for a single ESXi host when passing in multiple syslog_config values. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): self.assertEqual({HOST: {'success': True, 'default-size': {'success': True}, 'default-timeout': {'success': True}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='default-size,default-timeout')) def test_reset_syslog_config_success_all_configs(self): ''' Tests successful function return for a single ESXi host when passing in multiple syslog_config values. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0, 'stdout': ''})): self.assertEqual({HOST: {'success': True, 'logdir': {'success': True}, 'loghost': {'success': True}, 'default-rotate': {'success': True}, 'default-size': {'success': True}, 'default-timeout': {'success': True}, 'logdir-unique': {'success': True}}}, vsphere.reset_syslog_config(HOST, USER, PASSWORD, syslog_config='all')) # Tests for _reset_syslog_config_params function def test_reset_syslog_config_params_no_valid_reset(self): ''' Tests function returns False when an invalid syslog config is passed. ''' valid_resets = ['hello', 'world'] config = 'foo' ret = {'success': False, config: {'success': False, 'message': 'Invalid syslog configuration parameter'}} self.assertEqual(ret, vsphere._reset_syslog_config_params(HOST, USER, PASSWORD, 'cmd', config, valid_resets)) def test_reset_syslog_config_params_error(self): ''' Tests function returns False when the esxxli function returns an unsuccessful retcode. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): valid_resets = ['hello', 'world'] error_dict = {'success': False, 'message': ERROR} ret = {'success': False, 'hello': error_dict, 'world': error_dict} self.assertDictEqual(ret, vsphere._reset_syslog_config_params(HOST, USER, PASSWORD, 'cmd', valid_resets, valid_resets)) def test_reset_syslog_config_params_success(self): ''' Tests function returns True when the esxxli function returns a successful retcode. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0})): valid_resets = ['hello', 'world'] ret = {'success': True, 'hello': {'success': True}, 'world': {'success': True}} self.assertDictEqual(ret, vsphere._reset_syslog_config_params(HOST, USER, PASSWORD, 'cmd', valid_resets, valid_resets)) # Tests for _set_syslog_config_helper function def test_set_syslog_config_helper_no_valid_reset(self): ''' Tests function returns False when an invalid syslog config is passed. ''' config = 'foo' ret = {'success': False, 'message': '\'{0}\' is not a valid config variable.'.format(config)} self.assertEqual(ret, vsphere._set_syslog_config_helper(HOST, USER, PASSWORD, config, 'bar')) def test_set_syslog_config_helper_bad_retcode(self): ''' Tests function returns False when the esxcli function returns an unsuccessful retcode. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 1, 'stdout': ERROR})): config = 'default-rotate' self.assertEqual({config: {'success': False, 'message': ERROR}}, vsphere._set_syslog_config_helper(HOST, USER, PASSWORD, config, 'foo')) def test_set_syslog_config_helper_success(self): ''' Tests successful function return. ''' with patch('salt.utils.vmware.esxcli', MagicMock(return_value={'retcode': 0})): config = 'logdir' self.assertEqual({config: {'success': True}}, vsphere._set_syslog_config_helper(HOST, USER, PASSWORD, config, 'foo')) @skipIf(NO_MOCK, NO_MOCK_REASON) class GetProxyTypeTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.get_proxy_type''' def setup_loader_modules(self): return {vsphere: {'__virtual__': MagicMock(return_value='vsphere')}} def test_output(self): with patch.dict(vsphere.__pillar__, {'proxy': {'proxytype': 'fake_proxy_type'}}): ret = vsphere.get_proxy_type() self.assertEqual('fake_proxy_type', ret) @skipIf(NO_MOCK, NO_MOCK_REASON) class SupportsProxiesTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.supports_proxies decorator''' def setup_loader_modules(self): return {vsphere: {'__virtual__': MagicMock(return_value='vsphere')}} def test_supported_proxy(self): @vsphere.supports_proxies('supported') def mock_function(): return 'fake_function' with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='supported')): ret = mock_function() self.assertEqual('fake_function', ret) def test_unsupported_proxy(self): @vsphere.supports_proxies('supported') def mock_function(): return 'fake_function' with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='unsupported')): with self.assertRaises(CommandExecutionError) as excinfo: mock_function() self.assertEqual('\'unsupported\' proxy is not supported by ' 'function mock_function', excinfo.exception.strerror) @skipIf(NO_MOCK, NO_MOCK_REASON) class _GetProxyConnectionDetailsTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere._get_proxy_connection_details''' def setup_loader_modules(self): return {vsphere: {'__virtual__': MagicMock(return_value='vsphere')}} def setUp(self): self.esxi_host_details = {'host': 'fake_host', 'username': 'fake_username', 'password': 'fake_password', 'protocol': 'fake_protocol', 'port': 'fake_port', 'mechanism': 'fake_mechanism', 'principal': 'fake_principal', 'domain': 'fake_domain'} self.esxi_vcenter_details = {'vcenter': 'fake_vcenter', 'username': 'fake_username', 'password': 'fake_password', 'protocol': 'fake_protocol', 'port': 'fake_port', 'mechanism': 'fake_mechanism', 'principal': 'fake_principal', 'domain': 'fake_domain'} self.esxdatacenter_details = {'vcenter': 'fake_vcenter', 'username': 'fake_username', 'password': 'fake_password', 'protocol': 'fake_protocol', 'port': 'fake_port', 'mechanism': 'fake_mechanism', 'principal': 'fake_principal', 'domain': 'fake_domain'} def tearDown(self): for attrname in ('esxi_host_details', 'esxi_vcenter_details'): try: delattr(self, attrname) except AttributeError: continue def test_esxi_proxy_host_details(self): with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='esxi')): with patch.dict(vsphere.__salt__, {'esxi.get_details': MagicMock(return_value=self.esxi_host_details)}): ret = vsphere._get_proxy_connection_details() self.assertEqual(('fake_host', 'fake_username', 'fake_password', 'fake_protocol', 'fake_port', 'fake_mechanism', 'fake_principal', 'fake_domain'), ret) def test_esxdatacenter_proxy_details(self): with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='esxdatacenter')): with patch.dict(vsphere.__salt__, {'esxdatacenter.get_details': MagicMock( return_value=self.esxdatacenter_details)}): ret = vsphere._get_proxy_connection_details() def test_esxi_proxy_vcenter_details(self): with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='esxi')): with patch.dict(vsphere.__salt__, {'esxi.get_details': MagicMock( return_value=self.esxi_vcenter_details)}): ret = vsphere._get_proxy_connection_details() self.assertEqual(('fake_vcenter', 'fake_username', 'fake_password', 'fake_protocol', 'fake_port', 'fake_mechanism', 'fake_principal', 'fake_domain'), ret) def test_unsupported_proxy_details(self): with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value='unsupported')): with self.assertRaises(CommandExecutionError) as excinfo: ret = vsphere._get_proxy_connection_details() self.assertEqual('\'unsupported\' proxy is not supported', excinfo.exception.strerror) @skipIf(NO_MOCK, NO_MOCK_REASON) class GetsServiceInstanceViaProxyTestCase(TestCase, LoaderModuleMockMixin): ''' Tests for salt.modules.vsphere.gets_service_instance_via_proxy decorator ''' def setup_loader_modules(self): patcher = patch('salt.utils.vmware.get_service_instance', MagicMock()) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.disconnect', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), '_get_proxy_connection_details': MagicMock(), } } def setUp(self): self.mock_si = MagicMock() self.mock_details1 = MagicMock() self.mock_details2 = MagicMock() def tearDown(self): for attrname in ('mock_si', 'mock_details1', 'mock_details2'): try: delattr(self, attrname) except AttributeError: continue def test_no_service_instance_or_kwargs_parameters(self): @vsphere.gets_service_instance_via_proxy def mock_function(): return 'fake_function' with self.assertRaises(CommandExecutionError) as excinfo: mock_function() self.assertEqual('Function mock_function must have either a ' '\'service_instance\', or a \'**kwargs\' type ' 'parameter', excinfo.exception.strerror) def test___get_proxy_connection_details_call(self): mock__get_proxy_connection_details = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(service_instance=None): return service_instance with patch('salt.modules.vsphere._get_proxy_connection_details', mock__get_proxy_connection_details): mock_function() mock__get_proxy_connection_details.assert_called_once_with() def test_service_instance_named_parameter_no_value(self): mock_get_service_instance = MagicMock(return_value=self.mock_si) mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(service_instance=None): return service_instance with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function() mock_get_service_instance.assert_called_once_with(self.mock_details1, self.mock_details2) mock_disconnect.assert_called_once_with(self.mock_si) self.assertEqual(ret, self.mock_si) def test_service_instance_kwargs_parameter_no_value(self): mock_get_service_instance = MagicMock(return_value=self.mock_si) mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(**kwargs): return kwargs['service_instance'] with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function() mock_get_service_instance.assert_called_once_with(self.mock_details1, self.mock_details2) mock_disconnect.assert_called_once_with(self.mock_si) self.assertEqual(ret, self.mock_si) def test_service_instance_positional_parameter_no_default_value(self): mock_get_service_instance = MagicMock() mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(service_instance): return service_instance with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function(self.mock_si) self.assertEqual(mock_get_service_instance.call_count, 0) self.assertEqual(mock_disconnect.call_count, 0) self.assertEqual(ret, self.mock_si) def test_service_instance_positional_parameter_with_default_value(self): mock_get_service_instance = MagicMock() mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(service_instance=None): return service_instance with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function(self.mock_si) self.assertEqual(mock_get_service_instance.call_count, 0) self.assertEqual(mock_disconnect.call_count, 0) self.assertEqual(ret, self.mock_si) def test_service_instance_named_parameter_with_default_value(self): mock_get_service_instance = MagicMock() mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(service_instance=None): return service_instance with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function(service_instance=self.mock_si) self.assertEqual(mock_get_service_instance.call_count, 0) self.assertEqual(mock_disconnect.call_count, 0) self.assertEqual(ret, self.mock_si) def test_service_instance_kwargs_parameter_passthrough(self): mock_get_service_instance = MagicMock() mock_disconnect = MagicMock() @vsphere.gets_service_instance_via_proxy def mock_function(**kwargs): return kwargs['service_instance'] with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=(self.mock_details1, self.mock_details2))): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): with patch('salt.utils.vmware.disconnect', mock_disconnect): ret = mock_function(service_instance=self.mock_si) self.assertEqual(mock_get_service_instance.call_count, 0) self.assertEqual(mock_disconnect.call_count, 0) self.assertEqual(ret, self.mock_si) @skipIf(NO_MOCK, NO_MOCK_REASON) class GetServiceInstanceViaProxyTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.get_service_instance_via_proxy''' def setup_loader_modules(self): patcher = patch('salt.utils.vmware.get_service_instance', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), 'get_proxy_type': MagicMock(return_value='esxi'), '_get_proxy_connection_details': MagicMock() } } def test_supported_proxes(self): supported_proxies = ['esxi', 'esxdatacenter'] for proxy_type in supported_proxies: with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value=proxy_type)): vsphere.get_service_instance_via_proxy() def test_get_service_instance_call(self): mock_connection_details = [MagicMock(), MagicMock(), MagicMock()] mock_get_service_instance = MagicMock() with patch('salt.modules.vsphere._get_proxy_connection_details', MagicMock(return_value=mock_connection_details)): with patch('salt.utils.vmware.get_service_instance', mock_get_service_instance): vsphere.get_service_instance_via_proxy() mock_get_service_instance.assert_called_once_with( *mock_connection_details) def test_output(self): mock_si = MagicMock() with patch('salt.utils.vmware.get_service_instance', MagicMock(return_value=mock_si)): res = vsphere.get_service_instance_via_proxy() self.assertEqual(res, mock_si) @skipIf(NO_MOCK, NO_MOCK_REASON) class DisconnectTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.disconnect''' def setup_loader_modules(self): self.mock_si = MagicMock() self.addCleanup(delattr, self, 'mock_si') patcher = patch('salt.utils.vmware.disconnect', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), '_get_proxy_connection_details': MagicMock(), 'get_proxy_type': MagicMock(return_value='esxi') } } def test_supported_proxes(self): supported_proxies = ['esxi', 'esxdatacenter'] for proxy_type in supported_proxies: with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value=proxy_type)): vsphere.disconnect(self.mock_si) def test_disconnect_call(self): mock_disconnect = MagicMock() with patch('salt.utils.vmware.disconnect', mock_disconnect): vsphere.disconnect(self.mock_si) mock_disconnect.assert_called_once_with(self.mock_si) def test_output(self): res = vsphere.disconnect(self.mock_si) self.assertEqual(res, True) @skipIf(NO_MOCK, NO_MOCK_REASON) class TestVcenterConnectionTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.test_vcenter_connection''' def setup_loader_modules(self): self.mock_si = MagicMock() self.addCleanup(delattr, self, 'mock_si') patcher = patch('salt.utils.vmware.get_service_instance', MagicMock(return_value=self.mock_si)) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.disconnect', MagicMock()) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.is_connection_to_a_vcenter', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), '_get_proxy_connection_details': MagicMock(), 'get_proxy_type': MagicMock(return_value='esxi') } } def test_supported_proxes(self): supported_proxies = ['esxi', 'esxdatacenter'] for proxy_type in supported_proxies: with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value=proxy_type)): vsphere.test_vcenter_connection() def test_is_connection_to_a_vcenter_call_default_service_instance(self): mock_is_connection_to_a_vcenter = MagicMock() with patch('salt.utils.vmware.is_connection_to_a_vcenter', mock_is_connection_to_a_vcenter): vsphere.test_vcenter_connection() mock_is_connection_to_a_vcenter.assert_called_once_with(self.mock_si) def test_is_connection_to_a_vcenter_call_explicit_service_instance(self): expl_mock_si = MagicMock() mock_is_connection_to_a_vcenter = MagicMock() with patch('salt.utils.vmware.is_connection_to_a_vcenter', mock_is_connection_to_a_vcenter): vsphere.test_vcenter_connection(expl_mock_si) mock_is_connection_to_a_vcenter.assert_called_once_with(expl_mock_si) def test_is_connection_to_a_vcenter_raises_vmware_salt_error(self): exc = VMwareSaltError('VMwareSaltError') with patch('salt.utils.vmware.is_connection_to_a_vcenter', MagicMock(side_effect=exc)): res = vsphere.test_vcenter_connection() self.assertEqual(res, False) def test_is_connection_to_a_vcenter_raises_non_vmware_salt_error(self): exc = Exception('NonVMwareSaltError') with patch('salt.utils.vmware.is_connection_to_a_vcenter', MagicMock(side_effect=exc)): with self.assertRaises(Exception) as excinfo: res = vsphere.test_vcenter_connection() self.assertEqual('NonVMwareSaltError', str(excinfo.exception)) def test_output_true(self): with patch('salt.utils.vmware.is_connection_to_a_vcenter', MagicMock(return_value=True)): res = vsphere.test_vcenter_connection() self.assertEqual(res, True) def test_output_false(self): with patch('salt.utils.vmware.is_connection_to_a_vcenter', MagicMock(return_value=False)): res = vsphere.test_vcenter_connection() self.assertEqual(res, False) @skipIf(NO_MOCK, NO_MOCK_REASON) class ListDatacentersViaProxyTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.list_datacenters_via_proxy''' def setup_loader_modules(self): self.mock_si = MagicMock() self.addCleanup(delattr, self, 'mock_si') patcher = patch('salt.utils.vmware.get_service_instance', MagicMock(return_value=self.mock_si)) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.get_datacenters', MagicMock()) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.get_managed_object_name', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), '_get_proxy_connection_details': MagicMock(), 'get_proxy_type': MagicMock(return_value='esxdatacenter') } } def test_supported_proxies(self): supported_proxies = ['esxdatacenter'] for proxy_type in supported_proxies: with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value=proxy_type)): vsphere.list_datacenters_via_proxy() def test_default_params(self): mock_get_datacenters = MagicMock() with patch('salt.utils.vmware.get_datacenters', mock_get_datacenters): vsphere.list_datacenters_via_proxy() mock_get_datacenters.assert_called_once_with(self.mock_si, get_all_datacenters=True) def test_defined_service_instance(self): mock_si = MagicMock() mock_get_datacenters = MagicMock() with patch('salt.utils.vmware.get_datacenters', mock_get_datacenters): vsphere.list_datacenters_via_proxy(service_instance=mock_si) mock_get_datacenters.assert_called_once_with(mock_si, get_all_datacenters=True) def test_defined_datacenter_names(self): mock_datacenters = MagicMock() mock_get_datacenters = MagicMock() with patch('salt.utils.vmware.get_datacenters', mock_get_datacenters): vsphere.list_datacenters_via_proxy(mock_datacenters) mock_get_datacenters.assert_called_once_with(self.mock_si, mock_datacenters) def test_get_managed_object_name_calls(self): mock_get_managed_object_name = MagicMock() mock_dcs = [MagicMock(), MagicMock()] with patch('salt.utils.vmware.get_datacenters', MagicMock(return_value=mock_dcs)): with patch('salt.utils.vmware.get_managed_object_name', mock_get_managed_object_name): vsphere.list_datacenters_via_proxy() mock_get_managed_object_name.assert_has_calls([call(mock_dcs[0]), call(mock_dcs[1])]) def test_returned_array(self): with patch('salt.utils.vmware.get_datacenters', MagicMock(return_value=[MagicMock(), MagicMock()])): # 2 datacenters with patch('salt.utils.vmware.get_managed_object_name', MagicMock(side_effect=['fake_dc1', 'fake_dc2', 'fake_dc3'])): # 3 possible names res = vsphere.list_datacenters_via_proxy() # Just the first two names are in the result self.assertEqual(res, [{'name': 'fake_dc1'}, {'name': 'fake_dc2'}]) @skipIf(NO_MOCK, NO_MOCK_REASON) class CreateDatacenterTestCase(TestCase, LoaderModuleMockMixin): '''Tests for salt.modules.vsphere.create_datacenter''' def setup_loader_modules(self): self.mock_si = MagicMock() self.addCleanup(delattr, self, 'mock_si') patcher = patch('salt.utils.vmware.get_service_instance', MagicMock(return_value=self.mock_si)) patcher.start() self.addCleanup(patcher.stop) patcher = patch('salt.utils.vmware.create_datacenter', MagicMock()) patcher.start() self.addCleanup(patcher.stop) return { vsphere: { '__virtual__': MagicMock(return_value='vsphere'), '_get_proxy_connection_details': MagicMock(), 'get_proxy_type': MagicMock(return_value='esxdatacenter') } } def test_supported_proxes(self): supported_proxies = ['esxdatacenter'] for proxy_type in supported_proxies: with patch('salt.modules.vsphere.get_proxy_type', MagicMock(return_value=proxy_type)): vsphere.create_datacenter('fake_dc1') def test_default_service_instance(self): mock_create_datacenter = MagicMock() with patch('salt.utils.vmware.create_datacenter', mock_create_datacenter): vsphere.create_datacenter('fake_dc1') mock_create_datacenter.assert_called_once_with(self.mock_si, 'fake_dc1') def test_defined_service_instance(self): mock_si = MagicMock() mock_create_datacenter = MagicMock() with patch('salt.utils.vmware.create_datacenter', mock_create_datacenter): vsphere.create_datacenter('fake_dc1', service_instance=mock_si) mock_create_datacenter.assert_called_once_with(mock_si, 'fake_dc1') def test_returned_value(self): res = vsphere.create_datacenter('fake_dc1') self.assertEqual(res, {'create_datacenter': True})