# Copyright 2011 OpenStack Foundation # Copyright 2013 Rackspace Hosting # Copyright 2013 Hewlett-Packard Development Company, L.P. # 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 contextlib import os import mock import testtools from troveclient import base from troveclient import common from troveclient.openstack.common.apiclient import exceptions from troveclient import utils """ Unit tests for base.py """ UUID = '8e8ec658-c7b0-4243-bdf8-6f7f2952c0d0' def obj_class(self, res, loaded=True): return res class BaseTest(testtools.TestCase): def test_getid(self): obj = "test" r = base.getid(obj) self.assertEqual(obj, r) test_id = "test_id" obj = mock.Mock() obj.id = test_id r = base.getid(obj) self.assertEqual(test_id, r) class ManagerTest(testtools.TestCase): def setUp(self): super(ManagerTest, self).setUp() self.orig__init = base.Manager.__init__ base.Manager.__init__ = mock.Mock(return_value=None) self.orig_os_makedirs = os.makedirs def tearDown(self): super(ManagerTest, self).tearDown() base.Manager.__init__ = self.orig__init os.makedirs = self.orig_os_makedirs def test___init__(self): api = mock.Mock() base.Manager.__init__ = self.orig__init manager = base.Manager(api) self.assertEqual(api, manager.api) def test_completion_cache(self): manager = base.Manager() # handling exceptions mode = "w" cache_type = "unittest" obj_class = mock.Mock with manager.completion_cache(cache_type, obj_class, mode): pass os.makedirs = mock.Mock(side_effect=OSError) with manager.completion_cache(cache_type, obj_class, mode): pass def test_write_to_completion_cache(self): manager = base.Manager() # no cache object, nothing should happen manager.write_to_completion_cache("non-exist", "val") manager._mock_cache = mock.Mock() manager._mock_cache.write = mock.Mock(return_value=None) manager.write_to_completion_cache("mock", "val") self.assertEqual(1, manager._mock_cache.write.call_count) def _get_mock(self): manager = base.Manager() manager.api = mock.Mock() manager.api.client = mock.Mock() def side_effect_func(self, body, loaded=True): return body manager.resource_class = mock.Mock(side_effect=side_effect_func) return manager def test__get_with_response_key_none(self): manager = self._get_mock() url_ = "test-url" body_ = "test-body" resp_ = "test-resp" manager.api.client.get = mock.Mock(return_value=(resp_, body_)) r = manager._get(url=url_, response_key=None) self.assertEqual(body_, r) def test__get_with_response_key(self): manager = self._get_mock() response_key = "response_key" body_ = {response_key: "test-resp-key-body"} url_ = "test_url_get" manager.api.client.get = mock.Mock(return_value=(url_, body_)) r = manager._get(url=url_, response_key=response_key) self.assertEqual(body_[response_key], r) def test__create(self): manager = base.Manager() manager.api = mock.Mock() manager.api.client = mock.Mock() response_key = "response_key" data_ = "test-data" body_ = {response_key: data_} url_ = "test_url_post" manager.api.client.post = mock.Mock(return_value=(url_, body_)) return_raw = True r = manager._create(url_, body_, response_key, return_raw) self.assertEqual(data_, r) return_raw = False @contextlib.contextmanager def completion_cache_mock(*arg, **kwargs): yield mockl = mock.Mock() mockl.side_effect = completion_cache_mock manager.completion_cache = mockl manager.resource_class = mock.Mock(return_value="test-class") r = manager._create(url_, body_, response_key, return_raw) self.assertEqual("test-class", r) def get_mock_mng_api_client(self): manager = base.Manager() manager.api = mock.Mock() manager.api.client = mock.Mock() return manager def test__delete(self): resp_ = "test-resp" body_ = "test-body" manager = self.get_mock_mng_api_client() manager.api.client.delete = mock.Mock(return_value=(resp_, body_)) # _delete just calls api.client.delete, and does nothing # the correctness should be tested in api class manager._delete("test-url") pass def test__update(self): resp_ = "test-resp" body_ = "test-body" manager = self.get_mock_mng_api_client() manager.api.client.put = mock.Mock(return_value=(resp_, body_)) body = manager._update("test-url", body_) self.assertEqual(body_, body) class ManagerListTest(ManagerTest): def setUp(self): super(ManagerListTest, self).setUp() @contextlib.contextmanager def completion_cache_mock(*arg, **kwargs): yield self.manager = base.Manager() self.manager.api = mock.Mock() self.manager.api.client = mock.Mock() self.response_key = "response_key" self.data_p = ["p1", "p2"] self.body_p = {self.response_key: self.data_p} self.url_p = "test_url_post" self.manager.api.client.post = mock.Mock( return_value=(self.url_p, self.body_p) ) self.data_g = ["g1", "g2", "g3"] self.body_g = {self.response_key: self.data_g} self.url_g = "test_url_get" self.manager.api.client.get = mock.Mock( return_value=(self.url_g, self.body_g) ) mockl = mock.Mock() mockl.side_effect = completion_cache_mock self.manager.completion_cache = mockl def tearDown(self): super(ManagerListTest, self).tearDown() def test_list_with_body_none(self): body = None l = self.manager._list("url", self.response_key, obj_class, body) self.assertEqual(len(self.data_g), len(l)) for i in range(0, len(l)): self.assertEqual(self.data_g[i], l[i]) def test_list_body_not_none(self): body = "something" l = self.manager._list("url", self.response_key, obj_class, body) self.assertEqual(len(self.data_p), len(l)) for i in range(0, len(l)): self.assertEqual(self.data_p[i], l[i]) def test_list_key_mapping(self): data_ = {"values": ["p1", "p2"]} body_ = {self.response_key: data_} url_ = "test_url_post" self.manager.api.client.post = mock.Mock(return_value=(url_, body_)) l = self.manager._list("url", self.response_key, obj_class, "something") data = data_["values"] self.assertEqual(len(data), len(l)) for i in range(0, len(l)): self.assertEqual(data[i], l[i]) def test_list_without_key_mapping(self): data_ = {"v1": "1", "v2": "2"} body_ = {self.response_key: data_} url_ = "test_url_post" self.manager.api.client.post = mock.Mock(return_value=(url_, body_)) l = self.manager._list("url", self.response_key, obj_class, "something") self.assertEqual(len(data_), len(l)) class MangerPaginationTests(ManagerTest): def setUp(self): super(MangerPaginationTests, self).setUp() self.manager = base.Manager() self.manager.api = mock.Mock() self.manager.api.client = mock.Mock() self.manager.resource_class = base.Resource self.response_key = "response_key" self.data = [{"foo": "p1"}, {"foo": "p2"}] self.next_data = [{"foo": "p3"}, {"foo": "p4"}] self.marker = 'test-marker' self.limit = '20' self.url = "http://test_url" self.next_url = '%s?marker=%s&limit=%s' % (self.url, self.marker, self.limit) self.links = [{'href': self.next_url, 'rel': 'next'}] self.body = { self.response_key: self.data, 'links': self.links } self.next_body = {self.response_key: self.next_data} def side_effect(url): if url == self.url: return None, self.body # In python 3 the order in the dictionary is not constant # between runs. So we cant rely on the URL params to be # in the same order if ('marker=%s' % self.marker in url and 'limit=%s' % self.limit in url): self.next_url = url return None, self.next_body self.manager.api.client.get = mock.Mock(side_effect=side_effect) def tearDown(self): super(MangerPaginationTests, self).tearDown() def test_pagination(self): resp = self.manager._paginated(self.url, self.response_key) self.manager.api.client.get.assert_called_with(self.url) self.assertEqual('p1', resp[0].foo) self.assertEqual('p2', resp[1].foo) self.assertEqual(self.marker, resp.next) self.assertEqual(self.links, resp.links) self.assertIsInstance(resp, common.Paginated) def test_pagination_next(self): resp = self.manager._paginated(self.url, self.response_key, limit=self.limit, marker=self.marker) self.manager.api.client.get.assert_called_with(self.next_url) self.assertEqual('p3', resp[0].foo) self.assertEqual('p4', resp[1].foo) self.assertIsNone(resp.next) self.assertEqual([], resp.links) self.assertIsInstance(resp, common.Paginated) def test_pagination_error(self): self.manager.api.client.get = mock.Mock(return_value=(None, None)) self.assertRaises(Exception, self.manager._paginated, self.url, self.response_key) class FakeResource(object): def __init__(self, _id, properties): self.id = _id try: self.name = properties['name'] except KeyError: pass try: self.display_name = properties['display_name'] except KeyError: pass class FakeManager(base.ManagerWithFind): resource_class = FakeResource resources = [ FakeResource('1234', {'name': 'entity_one'}), FakeResource(UUID, {'name': 'entity_two'}), FakeResource('4242', {'display_name': 'entity_three'}), FakeResource('5678', {'name': '9876'}) ] def get(self, resource_id): for resource in self.resources: if resource.id == str(resource_id): return resource raise exceptions.NotFound(resource_id) def list(self): return self.resources class FindResourceTestCase(testtools.TestCase): def setUp(self): super(FindResourceTestCase, self).setUp() self.manager = FakeManager(None) def test_find_none(self): self.assertRaises(exceptions.CommandError, utils.find_resource, self.manager, 'asdf') def test_find_by_integer_id(self): output = utils.find_resource(self.manager, 1234) self.assertEqual(self.manager.get('1234'), output) def test_find_by_str_id(self): output = utils.find_resource(self.manager, '1234') self.assertEqual(self.manager.get('1234'), output) def test_find_by_uuid(self): output = utils.find_resource(self.manager, UUID) self.assertEqual(self.manager.get(UUID), output) def test_find_by_str_name(self): output = utils.find_resource(self.manager, 'entity_one') self.assertEqual(self.manager.get('1234'), output) def test_find_by_str_displayname(self): output = utils.find_resource(self.manager, 'entity_three') self.assertEqual(self.manager.get('4242'), output) class ResourceTest(testtools.TestCase): def setUp(self): super(ResourceTest, self).setUp() self.orig___init__ = base.Resource.__init__ def tearDown(self): super(ResourceTest, self).tearDown() base.Resource.__init__ = self.orig___init__ def test___init__(self): manager = mock.Mock() manager.write_to_completion_cache = mock.Mock(return_value=None) info_ = {} robj = base.Resource(manager, info_) self.assertEqual(0, manager.write_to_completion_cache.call_count) info_ = {"id": "id-with-less-than-36-char"} robj = base.Resource(manager, info_) self.assertEqual(info_["id"], robj.id) self.assertEqual(0, manager.write_to_completion_cache.call_count) id_ = "id-with-36-char-" for i in range(36 - len(id_)): id_ = id_ + "-" info_ = {"id": id_} robj = base.Resource(manager, info_) self.assertEqual(info_["id"], robj.id) self.assertEqual(1, manager.write_to_completion_cache.call_count) info_["name"] = "test-human-id" # Resource.HUMAN_ID is False robj = base.Resource(manager, info_) self.assertEqual(info_["id"], robj.id) self.assertIsNone(robj.human_id) self.assertEqual(2, manager.write_to_completion_cache.call_count) # base.Resource.HUMAN_ID = True info_["HUMAN_ID"] = True robj = base.Resource(manager, info_) self.assertEqual(info_["id"], robj.id) self.assertEqual(info_["name"], robj.human_id) self.assertEqual(4, manager.write_to_completion_cache.call_count) def test_human_id(self): manager = mock.Mock() manager.write_to_completion_cache = mock.Mock(return_value=None) info_ = {"name": "test-human-id"} robj = base.Resource(manager, info_) self.assertIsNone(robj.human_id) info_["HUMAN_ID"] = True robj = base.Resource(manager, info_) self.assertEqual(info_["name"], robj.human_id) robj.name = "new-human-id" self.assertEqual("new-human-id", robj.human_id) def get_mock_resource_obj(self): base.Resource.__init__ = mock.Mock(return_value=None) robj = base.Resource() robj._loaded = False return robj def test__add_details(self): robj = self.get_mock_resource_obj() info_ = {"name": "test-human-id", "test_attr": 5} robj._add_details(info_) self.assertEqual(info_["name"], robj.name) self.assertEqual(info_["test_attr"], robj.test_attr) def test___getattr__(self): robj = self.get_mock_resource_obj() info_ = {"name": "test-human-id", "test_attr": 5} robj._add_details(info_) self.assertEqual(info_["test_attr"], robj.__getattr__("test_attr")) # TODO(dmakogon): looks like causing infinite recursive calls # robj.__getattr__("test_non_exist_attr") def test___repr__(self): robj = self.get_mock_resource_obj() info_ = {"name": "test-human-id", "test_attr": 5} robj._add_details(info_) expected = "" self.assertEqual(expected, robj.__repr__()) def test_get(self): robj = self.get_mock_resource_obj() manager = mock.Mock() manager.get = None robj.manager = object() robj._get() manager = mock.Mock() robj.manager = mock.Mock() robj.id = "id" new = mock.Mock() new._info = {"name": "test-human-id", "test_attr": 5} robj.manager.get = mock.Mock(return_value=new) robj._get() self.assertEqual("test-human-id", robj.name) self.assertEqual(5, robj.test_attr) def test___eq__(self): robj = self.get_mock_resource_obj() other = base.Resource() info_ = {"name": "test-human-id", "test_attr": 5} robj._info = info_ other._info = {} self.assertFalse(robj.__eq__(other)) robj.id = "rid" other.id = "oid" self.assertFalse(robj.__eq__(other)) other.id = "rid" self.assertTrue(robj.__eq__(other)) # not instance of the same class other = mock.Mock() self.assertEqual(robj.__eq__(other), NotImplemented) def test_is_loaded(self): robj = self.get_mock_resource_obj() robj._loaded = True self.assertTrue(robj.is_loaded) robj._loaded = False self.assertFalse(robj.is_loaded)