import pkg_resources from testtools.content import text_content import testscenarios from jenkins_jobs.config import JJBConfig from jenkins_jobs.registry import ModuleRegistry from tests import base class ModuleRegistryPluginInfoTestsWithScenarios( testscenarios.TestWithScenarios, base.BaseTestCase): scenarios = [ ('s1', dict(v1='1.0.0', op='__gt__', v2='0.8.0')), ('s2', dict(v1='1.0.1alpha', op='__gt__', v2='1.0.0')), ('s3', dict(v1='1.0', op='__eq__', v2='1.0.0')), ('s4', dict(v1='1.0', op='__eq__', v2='1.0')), ('s5', dict(v1='1.0', op='__lt__', v2='1.8.0')), ('s6', dict(v1='1.0.1alpha', op='__lt__', v2='1.0.1')), ('s7', dict(v1='1.0alpha', op='__lt__', v2='1.0.0')), ('s8', dict(v1='1.0-alpha', op='__lt__', v2='1.0.0')), ('s9', dict(v1='1.1-alpha', op='__gt__', v2='1.0')), ('s10', dict(v1='1.0-SNAPSHOT', op='__lt__', v2='1.0')), ('s11', dict(v1='1.0.preview', op='__lt__', v2='1.0')), ('s12', dict(v1='1.1-SNAPSHOT', op='__gt__', v2='1.0')), ('s13', dict(v1='1.0a-SNAPSHOT', op='__lt__', v2='1.0a')), ('s14', dict(v1='1.4.6-SNAPSHOT (private-0986edd9-example)', op='__lt__', v2='1.4.6')), ('s15', dict(v1='1.4.6-SNAPSHOT (private-0986edd9-example)', op='__gt__', v2='1.4.5')), ] def setUp(self): super(ModuleRegistryPluginInfoTestsWithScenarios, self).setUp() jjb_config = JJBConfig() jjb_config.validate() plugin_info = [{'shortName': "HerpDerpPlugin", 'longName': "Blah Blah Blah Plugin" }] plugin_info.append({'shortName': "JankyPlugin1", 'longName': "Not A Real Plugin", 'version': self.v1 }) self.addDetail("plugin_info", text_content(str(plugin_info))) self.registry = ModuleRegistry(jjb_config, plugin_info) def tearDown(self): super(ModuleRegistryPluginInfoTestsWithScenarios, self).tearDown() def test_get_plugin_info_dict(self): """ The goal of this test is to validate that the plugin_info returned by ModuleRegistry.get_plugin_info is a dictionary whose key 'shortName' is the same value as the string argument passed to ModuleRegistry.get_plugin_info. """ plugin_name = "JankyPlugin1" plugin_info = self.registry.get_plugin_info(plugin_name) self.assertIsInstance(plugin_info, dict) self.assertEqual(plugin_info['shortName'], plugin_name) def test_get_plugin_info_dict_using_longName(self): """ The goal of this test is to validate that the plugin_info returned by ModuleRegistry.get_plugin_info is a dictionary whose key 'longName' is the same value as the string argument passed to ModuleRegistry.get_plugin_info. """ plugin_name = "Blah Blah Blah Plugin" plugin_info = self.registry.get_plugin_info(plugin_name) self.assertIsInstance(plugin_info, dict) self.assertEqual(plugin_info['longName'], plugin_name) def test_get_plugin_info_dict_no_plugin(self): """ The goal of this test case is to validate the behavior of ModuleRegistry.get_plugin_info when the given plugin cannot be found in ModuleRegistry's internal representation of the plugins_info. """ plugin_name = "PluginDoesNotExist" plugin_info = self.registry.get_plugin_info(plugin_name) self.assertIsInstance(plugin_info, dict) self.assertEqual(plugin_info, {}) def test_get_plugin_info_dict_no_version(self): """ The goal of this test case is to validate the behavior of ModuleRegistry.get_plugin_info when the given plugin shortName returns plugin_info dict that has no version string. In a sane world where plugin frameworks like Jenkins' are sane this should never happen, but I am including this test and the corresponding default behavior because, well, it's Jenkins. """ plugin_name = "HerpDerpPlugin" plugin_info = self.registry.get_plugin_info(plugin_name) self.assertIsInstance(plugin_info, dict) self.assertEqual(plugin_info['shortName'], plugin_name) self.assertEqual(plugin_info['version'], '0') def test_plugin_version_comparison(self): """ The goal of this test case is to validate that valid tuple versions are ordinally correct. That is, for each given scenario, v1.op(v2)==True where 'op' is the equality operator defined for the scenario. """ plugin_name = "JankyPlugin1" plugin_info = self.registry.get_plugin_info(plugin_name) v1 = plugin_info.get("version") op = getattr(pkg_resources.parse_version(v1), self.op) test = op(pkg_resources.parse_version(self.v2)) self.assertTrue(test, msg="Unexpectedly found {0} {2} {1} == False " "when comparing versions!" .format(v1, self.v2, self.op))