2008-08-05 02:39:50 -05:00
|
|
|
# Authors:
|
|
|
|
# Jason Gerard DeRose <jderose@redhat.com>
|
|
|
|
#
|
|
|
|
# Copyright (C) 2008 Red Hat
|
|
|
|
# see file 'COPYING' for use and warranty information
|
|
|
|
#
|
|
|
|
# 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; version 2 only
|
|
|
|
#
|
|
|
|
# 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
|
|
|
|
|
|
|
|
"""
|
|
|
|
Base classes for the public plugable.API instance, which the XML-RPC, CLI,
|
|
|
|
and UI all use.
|
|
|
|
"""
|
|
|
|
|
|
|
|
import re
|
2008-08-10 19:21:12 -05:00
|
|
|
import inspect
|
2008-08-05 02:39:50 -05:00
|
|
|
import plugable
|
2008-09-02 12:41:55 -05:00
|
|
|
from plugable import lock, check_name
|
2008-08-06 22:38:49 -05:00
|
|
|
import errors
|
2008-09-02 12:41:55 -05:00
|
|
|
from errors import check_type, check_isinstance
|
2008-08-28 13:31:06 -05:00
|
|
|
import ipa_types
|
2008-08-06 22:38:49 -05:00
|
|
|
|
|
|
|
|
2008-08-06 23:51:21 -05:00
|
|
|
RULE_FLAG = 'validation_rule'
|
|
|
|
|
|
|
|
def rule(obj):
|
2008-08-08 12:11:29 -05:00
|
|
|
assert not hasattr(obj, RULE_FLAG)
|
|
|
|
setattr(obj, RULE_FLAG, True)
|
|
|
|
return obj
|
2008-08-06 23:51:21 -05:00
|
|
|
|
|
|
|
def is_rule(obj):
|
2008-08-08 12:11:29 -05:00
|
|
|
return callable(obj) and getattr(obj, RULE_FLAG, False) is True
|
2008-08-06 23:51:21 -05:00
|
|
|
|
|
|
|
|
2008-08-22 15:07:17 -05:00
|
|
|
class DefaultFrom(plugable.ReadOnly):
|
2008-08-25 20:07:24 -05:00
|
|
|
"""
|
|
|
|
Derives a default for one value using other supplied values.
|
|
|
|
|
2008-08-26 11:52:46 -05:00
|
|
|
Here is an example that constructs a user's initials from his first
|
|
|
|
and last name:
|
2008-08-25 20:07:24 -05:00
|
|
|
|
|
|
|
>>> df = DefaultFrom(lambda f, l: f[0] + l[0], 'first', 'last')
|
|
|
|
>>> df(first='John', last='Doe') # Both keys
|
|
|
|
'JD'
|
|
|
|
>>> df() is None # Returns None if any key is missing
|
|
|
|
True
|
|
|
|
>>> df(first='John', middle='Q') is None # Still returns None
|
|
|
|
True
|
|
|
|
"""
|
2008-08-22 15:07:17 -05:00
|
|
|
def __init__(self, callback, *keys):
|
2008-08-25 20:07:24 -05:00
|
|
|
"""
|
|
|
|
:param callback: The callable to call when all ``keys`` are present.
|
|
|
|
:param keys: The keys used to map from keyword to position arguments.
|
|
|
|
"""
|
2008-08-22 15:07:17 -05:00
|
|
|
assert callable(callback), 'not a callable: %r' % callback
|
2008-08-25 20:07:24 -05:00
|
|
|
assert len(keys) > 0, 'must have at least one key'
|
|
|
|
for key in keys:
|
|
|
|
assert type(key) is str, 'not an str: %r' % key
|
2008-08-22 15:07:17 -05:00
|
|
|
self.callback = callback
|
|
|
|
self.keys = keys
|
|
|
|
lock(self)
|
|
|
|
|
|
|
|
def __call__(self, **kw):
|
2008-08-26 11:52:46 -05:00
|
|
|
"""
|
|
|
|
If all keys are present, calls the callback; otherwise returns None.
|
|
|
|
|
|
|
|
:param kw: The keyword arguments.
|
|
|
|
"""
|
2008-08-22 15:07:17 -05:00
|
|
|
vals = tuple(kw.get(k, None) for k in self.keys)
|
|
|
|
if None in vals:
|
|
|
|
return None
|
|
|
|
try:
|
2008-08-26 11:52:46 -05:00
|
|
|
return self.callback(*vals)
|
2008-08-22 15:07:17 -05:00
|
|
|
except Exception:
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
2008-09-02 15:33:08 -05:00
|
|
|
class Option(plugable.ReadOnly):
|
2008-09-02 14:05:10 -05:00
|
|
|
def __init__(self, name, doc, type_,
|
|
|
|
required=False,
|
|
|
|
multivalue=False,
|
|
|
|
default=None,
|
|
|
|
default_from=None,
|
|
|
|
rules=tuple(),
|
|
|
|
normalize=None):
|
2008-09-02 12:41:55 -05:00
|
|
|
self.name = check_name(name)
|
|
|
|
self.doc = check_type(doc, str, 'doc')
|
|
|
|
self.type = check_isinstance(type_, ipa_types.Type, 'type_')
|
|
|
|
self.required = check_type(required, bool, 'required')
|
|
|
|
self.multivalue = check_type(multivalue, bool, 'multivalue')
|
2008-08-28 13:31:06 -05:00
|
|
|
self.default = default
|
2008-09-02 12:41:55 -05:00
|
|
|
self.default_from = check_type(default_from,
|
2008-09-02 12:44:07 -05:00
|
|
|
DefaultFrom, 'default_from', allow_none=True)
|
2008-08-28 13:31:06 -05:00
|
|
|
self.__normalize = normalize
|
|
|
|
self.rules = (type_.validate,) + rules
|
|
|
|
lock(self)
|
|
|
|
|
2008-08-28 22:17:26 -05:00
|
|
|
def convert(self, value):
|
|
|
|
if self.multivalue:
|
|
|
|
if type(value) in (tuple, list):
|
|
|
|
return tuple(self.type(v) for v in value)
|
|
|
|
return (self.type(value),)
|
|
|
|
return self.type(value)
|
|
|
|
|
|
|
|
def __normalize_scalar(self, value):
|
|
|
|
if value is None:
|
|
|
|
return None
|
|
|
|
if type(value) is not self.type.type:
|
|
|
|
raise TypeError('need a %r; got %r' % (self.type.type, value))
|
|
|
|
return self.__normalize(value)
|
|
|
|
|
|
|
|
def normalize(self, value):
|
|
|
|
if self.__normalize is None:
|
|
|
|
return value
|
|
|
|
if self.multivalue:
|
|
|
|
if value is None:
|
|
|
|
return None
|
|
|
|
if type(value) is not tuple:
|
|
|
|
raise TypeError('multivalue must be a tuple; got %r' % value)
|
|
|
|
return tuple(self.__normalize_scalar(v) for v in value)
|
|
|
|
return self.__normalize_scalar(value)
|
|
|
|
|
|
|
|
def __validate_scalar(self, value):
|
2008-08-28 13:31:06 -05:00
|
|
|
for rule in self.rules:
|
2008-08-28 15:30:08 -05:00
|
|
|
error = rule(value)
|
|
|
|
if error is not None:
|
|
|
|
raise errors.RuleError(self.name, value, rule, error)
|
2008-08-28 13:31:06 -05:00
|
|
|
|
|
|
|
def validate(self, value):
|
|
|
|
if self.multivalue:
|
|
|
|
if type(value) is not tuple:
|
2008-08-28 22:17:26 -05:00
|
|
|
raise TypeError('multivalue must be a tuple; got %r' % value)
|
2008-08-28 13:31:06 -05:00
|
|
|
for v in value:
|
2008-08-28 22:17:26 -05:00
|
|
|
self.__validate_scalar(v)
|
2008-08-28 13:31:06 -05:00
|
|
|
else:
|
2008-08-28 22:17:26 -05:00
|
|
|
self.__validate_scalar(value)
|
2008-08-28 13:31:06 -05:00
|
|
|
|
2008-09-02 14:05:10 -05:00
|
|
|
def get_default(self, **kw):
|
|
|
|
if self.default_from is not None:
|
|
|
|
default = self.default_from(**kw)
|
|
|
|
if default is not None:
|
|
|
|
return self.convert(default)
|
|
|
|
return self.convert(self.default)
|
|
|
|
|
2008-09-02 14:29:00 -05:00
|
|
|
def get_values(self):
|
|
|
|
if self.type.name in ('Enum', 'CallbackEnum'):
|
|
|
|
return self.type.values
|
|
|
|
return tuple()
|
|
|
|
|
2008-08-28 13:31:06 -05:00
|
|
|
|
2008-08-15 14:49:04 -05:00
|
|
|
class Command(plugable.Plugin):
|
2008-08-08 12:11:29 -05:00
|
|
|
__public__ = frozenset((
|
2008-08-26 14:13:55 -05:00
|
|
|
'get_default',
|
2008-09-02 18:40:44 -05:00
|
|
|
'normalize',
|
2008-08-11 12:37:33 -05:00
|
|
|
'validate',
|
2008-08-11 14:11:26 -05:00
|
|
|
'execute',
|
2008-08-08 16:40:03 -05:00
|
|
|
'__call__',
|
2008-09-02 18:40:44 -05:00
|
|
|
'Option',
|
2008-08-08 12:11:29 -05:00
|
|
|
))
|
2008-09-02 17:19:39 -05:00
|
|
|
__Option = None
|
|
|
|
options = tuple()
|
2008-08-08 12:11:29 -05:00
|
|
|
|
|
|
|
def get_options(self):
|
2008-09-02 17:19:39 -05:00
|
|
|
return self.options
|
2008-08-08 12:11:29 -05:00
|
|
|
|
2008-09-02 17:19:39 -05:00
|
|
|
def __get_Option(self):
|
2008-08-08 16:40:03 -05:00
|
|
|
"""
|
2008-09-02 17:19:39 -05:00
|
|
|
Returns the NameSpace containing the Option instances.
|
2008-08-08 16:40:03 -05:00
|
|
|
"""
|
2008-09-02 17:19:39 -05:00
|
|
|
if self.__Option is None:
|
|
|
|
object.__setattr__(self, '_Command__Option',
|
2008-08-11 21:03:47 -05:00
|
|
|
plugable.NameSpace(self.get_options()),
|
|
|
|
)
|
2008-09-02 17:19:39 -05:00
|
|
|
return self.__Option
|
|
|
|
Option = property(__get_Option)
|
2008-08-08 12:11:29 -05:00
|
|
|
|
2008-09-02 18:40:44 -05:00
|
|
|
def __normalize_iter(self, kw):
|
2008-08-08 16:40:03 -05:00
|
|
|
for (key, value) in kw.items():
|
2008-09-02 18:40:44 -05:00
|
|
|
if key in self.Option:
|
2008-08-08 16:40:03 -05:00
|
|
|
yield (
|
2008-09-02 18:40:44 -05:00
|
|
|
key, self.Option[key].normalize(value)
|
2008-08-08 16:40:03 -05:00
|
|
|
)
|
|
|
|
else:
|
|
|
|
yield (key, value)
|
2008-08-08 12:11:29 -05:00
|
|
|
|
|
|
|
def normalize(self, **kw):
|
2008-08-12 13:02:49 -05:00
|
|
|
self.print_call('normalize', kw, 1)
|
2008-09-02 18:40:44 -05:00
|
|
|
return dict(self.__normalize_iter(kw))
|
2008-08-08 12:11:29 -05:00
|
|
|
|
2008-09-02 18:40:44 -05:00
|
|
|
def __get_default_iter(self, kw):
|
|
|
|
for option in self.Option():
|
2008-08-11 12:57:07 -05:00
|
|
|
if option.name not in kw:
|
2008-08-26 14:13:55 -05:00
|
|
|
value = option.get_default(**kw)
|
2008-08-08 16:40:03 -05:00
|
|
|
if value is not None:
|
2008-08-11 12:57:07 -05:00
|
|
|
yield(option.name, value)
|
|
|
|
|
2008-08-26 14:13:55 -05:00
|
|
|
def get_default(self, **kw):
|
2008-08-12 13:02:49 -05:00
|
|
|
self.print_call('default', kw, 1)
|
2008-09-02 18:40:44 -05:00
|
|
|
return dict(self.__get_default_iter(kw))
|
2008-08-08 12:11:29 -05:00
|
|
|
|
2008-08-11 12:37:33 -05:00
|
|
|
def validate(self, **kw):
|
2008-08-12 13:02:49 -05:00
|
|
|
self.print_call('validate', kw, 1)
|
2008-09-02 18:40:44 -05:00
|
|
|
for option in self.Option():
|
|
|
|
value = kw.get(option.name, None)
|
2008-08-13 00:14:12 -05:00
|
|
|
if value is None:
|
2008-09-02 18:40:44 -05:00
|
|
|
if option.required:
|
|
|
|
raise errors.RequirementError(option.name)
|
2008-08-13 00:14:12 -05:00
|
|
|
continue
|
2008-09-02 18:40:44 -05:00
|
|
|
option.validate(value)
|
2008-08-11 14:11:26 -05:00
|
|
|
|
2008-08-11 14:35:57 -05:00
|
|
|
def execute(self, **kw):
|
2008-08-12 13:02:49 -05:00
|
|
|
self.print_call('execute', kw, 1)
|
2008-08-11 14:11:26 -05:00
|
|
|
pass
|
|
|
|
|
2008-08-12 13:02:49 -05:00
|
|
|
def print_call(self, method, kw, tab=0):
|
|
|
|
print '%s%s.%s(%s)\n' % (
|
|
|
|
' ' * (tab *2),
|
2008-08-11 14:11:26 -05:00
|
|
|
self.name,
|
|
|
|
method,
|
2008-08-12 14:22:48 -05:00
|
|
|
', '.join('%s=%r' % (k, kw[k]) for k in sorted(kw)),
|
2008-08-11 14:11:26 -05:00
|
|
|
)
|
2008-08-11 12:37:33 -05:00
|
|
|
|
2008-08-13 01:41:39 -05:00
|
|
|
def __call__(self, *args, **kw):
|
2008-08-12 13:02:49 -05:00
|
|
|
print ''
|
2008-08-12 12:42:21 -05:00
|
|
|
self.print_call('__call__', kw)
|
|
|
|
kw = self.normalize(**kw)
|
2008-08-26 14:13:55 -05:00
|
|
|
kw.update(self.get_default(**kw))
|
2008-08-12 12:42:21 -05:00
|
|
|
self.validate(**kw)
|
|
|
|
self.execute(**kw)
|
2008-08-05 16:10:49 -05:00
|
|
|
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-22 16:50:53 -05:00
|
|
|
class Object(plugable.Plugin):
|
2008-08-08 12:11:29 -05:00
|
|
|
__public__ = frozenset((
|
2008-08-22 15:23:19 -05:00
|
|
|
'Method',
|
2008-08-22 15:32:23 -05:00
|
|
|
'Property',
|
2008-08-08 12:11:29 -05:00
|
|
|
))
|
2008-08-22 15:23:19 -05:00
|
|
|
__Method = None
|
2008-08-22 15:32:23 -05:00
|
|
|
__Property = None
|
2008-08-05 21:00:18 -05:00
|
|
|
|
2008-08-22 15:23:19 -05:00
|
|
|
def __get_Method(self):
|
|
|
|
return self.__Method
|
|
|
|
Method = property(__get_Method)
|
2008-08-05 21:00:18 -05:00
|
|
|
|
2008-08-22 15:32:23 -05:00
|
|
|
def __get_Property(self):
|
|
|
|
return self.__Property
|
|
|
|
Property = property(__get_Property)
|
2008-08-05 21:00:18 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def finalize(self, api):
|
2008-08-22 16:50:53 -05:00
|
|
|
super(Object, self).finalize(api)
|
|
|
|
self.__Method = self.__create_namespace('Method')
|
|
|
|
self.__Property = self.__create_namespace('Property')
|
2008-08-05 21:00:18 -05:00
|
|
|
|
2008-08-22 16:50:53 -05:00
|
|
|
def __create_namespace(self, name):
|
|
|
|
return plugable.NameSpace(self.__filter_members(name))
|
2008-08-05 21:00:18 -05:00
|
|
|
|
2008-08-22 16:50:53 -05:00
|
|
|
def __filter_members(self, name):
|
2008-08-15 14:15:24 -05:00
|
|
|
namespace = getattr(self.api, name)
|
|
|
|
assert type(namespace) is plugable.NameSpace
|
2008-08-22 16:50:53 -05:00
|
|
|
for proxy in namespace(): # Equivalent to dict.itervalues()
|
2008-08-15 14:15:24 -05:00
|
|
|
if proxy.obj_name == self.name:
|
|
|
|
yield proxy.__clone__('attr_name')
|
2008-08-05 02:39:50 -05:00
|
|
|
|
|
|
|
|
2008-08-22 16:27:25 -05:00
|
|
|
class Attribute(plugable.Plugin):
|
2008-08-11 16:14:07 -05:00
|
|
|
__public__ = frozenset((
|
|
|
|
'obj',
|
|
|
|
'obj_name',
|
|
|
|
))
|
2008-08-08 12:11:29 -05:00
|
|
|
__obj = None
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def __init__(self):
|
2008-08-22 17:49:56 -05:00
|
|
|
m = re.match(
|
|
|
|
'^([a-z][a-z0-9]+)_([a-z][a-z0-9]+)$',
|
|
|
|
self.__class__.__name__
|
|
|
|
)
|
2008-08-08 16:40:03 -05:00
|
|
|
assert m
|
|
|
|
self.__obj_name = m.group(1)
|
|
|
|
self.__attr_name = m.group(2)
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def __get_obj_name(self):
|
2008-08-08 16:40:03 -05:00
|
|
|
return self.__obj_name
|
2008-08-08 12:11:29 -05:00
|
|
|
obj_name = property(__get_obj_name)
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def __get_attr_name(self):
|
2008-08-08 16:40:03 -05:00
|
|
|
return self.__attr_name
|
2008-08-08 12:11:29 -05:00
|
|
|
attr_name = property(__get_attr_name)
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def __get_obj(self):
|
2008-08-08 16:40:03 -05:00
|
|
|
"""
|
|
|
|
Returns the obj instance this attribute is associated with, or None
|
|
|
|
if no association has been set.
|
|
|
|
"""
|
|
|
|
return self.__obj
|
2008-08-08 12:11:29 -05:00
|
|
|
obj = property(__get_obj)
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-08 12:11:29 -05:00
|
|
|
def finalize(self, api):
|
2008-08-22 16:27:25 -05:00
|
|
|
super(Attribute, self).finalize(api)
|
2008-08-22 16:50:53 -05:00
|
|
|
self.__obj = api.Object[self.obj_name]
|
2008-08-05 02:39:50 -05:00
|
|
|
|
|
|
|
|
2008-08-22 16:27:25 -05:00
|
|
|
class Method(Attribute, Command):
|
|
|
|
__public__ = Attribute.__public__.union(Command.__public__)
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-11 16:14:07 -05:00
|
|
|
def get_options(self):
|
2008-09-02 19:01:45 -05:00
|
|
|
for option in self.options:
|
2008-09-02 17:19:39 -05:00
|
|
|
yield option
|
2008-08-22 15:32:23 -05:00
|
|
|
if self.obj is not None and self.obj.Property is not None:
|
|
|
|
for proxy in self.obj.Property():
|
2008-09-02 17:19:39 -05:00
|
|
|
yield proxy.option
|
2008-08-05 02:39:50 -05:00
|
|
|
|
2008-08-11 16:14:07 -05:00
|
|
|
|
2008-09-02 15:16:34 -05:00
|
|
|
class Property(Attribute):
|
|
|
|
__public__ = frozenset((
|
|
|
|
'rules',
|
|
|
|
'option',
|
|
|
|
'type',
|
|
|
|
)).union(Attribute.__public__)
|
2008-08-05 16:10:49 -05:00
|
|
|
|
2008-09-02 17:19:39 -05:00
|
|
|
type = ipa_types.Unicode()
|
|
|
|
required = False
|
|
|
|
multivalue = False
|
|
|
|
default = None
|
|
|
|
default_from = None
|
|
|
|
normalize = None
|
|
|
|
|
|
|
|
def __init__(self):
|
|
|
|
super(Property, self).__init__()
|
|
|
|
self.rules = tuple(sorted(
|
|
|
|
self.__rules_iter(),
|
|
|
|
key=lambda f: getattr(f, '__name__'),
|
|
|
|
))
|
|
|
|
self.option = Option(self.attr_name, self.doc, self.type,
|
|
|
|
required=self.required,
|
|
|
|
multivalue=self.multivalue,
|
|
|
|
default=self.default,
|
|
|
|
default_from=self.default_from,
|
|
|
|
rules=self.rules,
|
|
|
|
normalize=self.normalize,
|
|
|
|
)
|
2008-09-02 15:16:34 -05:00
|
|
|
|
|
|
|
def __rules_iter(self):
|
|
|
|
"""
|
|
|
|
Iterates through the attributes in this instance to retrieve the
|
|
|
|
methods implementing validation rules.
|
|
|
|
"""
|
|
|
|
for name in dir(self.__class__):
|
|
|
|
if name.startswith('_'):
|
|
|
|
continue
|
|
|
|
base_attr = getattr(self.__class__, name)
|
|
|
|
if is_rule(base_attr):
|
|
|
|
attr = getattr(self, name)
|
|
|
|
if is_rule(attr):
|
|
|
|
yield attr
|