diff options
author | Jason Madden <jamadden@gmail.com> | 2017-09-14 10:28:23 -0500 |
---|---|---|
committer | Jason Madden <jamadden@gmail.com> | 2017-09-14 10:28:23 -0500 |
commit | b38c6b4836fe3249710f1a16061576bad8ff8b1a (patch) | |
tree | 00c57b9306dbe2b08d6830ab5b1cea014bd452a0 /src/zope/security/permission.py | |
parent | e504906ab28fed2decade91f289987dbf7e0d497 (diff) | |
download | zope-security-b38c6b4836fe3249710f1a16061576bad8ff8b1a.tar.gz |
Cross-refs and cleanups for permission.py/rst
Diffstat (limited to 'src/zope/security/permission.py')
-rw-r--r-- | src/zope/security/permission.py | 28 |
1 files changed, 20 insertions, 8 deletions
diff --git a/src/zope/security/permission.py b/src/zope/security/permission.py index 9854e3d..e3e8a60 100644 --- a/src/zope/security/permission.py +++ b/src/zope/security/permission.py @@ -31,6 +31,9 @@ from zope.security.interfaces import PUBLIC_PERMISSION_NAME as zope_Public @implementer(IPermission) class Permission(object): + """ + Default implementation of :class:`zope.security.interfaces.IPermission`. + """ def __init__(self, id, title="", description=""): self.id = id @@ -38,7 +41,9 @@ class Permission(object): self.description = description def checkPermission(context, permission_id): - """Check whether a given permission exists in the provided context. + """ + Check whether a given permission object exists in the provided + context as a utility. """ if permission_id is CheckerPublic: return @@ -46,14 +51,16 @@ def checkPermission(context, permission_id): raise ValueError("Undefined permission id", permission_id) def allPermissions(context=None): - """Get the ids of all defined permissions + """ + Get the ids of all defined permission object utilities. """ for name, _permission in getUtilitiesFor(IPermission, context): if name != zope_Public: yield name def PermissionsVocabulary(context=None): - """A vocabulary of permission IDs. + """ + A vocabulary of permission IDs. Term values are permissions, while term tokens are permission IDs. """ @@ -65,13 +72,18 @@ def PermissionsVocabulary(context=None): directlyProvides(PermissionsVocabulary, IVocabularyFactory) def PermissionIdsVocabulary(context=None): - """A vocabulary of permission IDs. + """ + A vocabulary of permission IDs. - Term values are the permission ID strings except for 'zope.Public', which - is the global permission CheckerPublic. + Term values are the permission ID strings except for + :data:`zope.Public + <zope.security.interfaces.PUBLIC_PERMISSION_NAME>`, which is the + global permission :data:`zope.security.checker.CheckerPublic`. - Term titles are the permission ID strings except for 'zope.Public', which - is shortened to 'Public'. + Term titles are the permission ID strings except for + :data:`zope.Public + <zope.security.interfaces.PUBLIC_PERMISSION_NAME>`, which is + shortened to 'Public'. Terms are sorted by title except for 'Public', which always appears as the first term. |