Changeset 6202 for main/waeup.sirp/trunk/src/waeup/sirp/permissions.txt

Timestamp:

26 May 2011, 23:34:04 (13 years ago)

Author:

uli

Message:

#37

File:

• main/waeup.sirp/trunk/src/waeup/sirp/permissions.txt (modified) (1 diff)

main/waeup.sirp/trunk/src/waeup/sirp/permissions.txt

@@ -54 +54 @@
     >>> list(getWAeUPRoleNames())
     [u'waeup.ApplicationsOfficer', u'waeup.PortalManager', u'waeup.PortalUser']
+
+:func:`get_users_with_local_roles`
+----------------------------------
+
+We can get all users and their roles for a certain context
+object. This even works for objects that cannot have local roles as
+they are not stored in the ZODB:
+
+    >>> from waeup.sirp.permissions import get_users_with_local_roles
+    >>> mycontext = object()
+    >>> people_and_roles = get_users_with_local_roles(mycontext)
+    >>> people_and_roles
+    <generator object at 0x...>
+
+In this case, the result is empty:
+
+    >>> people_and_roles = list(people_and_roles)
+    >>> people_and_roles
+    []