[Zope-Checkins] CVS: Zope3/lib/python/Zope/App/Security - IRoleService.py:1.1.2.1

[Jim Fulton]

Update of /cvs-repository/Zope3/lib/python/Zope/App/Security
In directory cvs.zope.org:/tmp/cvs-serv15137

Added Files:
      Tag: Zope-3x-branch
	IRoleService.py 
Log Message:
*** empty log message ***

=== Added File Zope3/lib/python/Zope/App/Security/IRoleService.py ===
##############################################################################
#
# Copyright (c) 2001 Zope Corporation and Contributors. All Rights Reserved.
# 
# This software is subject to the provisions of the Zope Public License,
# Version 2.0 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE
# 
##############################################################################
"""

Revision information: $Id: IRoleService.py,v 1.1.2.1 2001/12/28 13:35:17 jim Exp $
"""

from Interface import Interface

class IRoleService(Interface):
    """Define roles

     'IRoleService' objects are used to implement role-definition
     services. Because they implement services, they are expected to
     collaborate with services in other contexts. Client code doesn't
     sarch a context and call multiple services. Instead, client code
     will call the most specific service in a place and rely on the
     service to delegate to other services as necessary.

     The interface doesn't include methods for data
     management. Services may use external data and not allow
     management in Zope. Simularly, the data to be managed may vary
     with different implementations of a service.
     """

    def getRole(rid):
        """Return an 'IRole' object for the given role id."""


    def getRoles():
        """Return a sequence of the roles (IRole objects)
        defined in the place containing the service."""