# Copyright 2016 Mirantis
# All Rights Reserved.
#
# 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.
import mock
from watcherclient.common import api_versioning
from watcherclient import exceptions
from watcherclient.tests.unit import utils
[docs]class APIVersionTestCase(utils.BaseTestCase):
[docs] def test_valid_version_strings(self):
def _test_string(version, exp_major, exp_minor):
v = api_versioning.APIVersion(version)
self.assertEqual(v.ver_major, exp_major)
self.assertEqual(v.ver_minor, exp_minor)
_test_string("1.1", 1, 1)
_test_string("2.10", 2, 10)
_test_string("5.234", 5, 234)
_test_string("12.5", 12, 5)
_test_string("2.0", 2, 0)
_test_string("2.200", 2, 200)
[docs] def test_null_version(self):
v = api_versioning.APIVersion()
self.assertTrue(v.is_null())
[docs] def test_invalid_version_strings(self):
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "2")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "200")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "2.1.4")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "200.23.66.3")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "5 .3")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "5. 3")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "5.03")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "02.1")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "2.001")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, " 2.1")
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.APIVersion, "2.1 ")
[docs] def test_version_comparisons(self):
v1 = api_versioning.APIVersion("2.0")
v2 = api_versioning.APIVersion("2.5")
v3 = api_versioning.APIVersion("5.23")
v4 = api_versioning.APIVersion("2.0")
v_null = api_versioning.APIVersion()
self.assertLess(v1, v2)
self.assertGreater(v3, v2)
self.assertNotEqual(v1, v2)
self.assertEqual(v1, v4)
self.assertNotEqual(v1, v_null)
self.assertEqual(v_null, v_null)
self.assertRaises(TypeError, v1.__le__, "2.1")
[docs] def test_version_matches(self):
v1 = api_versioning.APIVersion("2.0")
v2 = api_versioning.APIVersion("2.5")
v3 = api_versioning.APIVersion("2.45")
v4 = api_versioning.APIVersion("3.3")
v5 = api_versioning.APIVersion("3.23")
v6 = api_versioning.APIVersion("2.0")
v7 = api_versioning.APIVersion("3.3")
v8 = api_versioning.APIVersion("4.0")
v_null = api_versioning.APIVersion()
self.assertTrue(v2.matches(v1, v3))
self.assertTrue(v2.matches(v1, v_null))
self.assertTrue(v1.matches(v6, v2))
self.assertTrue(v4.matches(v2, v7))
self.assertTrue(v4.matches(v_null, v7))
self.assertTrue(v4.matches(v_null, v8))
self.assertFalse(v1.matches(v2, v3))
self.assertFalse(v5.matches(v2, v4))
self.assertFalse(v2.matches(v3, v1))
self.assertRaises(ValueError, v_null.matches, v1, v3)
[docs] def test_get_string(self):
v1_string = "3.23"
v1 = api_versioning.APIVersion(v1_string)
self.assertEqual(v1_string, v1.get_string())
self.assertRaises(ValueError,
api_versioning.APIVersion().get_string)
[docs]class GetAPIVersionTestCase(utils.BaseTestCase):
[docs] def test_get_available_client_versions(self):
output = api_versioning.get_available_major_versions()
self.assertNotEqual([], output)
[docs] def test_wrong_major_version(self):
self.assertRaises(exceptions.UnsupportedVersion,
api_versioning.get_api_version, "2")
[docs] @mock.patch("watcherclient.common.api_versioning.APIVersion")
def test_only_major_part_is_presented(self, mock_apiversion):
version = 7
self.assertEqual(mock_apiversion.return_value,
api_versioning.get_api_version(version))
mock_apiversion.assert_called_once_with("%s.0" % str(version))
[docs] @mock.patch("watcherclient.common.api_versioning.APIVersion")
def test_major_and_minor_parts_is_presented(self, mock_apiversion):
version = "2.7"
self.assertEqual(mock_apiversion.return_value,
api_versioning.get_api_version(version))
mock_apiversion.assert_called_once_with(version)