libervia-backend/src/test/test_memory.py

287 lines
12 KiB
Python

#!/usr/bin/env python2
# -*- coding: utf-8 -*-
# SAT: a jabber client
# Copyright (C) 2009-2016 Jérôme Poisson (goffi@goffi.org)
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
from sat.core.i18n import _
from sat.test import helpers
from twisted.trial import unittest
import traceback
from constants import Const
from xml.dom import minidom
class MemoryTest(unittest.TestCase):
def setUp(self):
self.host = helpers.FakeSAT()
def _getParamXML(self, param="1", security_level=None):
"""Generate XML for testing parameters
@param param (str): a subset of "123"
@param security_level: security level of the parameters
@return (str)
"""
def getParam(name):
return """
<param name="%(param_name)s" label="%(param_label)s" value="true" type="bool" %(security)s/>
""" % {'param_name': name,
'param_label': _(name),
'security': '' if security_level is None else ('security="%d"' % security_level)
}
params = ''
if "1" in param:
params += getParam(Const.ENABLE_UNIBOX_PARAM)
if "2" in param:
params += getParam(Const.PARAM_IN_QUOTES)
if "3" in param:
params += getParam("Dummy param")
return """
<params>
<individual>
<category name="%(category_name)s" label="%(category_label)s">
%(params)s
</category>
</individual>
</params>
""" % {
'category_name': Const.COMPOSITION_KEY,
'category_label': _(Const.COMPOSITION_KEY),
'params': params
}
def _paramExists(self, param="1", src=None):
"""
@param param (str): a character in "12"
@param src (DOM element): the top-level element to look in
@return: True is the param exists
"""
if param == "1":
name = Const.ENABLE_UNIBOX_PARAM
else:
name = Const.PARAM_IN_QUOTES
category = Const.COMPOSITION_KEY
if src is None:
src = self.host.memory.params.dom.documentElement
for type_node in src.childNodes:
# when src comes self.host.memory.params.dom, we have here
# some "individual" or "general" elements, when it comes
# from Memory.getParams we have here a "params" elements
if type_node.nodeName not in ("individual", "general", "params"):
continue
for cat_node in type_node.childNodes:
if cat_node.nodeName != "category" or cat_node.getAttribute("name") != category:
continue
for param in cat_node.childNodes:
if param.nodeName == "param" and param.getAttribute("name") == name:
return True
return False
def assertParam_generic(self, param="1", src=None, exists=True, deferred=False):
"""
@param param (str): a character in "12"
@param src (DOM element): the top-level element to look in
@param exists (boolean): True to assert the param exists, False to assert it doesn't
@param deferred (boolean): True if this method is called from a Deferred callback
"""
msg = "Expected parameter not found!\n" if exists else "Unexpected parameter found!\n"
if deferred:
# in this stack we can see the line where the error came from,
# if limit=5, 6 is not enough you can increase the value
msg += "\n".join(traceback.format_stack(limit=5 if exists else 6))
assertion = self._paramExists(param, src)
getattr(self, "assert%s" % exists)(assertion, msg)
def assertParamExists(self, param="1", src=None):
self.assertParam_generic(param, src, True)
def assertParamNotExists(self, param="1", src=None):
self.assertParam_generic(param, src, False)
def assertParamExists_async(self, src, param="1"):
"""@param src: a deferred result from Memory.getParams"""
self.assertParam_generic(param, minidom.parseString(src.encode("utf-8")), True, True)
def assertParamNotExists_async(self, src, param="1"):
"""@param src: a deferred result from Memory.getParams"""
self.assertParam_generic(param, minidom.parseString(src.encode("utf-8")), False, True)
def _getParams(self, security_limit, app='', profile_key='@NONE@'):
"""Get the parameters accessible with the given security limit and application name.
@param security_limit (int): the security limit
@param app (str): empty string or "libervia"
@param profile_key
"""
if profile_key == '@NONE@':
profile_key = '@DEFAULT@'
return self.host.memory.params.getParams(security_limit, app, profile_key)
def test_updateParams(self):
self.host.memory.reinit()
# check if the update works
self.host.memory.updateParams(self._getParamXML())
self.assertParamExists()
previous = self.host.memory.params.dom.cloneNode(True)
# now check if it is really updated and not duplicated
self.host.memory.updateParams(self._getParamXML())
self.assertEqual(previous.toxml().encode("utf-8"), self.host.memory.params.dom.toxml().encode("utf-8"))
self.host.memory.reinit()
# check successive updates (without intersection)
self.host.memory.updateParams(self._getParamXML('1'))
self.assertParamExists("1")
self.assertParamNotExists("2")
self.host.memory.updateParams(self._getParamXML('2'))
self.assertParamExists("1")
self.assertParamExists("2")
previous = self.host.memory.params.dom.cloneNode(True) # save for later
self.host.memory.reinit()
# check successive updates (with intersection)
self.host.memory.updateParams(self._getParamXML('1'))
self.assertParamExists("1")
self.assertParamNotExists("2")
self.host.memory.updateParams(self._getParamXML('12'))
self.assertParamExists("1")
self.assertParamExists("2")
# successive updates with or without intersection should have the same result
self.assertEqual(previous.toxml().encode("utf-8"), self.host.memory.params.dom.toxml().encode("utf-8"))
self.host.memory.reinit()
# one update with two params in a new category
self.host.memory.updateParams(self._getParamXML('12'))
self.assertParamExists("1")
self.assertParamExists("2")
def test_getParams(self):
# tests with no security level on the parameter (most secure)
params = self._getParamXML()
self.host.memory.reinit()
self.host.memory.updateParams(params)
self._getParams(Const.NO_SECURITY_LIMIT).addCallback(self.assertParamExists_async)
self._getParams(0).addCallback(self.assertParamNotExists_async)
self._getParams(1).addCallback(self.assertParamNotExists_async)
# tests with security level 0 on the parameter (not secure)
params = self._getParamXML(security_level=0)
self.host.memory.reinit()
self.host.memory.updateParams(params)
self._getParams(Const.NO_SECURITY_LIMIT).addCallback(self.assertParamExists_async)
self._getParams(0).addCallback(self.assertParamExists_async)
self._getParams(1).addCallback(self.assertParamExists_async)
# tests with security level 1 on the parameter (more secure)
params = self._getParamXML(security_level=1)
self.host.memory.reinit()
self.host.memory.updateParams(params)
self._getParams(Const.NO_SECURITY_LIMIT).addCallback(self.assertParamExists_async)
self._getParams(0).addCallback(self.assertParamNotExists_async)
return self._getParams(1).addCallback(self.assertParamExists_async)
def test_paramsRegisterApp(self):
def register(xml, security_limit, app):
"""
@param xml: XML definition of the parameters to be added
@param security_limit: -1 means no security, 0 is the maximum security then the higher the less secure
@param app: name of the frontend registering the parameters
"""
helpers.muteLogging()
self.host.memory.paramsRegisterApp(xml, security_limit, app)
helpers.unmuteLogging()
# tests with no security level on the parameter (most secure)
params = self._getParamXML()
self.host.memory.reinit()
register(params, Const.NO_SECURITY_LIMIT, Const.APP_NAME)
self.assertParamExists()
self.host.memory.reinit()
register(params, 0, Const.APP_NAME)
self.assertParamNotExists()
self.host.memory.reinit()
register(params, 1, Const.APP_NAME)
self.assertParamNotExists()
# tests with security level 0 on the parameter (not secure)
params = self._getParamXML(security_level=0)
self.host.memory.reinit()
register(params, Const.NO_SECURITY_LIMIT, Const.APP_NAME)
self.assertParamExists()
self.host.memory.reinit()
register(params, 0, Const.APP_NAME)
self.assertParamExists()
self.host.memory.reinit()
register(params, 1, Const.APP_NAME)
self.assertParamExists()
# tests with security level 1 on the parameter (more secure)
params = self._getParamXML(security_level=1)
self.host.memory.reinit()
register(params, Const.NO_SECURITY_LIMIT, Const.APP_NAME)
self.assertParamExists()
self.host.memory.reinit()
register(params, 0, Const.APP_NAME)
self.assertParamNotExists()
self.host.memory.reinit()
register(params, 1, Const.APP_NAME)
self.assertParamExists()
# tests with security level 1 and several parameters being registered
params = self._getParamXML("12", security_level=1)
self.host.memory.reinit()
register(params, Const.NO_SECURITY_LIMIT, Const.APP_NAME)
self.assertParamExists()
self.assertParamExists("2")
self.host.memory.reinit()
register(params, 0, Const.APP_NAME)
self.assertParamNotExists()
self.assertParamNotExists("2")
self.host.memory.reinit()
register(params, 1, Const.APP_NAME)
self.assertParamExists()
self.assertParamExists("2")
# tests with several parameters being registered in an existing category
self.host.memory.reinit()
self.host.memory.updateParams(self._getParamXML("3"))
register(self._getParamXML("12"), Const.NO_SECURITY_LIMIT, Const.APP_NAME)
self.assertParamExists()
self.assertParamExists("2")
self.host.memory.reinit()
def test_paramsRegisterApp_getParams(self):
# test retrieving the parameter for a specific frontend
self.host.memory.reinit()
params = self._getParamXML(security_level=1)
self.host.memory.paramsRegisterApp(params, 1, Const.APP_NAME)
self._getParams(1, '').addCallback(self.assertParamExists_async)
self._getParams(1, Const.APP_NAME).addCallback(self.assertParamExists_async)
self._getParams(1, 'another_dummy_frontend').addCallback(self.assertParamNotExists_async)
# the same with several parameters registered at the same time
self.host.memory.reinit()
params = self._getParamXML('12', security_level=0)
self.host.memory.paramsRegisterApp(params, 5, Const.APP_NAME)
self._getParams(5, '').addCallback(self.assertParamExists_async)
self._getParams(5, '').addCallback(self.assertParamExists_async, "2")
self._getParams(5, Const.APP_NAME).addCallback(self.assertParamExists_async)
self._getParams(5, Const.APP_NAME).addCallback(self.assertParamExists_async, "2")
self._getParams(5, 'another_dummy_frontend').addCallback(self.assertParamNotExists_async)
return self._getParams(5, 'another_dummy_frontend').addCallback(self.assertParamNotExists_async, "2")