Synnefo

    # internal API

                    int, int, int, int, int)

    def __create_attribute_of_node_for_resource(self,

                                                abs_or_not_node_name,

                                                intended_parent_node_name,

        return computed_attribute_name

    def get_cached_node_key(self, node_name):

        check_abs_name(node_name, 'node_name')

        return self.__node_keys.get(node_name) or '' # sane default

    @returns(type(None))

    def set_cached_node_key(self, abs_node_name, node_key, label='abs_node_name'):

        check_abs_name(abs_node_name, label)

        return self.__node_keys.copy() # Client cannot mess with the original

    @returns(list)

    def get_node_children(self, node_name):

        check_abs_name(node_name, 'node_name')

        return self.get_node_children(NameOfUsersNode)

    def ensure_node(self, abs_node_name, label='abs_node_name'):

        if not self.has_node(abs_node_name, label):

            return self.create_node(abs_node_name, label)

            return abs_node_name

    def ensure_resources_node(self):

        """

        Ensure that the node 'system/resources' exists.

        return self.ensure_node(NameOfResourcesNode, 'NameOfResourcesNode')

    def ensure_groups_node(self):

        """

        Ensure that the node 'system/groups' exists.

        return self.ensure_node(NameOfGroupsNode, 'NameOfGroupsNode')

    def ensure_users_node(self):

        """

        Ensure that the node 'system/users' exists.

        return self.ensure_node(NameOfUsersNode, 'NameOfGroupsNode')

    @returns(bool)

    def has_node(self, abs_node_name, label='abs_node_name'):

        """

        return len(entity_owner_list) == 1 # TODO: any other check here?

    def create_node(self, node_name, label='node_name'):

        """

        Creates a node with an absolute name ``node_name``.

            return node_name

    @returns(bool)

    def has_global_resource(self, abs_resource_name):

        check_abs_global_resource_name(abs_resource_name)

        return self.has_node(abs_resource_name)

    def define_global_resource(self, resource_name):

        """

        Defines a resource globally known to Quota Holder.

        return self.create_node(abs_resource_name, 'abs_resource_name')

    def define_attribute_of_global_resource(self,

                                            global_resource_name,

                                            attribute_name,

    def define_group(self, group_name, group_node_key=''):

        """

        Creates a new group under 'system/groups'.

    def define_attribute_of_group_for_resource(self,

                                               group_name,

                                               attribute_name,

            flags=flags)

    @returns(type(None))

    def define_group_resource(self,

                              group_name,