python-troveclient/troveclient/tests/test_base.py

513 lines
17 KiB
Python

# 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.items[0].foo)
self.assertEqual('p2', resp.items[1].foo)
self.assertEqual(self.marker, resp.next)
self.assertEqual(self.links, resp.links)
self.assertTrue(isinstance(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.items[0].foo)
self.assertEqual('p4', resp.items[1].foo)
self.assertIsNone(resp.next)
self.assertEqual([], resp.links)
self.assertTrue(isinstance(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 = "<Resource name=test-human-id, test_attr=5>"
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)