src/pyams_utils/interfaces/__init__.py
changeset 367 2c95d34496f5
parent 292 b338586588ad
child 419 05ff71a02b2d
--- a/src/pyams_utils/interfaces/__init__.py	Wed Jun 12 20:06:45 2019 +0200
+++ b/src/pyams_utils/interfaces/__init__.py	Fri Jun 14 12:41:06 2019 +0200
@@ -10,18 +10,18 @@
 # FOR A PARTICULAR PURPOSE.
 #
 
+"""PyAMS_utils interfaces module
+
+This module defines several generic constants and interfaces.
+It is also used to provide translations to common zope.schema exceptions.
+"""
+
 __docformat__ = 'restructuredtext'
 
-
-# import standard library
-
-# import interfaces
-from zope.schema.interfaces import WrongContainedType, NotUnique, SchemaNotFullyImplemented, SchemaNotProvided, \
-    InvalidURI, InvalidId, InvalidDottedName, Unbound, RequiredMissing, WrongType, TooBig, TooSmall, TooLong, \
-    TooShort, InvalidValue, ConstraintNotSatisfied, NotAContainer, NotAnIterator
-
-# import packages
 from zope.interface import Interface
+from zope.schema.interfaces import ConstraintNotSatisfied, InvalidDottedName, InvalidId, InvalidURI, InvalidValue, \
+    NotAContainer, NotAnIterator, NotUnique, RequiredMissing, SchemaNotFullyImplemented, SchemaNotProvided, TooBig, \
+    TooLong, TooShort, TooSmall, Unbound, WrongContainedType, WrongType
 
 from pyams_utils import _
 
@@ -56,7 +56,7 @@
 #
 
 FORBIDDEN_PERMISSION = 'system.forbidden'
-'''Custom permission which is never granted to any user'''
+'''Custom permission which is never granted to any user, even system manager'''
 
 PUBLIC_PERMISSION = 'public'
 '''Public permission which is granted to every principal'''