source: TI12-security/trunk/NDGSecurity/python/ndg_security_common/ndg/security/common/authz/xacml/rule.py @ 6734

"""NDG Security Rule type definition

NERC DataGrid Project
"""
__author__ = "P J Kershaw"
__date__ = "25/02/10"
__copyright__ = "(C) 2010 Science and Technology Facilities Council"
__contact__ = "Philip.Kershaw@stfc.ac.uk"
__license__ = "BSD - see LICENSE file in top-level directory"
__contact__ = "Philip.Kershaw@stfc.ac.uk"
__revision__ = "$Id: $"
from ndg.security.common.utils import TypedList
from ndg.security.common.authz.xacml import PolicyComponent
from ndg.security.common.authz.xacml.target import Target
from ndg.security.common.authz.xacml.condition import Condition


class Rule(PolicyComponent):
    """XACML Policy Rule"""
    ELEMENT_LOCAL_NAME = 'Rule'
    
    __slots__ = (
        '__targets', 
        '__conditions', 
        '__description', 
        '__id', 
        '__effect'
    )
    
    def __init__(self):
        self.__id = None
        self.__effect = None
        self.__targets = TypedList(Target)
        self.__conditions = TypedList(Condition)
        
    @property
    def targets(self):
        "list of Rule targets"
        return self.__targets
    
    @property
    def conditions(self):
        "list of rule conditions"
        return self.__conditions
       
    def _get_id(self):
        return self.__id

    def _set_id(self, value):
        if not isinstance(value, basestring):
            raise TypeError('Expecting %r type for "id" '
                            'attribute; got %r' % (basestring, type(value)))
            
        self.__id = value   

    id = property(_get_id, _set_id, None, "Rule identifier attribute")  
      
    def _get_effect(self):
        return self.__effect

    def _set_effect(self, value):
        if not isinstance(value, basestring):
            raise TypeError('Expecting %r type for "effect" '
                            'attribute; got %r' % (basestring, type(value)))
            
        self.__effect = value   

    effect = property(_get_effect, _set_effect, None, 
                      "Rule effect attribute")  

    def _getDescription(self):
        return self.__description

    def _setDescription(self, value):
        if not isinstance(value, basestring):
            raise TypeError('Expecting string type for "description" '
                            'attribute; got %r' % type(value))
        self.__description = value

    description = property(_getDescription, _setDescription, 
                           doc="Rule Description text")