2012-11-19 10:45:03 +01:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
"sets the options of the configuration objects Config object itself"
|
2013-03-01 13:10:52 +01:00
|
|
|
# Copyright (C) 2012-2013 Team tiramisu (see AUTHORS for all contributors)
|
2012-11-19 10:45:03 +01:00
|
|
|
#
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation; either version 2 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 General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
#
|
|
|
|
# The original `Config` design model is unproudly borrowed from
|
|
|
|
# the rough pypy's guys: http://codespeak.net/svn/pypy/dist/pypy/config/
|
|
|
|
# the whole pypy projet is under MIT licence
|
|
|
|
# ____________________________________________________________
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-04-14 12:01:32 +02:00
|
|
|
from tiramisu.error import RequirementRecursionError, PropertiesOptionError
|
|
|
|
from tiramisu.i18n import _
|
2013-04-08 16:05:56 +02:00
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-06 18:14:57 +01:00
|
|
|
class _const:
|
|
|
|
"""convenient class that emulates a module
|
2012-12-10 09:53:13 +01:00
|
|
|
and builds constants (that is, unique names)"""
|
2013-04-03 12:20:26 +02:00
|
|
|
class ConstError(TypeError):
|
|
|
|
pass
|
2012-12-06 18:14:57 +01:00
|
|
|
|
|
|
|
def __setattr__(self, name, value):
|
2013-04-03 12:20:26 +02:00
|
|
|
if name in self.__dict__:
|
2013-04-14 12:01:32 +02:00
|
|
|
raise self.ConstError, _("Can't rebind group ({})").format(name)
|
2012-12-06 18:14:57 +01:00
|
|
|
self.__dict__[name] = value
|
|
|
|
|
|
|
|
def __delattr__(self, name):
|
2013-04-03 12:20:26 +02:00
|
|
|
if name in self.__dict__:
|
2013-04-14 12:01:32 +02:00
|
|
|
raise self.ConstError, _("Can't unbind group ({})").format(name)
|
|
|
|
raise ValueError(name)
|
2013-04-03 12:20:26 +02:00
|
|
|
|
|
|
|
|
2012-12-10 09:53:13 +01:00
|
|
|
# ____________________________________________________________
|
|
|
|
class GroupModule(_const):
|
|
|
|
"emulates a module to manage unique group (OptionDescription) names"
|
2012-12-10 14:38:25 +01:00
|
|
|
class GroupType(str):
|
2012-12-06 18:14:57 +01:00
|
|
|
"""allowed normal group (OptionDescription) names
|
|
|
|
*normal* means : groups that are not master
|
|
|
|
"""
|
|
|
|
pass
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-10 14:38:25 +01:00
|
|
|
class DefaultGroupType(GroupType):
|
2012-12-10 14:10:05 +01:00
|
|
|
"""groups that are default (typically 'default')"""
|
|
|
|
pass
|
|
|
|
|
2012-12-10 14:38:25 +01:00
|
|
|
class MasterGroupType(GroupType):
|
2012-12-06 18:14:57 +01:00
|
|
|
"""allowed normal group (OptionDescription) names
|
|
|
|
*master* means : groups that have the 'master' attribute set
|
|
|
|
"""
|
|
|
|
pass
|
2012-12-10 09:53:13 +01:00
|
|
|
# setting.groups (emulates a module)
|
|
|
|
groups = GroupModule()
|
2012-12-06 18:14:57 +01:00
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-10 09:53:13 +01:00
|
|
|
def populate_groups():
|
|
|
|
"populates the available groups in the appropriate namespaces"
|
2013-02-06 16:21:30 +01:00
|
|
|
groups.master = groups.MasterGroupType('master')
|
|
|
|
groups.default = groups.DefaultGroupType('default')
|
|
|
|
groups.family = groups.GroupType('family')
|
|
|
|
|
2012-12-10 09:53:13 +01:00
|
|
|
# names are in the module now
|
2012-12-06 18:14:57 +01:00
|
|
|
populate_groups()
|
2013-04-03 12:20:26 +02:00
|
|
|
|
|
|
|
|
2012-12-06 18:14:57 +01:00
|
|
|
# ____________________________________________________________
|
2012-12-10 14:10:05 +01:00
|
|
|
class OwnerModule(_const):
|
|
|
|
"""emulates a module to manage unique owner names.
|
|
|
|
|
|
|
|
owners are living in `Config._cfgimpl_value_owners`
|
|
|
|
"""
|
|
|
|
class Owner(str):
|
|
|
|
"""allowed owner names
|
|
|
|
"""
|
|
|
|
pass
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-10 14:10:05 +01:00
|
|
|
class DefaultOwner(Owner):
|
|
|
|
"""groups that are default (typically 'default')"""
|
|
|
|
pass
|
|
|
|
# setting.owners (emulates a module)
|
|
|
|
owners = OwnerModule()
|
2012-12-04 12:06:26 +01:00
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-10 14:10:05 +01:00
|
|
|
def populate_owners():
|
|
|
|
"""populates the available owners in the appropriate namespaces
|
|
|
|
|
|
|
|
- 'user' is the generic is the generic owner.
|
|
|
|
- 'default' is the config owner after init time
|
|
|
|
"""
|
|
|
|
setattr(owners, 'default', owners.DefaultOwner('default'))
|
2013-04-03 12:20:26 +02:00
|
|
|
setattr(owners, 'user', owners.Owner('user'))
|
|
|
|
|
2012-12-10 14:38:25 +01:00
|
|
|
def add_owner(name):
|
|
|
|
"""
|
|
|
|
:param name: the name of the new owner
|
|
|
|
"""
|
|
|
|
setattr(owners, name, owners.Owner(name))
|
|
|
|
setattr(owners, 'add_owner', add_owner)
|
|
|
|
|
2012-12-10 14:10:05 +01:00
|
|
|
# names are in the module now
|
|
|
|
populate_owners()
|
2013-02-21 17:07:00 +01:00
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-21 17:07:00 +01:00
|
|
|
class MultiTypeModule(_const):
|
|
|
|
class MultiType(str):
|
|
|
|
pass
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-21 17:07:00 +01:00
|
|
|
class DefaultMultiType(MultiType):
|
|
|
|
pass
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-21 17:07:00 +01:00
|
|
|
class MasterMultiType(MultiType):
|
|
|
|
pass
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-21 17:07:00 +01:00
|
|
|
class SlaveMultiType(MultiType):
|
|
|
|
pass
|
|
|
|
|
|
|
|
multitypes = MultiTypeModule()
|
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-21 17:07:00 +01:00
|
|
|
def populate_multitypes():
|
|
|
|
setattr(multitypes, 'default', multitypes.DefaultMultiType('default'))
|
|
|
|
setattr(multitypes, 'master', multitypes.MasterMultiType('master'))
|
|
|
|
setattr(multitypes, 'slave', multitypes.SlaveMultiType('slave'))
|
|
|
|
|
|
|
|
populate_multitypes()
|
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-10 14:10:05 +01:00
|
|
|
#____________________________________________________________
|
2013-04-03 12:20:26 +02:00
|
|
|
class Setting(object):
|
2012-11-19 10:45:03 +01:00
|
|
|
"``Config()``'s configuration options"
|
2013-04-08 16:05:56 +02:00
|
|
|
__slots__ = ('properties', 'permissives', 'owner', 'context')
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-04-08 16:05:56 +02:00
|
|
|
def __init__(self, context):
|
2013-04-03 12:20:26 +02:00
|
|
|
# properties attribute: the name of a property enables this property
|
|
|
|
# key is None for global properties
|
|
|
|
self.properties = {None: []} # ['hidden', 'disabled', 'mandatory', 'frozen', 'validator']}
|
|
|
|
# permissive properties
|
|
|
|
self.permissives = {}
|
|
|
|
# generic owner
|
|
|
|
self.owner = owners.user
|
2013-04-08 16:05:56 +02:00
|
|
|
self.context = context
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2012-12-11 11:18:53 +01:00
|
|
|
#____________________________________________________________
|
2012-11-19 10:45:03 +01:00
|
|
|
# properties methods
|
2013-04-08 16:05:56 +02:00
|
|
|
def has_properties(self, opt=None, is_apply_req=True):
|
2012-11-19 10:45:03 +01:00
|
|
|
"has properties means the Config's properties attribute is not empty"
|
2013-04-08 16:05:56 +02:00
|
|
|
return bool(len(self.get_properties(opt, is_apply_req)))
|
2013-03-14 11:31:44 +01:00
|
|
|
|
2013-04-08 16:05:56 +02:00
|
|
|
def get_properties(self, opt=None, is_apply_req=True):
|
2013-04-03 12:20:26 +02:00
|
|
|
if opt is None:
|
|
|
|
default = []
|
|
|
|
else:
|
2013-04-08 16:05:56 +02:00
|
|
|
if is_apply_req:
|
|
|
|
apply_requires(opt, self.context)
|
2013-04-03 12:20:26 +02:00
|
|
|
default = list(opt._properties)
|
|
|
|
return self.properties.get(opt, default)
|
2013-03-14 11:31:44 +01:00
|
|
|
|
2013-04-08 16:05:56 +02:00
|
|
|
def has_property(self, propname, opt=None, is_apply_req=True):
|
2012-11-19 10:45:03 +01:00
|
|
|
"""has property propname in the Config's properties attribute
|
|
|
|
:param property: string wich is the name of the property"""
|
2013-04-08 16:05:56 +02:00
|
|
|
return propname in self.get_properties(opt, is_apply_req)
|
2012-11-19 10:45:03 +01:00
|
|
|
|
|
|
|
def enable_property(self, propname):
|
|
|
|
"puts property propname in the Config's properties attribute"
|
2013-04-03 12:20:26 +02:00
|
|
|
props = self.get_properties()
|
|
|
|
if propname not in props:
|
|
|
|
props.append(propname)
|
|
|
|
self.set_properties(props)
|
2012-11-19 10:45:03 +01:00
|
|
|
|
|
|
|
def disable_property(self, propname):
|
|
|
|
"deletes property propname in the Config's properties attribute"
|
2013-04-03 12:20:26 +02:00
|
|
|
props = self.get_properties()
|
|
|
|
if propname in props:
|
|
|
|
props.remove(propname)
|
|
|
|
self.set_properties(props)
|
|
|
|
|
|
|
|
def set_properties(self, properties, opt=None):
|
|
|
|
"""save properties for specified opt
|
|
|
|
(never save properties if same has option properties)
|
|
|
|
"""
|
|
|
|
if opt is None:
|
|
|
|
self.properties[opt] = properties
|
|
|
|
else:
|
|
|
|
if opt._properties == properties:
|
|
|
|
if opt in self.properties:
|
|
|
|
del(self.properties[opt])
|
|
|
|
else:
|
|
|
|
self.properties[opt] = properties
|
|
|
|
|
2013-04-08 16:05:56 +02:00
|
|
|
def add_property(self, propname, opt, is_apply_req=True):
|
|
|
|
properties = self.get_properties(opt, is_apply_req)
|
2013-04-03 12:20:26 +02:00
|
|
|
if not propname in properties:
|
|
|
|
properties.append(propname)
|
|
|
|
self.set_properties(properties, opt)
|
|
|
|
|
2013-04-08 16:05:56 +02:00
|
|
|
def del_property(self, propname, opt, is_apply_req=True):
|
|
|
|
properties = self.get_properties(opt, is_apply_req)
|
2013-04-03 12:20:26 +02:00
|
|
|
if propname in properties:
|
|
|
|
properties.remove(propname)
|
|
|
|
self.set_properties(properties, opt)
|
|
|
|
|
2012-12-11 11:18:53 +01:00
|
|
|
#____________________________________________________________
|
2013-04-17 21:33:34 +02:00
|
|
|
def validate_properties(self, opt_or_descr, is_descr, is_write,
|
|
|
|
value=None, force_permissive=False,
|
|
|
|
force_properties=None):
|
|
|
|
properties = set(self.get_properties(opt_or_descr))
|
|
|
|
#remove this properties, those properties are validate in after
|
|
|
|
properties = properties - set(['mandatory', 'frozen'])
|
|
|
|
set_properties = self.get_properties()
|
|
|
|
if force_properties is not None:
|
|
|
|
set_properties.extend(force_properties)
|
|
|
|
set_properties = set(set_properties)
|
|
|
|
properties = properties & set_properties
|
|
|
|
if force_permissive is True or self.has_property('permissive', is_apply_req=False):
|
|
|
|
properties = properties - set(self.get_permissive())
|
|
|
|
properties = properties - set(self.get_permissive(opt_or_descr))
|
|
|
|
properties = list(properties)
|
|
|
|
raise_text = _("trying to access"
|
|
|
|
" to an option named: {0} with properties"
|
|
|
|
" {1}")
|
|
|
|
if not is_descr:
|
|
|
|
if self.context.cfgimpl_get_values().is_mandatory_err(opt_or_descr,
|
|
|
|
value,
|
|
|
|
force_properties=force_properties):
|
|
|
|
properties.append('mandatory')
|
|
|
|
if is_write and (self.has_property('everything_frozen') or (
|
|
|
|
self.has_property('frozen') and
|
|
|
|
self.has_property('frozen', opt_or_descr,
|
|
|
|
is_apply_req=False))):
|
|
|
|
properties.append('frozen')
|
|
|
|
raise_text = _('cannot change the value to {0} for '
|
|
|
|
'option {1} this option is frozen')
|
|
|
|
if properties != []:
|
|
|
|
raise PropertiesOptionError(raise_text.format(opt_or_descr._name,
|
|
|
|
str(properties)),
|
|
|
|
properties)
|
|
|
|
|
2013-04-04 15:14:16 +02:00
|
|
|
def get_permissive(self, opt=None):
|
|
|
|
return self.permissives.get(opt, [])
|
2013-03-14 11:31:44 +01:00
|
|
|
|
2013-04-04 15:14:16 +02:00
|
|
|
def set_permissive(self, permissive, opt=None):
|
2012-11-19 10:45:03 +01:00
|
|
|
if not isinstance(permissive, list):
|
2013-04-14 12:01:32 +02:00
|
|
|
raise TypeError(_('permissive must be a list'))
|
2013-04-04 15:14:16 +02:00
|
|
|
self.permissives[opt] = permissive
|
2013-04-03 12:20:26 +02:00
|
|
|
|
2013-02-06 14:59:24 +01:00
|
|
|
#____________________________________________________________
|
2013-04-03 12:20:26 +02:00
|
|
|
def setowner(self, owner):
|
|
|
|
":param owner: sets the default value for owner at the Config level"
|
|
|
|
if not isinstance(owner, owners.Owner):
|
2013-04-14 12:01:32 +02:00
|
|
|
raise TypeError(_("invalid generic owner {0}").format(str(owner)))
|
2013-04-03 12:20:26 +02:00
|
|
|
self.owner = owner
|
2012-11-19 10:45:03 +01:00
|
|
|
|
2013-04-03 12:20:26 +02:00
|
|
|
def getowner(self):
|
|
|
|
return self.owner
|
2013-02-06 14:59:24 +01:00
|
|
|
|
|
|
|
#____________________________________________________________
|
2012-11-19 10:45:03 +01:00
|
|
|
def read_only(self):
|
|
|
|
"convenience method to freeze, hidde and disable"
|
2013-04-03 12:20:26 +02:00
|
|
|
self.enable_property('everything_frozen')
|
|
|
|
self.enable_property('frozen') # can be usefull...
|
2012-11-19 10:45:03 +01:00
|
|
|
self.disable_property('hidden')
|
|
|
|
self.enable_property('disabled')
|
2013-04-03 12:20:26 +02:00
|
|
|
self.enable_property('mandatory')
|
|
|
|
self.enable_property('validator')
|
|
|
|
self.disable_property('permissive')
|
2012-11-19 10:45:03 +01:00
|
|
|
|
|
|
|
def read_write(self):
|
|
|
|
"convenience method to freeze, hidde and disable"
|
2013-04-03 12:20:26 +02:00
|
|
|
self.disable_property('everything_frozen')
|
|
|
|
self.enable_property('frozen') # can be usefull...
|
2012-11-19 10:45:03 +01:00
|
|
|
self.enable_property('hidden')
|
|
|
|
self.enable_property('disabled')
|
2013-04-03 12:20:26 +02:00
|
|
|
self.disable_property('mandatory')
|
2013-04-08 16:05:56 +02:00
|
|
|
self.enable_property('validator')
|
2013-04-03 17:05:41 +02:00
|
|
|
self.disable_property('permissive')
|
2013-04-08 16:05:56 +02:00
|
|
|
|
|
|
|
|
|
|
|
def apply_requires(opt, config):
|
|
|
|
"carries out the jit (just in time requirements between options"
|
|
|
|
def build_actions(requires):
|
|
|
|
"action are hide, show, enable, disable..."
|
|
|
|
trigger_actions = {}
|
|
|
|
for require in requires:
|
|
|
|
action = require[2]
|
|
|
|
trigger_actions.setdefault(action, []).append(require)
|
|
|
|
return trigger_actions
|
|
|
|
#for symlink
|
|
|
|
if hasattr(opt, '_requires') and opt._requires is not None:
|
|
|
|
# filters the callbacks
|
|
|
|
setting = config.cfgimpl_get_settings()
|
|
|
|
trigger_actions = build_actions(opt._requires)
|
|
|
|
optpath = config.cfgimpl_get_context().cfgimpl_get_description().get_path_by_opt(opt)
|
|
|
|
for requires in trigger_actions.values():
|
|
|
|
matches = False
|
|
|
|
for require in requires:
|
|
|
|
if len(require) == 3:
|
|
|
|
path, expected, action = require
|
|
|
|
inverse = False
|
|
|
|
elif len(require) == 4:
|
|
|
|
path, expected, action, inverse = require
|
|
|
|
if path == optpath or path.startswith(optpath + '.'):
|
2013-04-14 12:01:32 +02:00
|
|
|
raise RequirementRecursionError(_("malformed requirements "
|
2013-04-08 16:05:56 +02:00
|
|
|
"imbrication detected for option: '{0}' "
|
2013-04-14 12:01:32 +02:00
|
|
|
"with requirement on: '{1}'").format(optpath, path))
|
2013-04-08 16:05:56 +02:00
|
|
|
try:
|
|
|
|
value = config.cfgimpl_get_context()._getattr(path, force_permissive=True)
|
|
|
|
except PropertiesOptionError, err:
|
|
|
|
properties = err.proptype
|
2013-04-14 12:01:32 +02:00
|
|
|
#FIXME: AttributeError or PropertiesOptionError ?
|
|
|
|
raise AttributeError(_("option '{0}' has requirement's property error: "
|
|
|
|
"{1} {2}").format(opt._name, path, properties))
|
2013-04-08 16:05:56 +02:00
|
|
|
except AttributeError:
|
2013-04-14 12:01:32 +02:00
|
|
|
raise AttributeError(_("required option not found: "
|
|
|
|
"{0}").format(path))
|
2013-04-08 16:05:56 +02:00
|
|
|
if value == expected:
|
|
|
|
if inverse:
|
|
|
|
setting.del_property(action, opt, False)
|
|
|
|
else:
|
|
|
|
setting.add_property(action, opt, False)
|
|
|
|
matches = True
|
|
|
|
#FIXME optimisation : fait un double break non ? voire un return
|
|
|
|
# no requirement has been triggered, then just reverse the action
|
|
|
|
if not matches:
|
|
|
|
if inverse:
|
|
|
|
setting.add_property(action, opt, False)
|
|
|
|
else:
|
|
|
|
setting.del_property(action, opt, False)
|