summaryrefslogtreecommitdiff
path: root/docs/narr/security.rst
diff options
context:
space:
mode:
authorJulien MIOTTE <j.m@majerti.fr>2016-06-03 09:20:14 +0200
committerJulien MIOTTE <j.m@majerti.fr>2016-06-08 23:46:36 +0200
commitbb800f2cd7424c6280a7346303963d0f0daed935 (patch)
tree6a3e65a50ff613b7812bb9f1bda7f931bf4aad7d /docs/narr/security.rst
parent1f1ca55fa1c83307fed234ba759c79d38da526c6 (diff)
downloadpyramid-bb800f2cd7424c6280a7346303963d0f0daed935.tar.gz
pyramid-bb800f2cd7424c6280a7346303963d0f0daed935.tar.bz2
pyramid-bb800f2cd7424c6280a7346303963d0f0daed935.zip
Adding a warning discouraging use of __acl__ properties attributes
Diffstat (limited to 'docs/narr/security.rst')
-rw-r--r--docs/narr/security.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/narr/security.rst b/docs/narr/security.rst
index 7cbea113c..842aad23f 100644
--- a/docs/narr/security.rst
+++ b/docs/narr/security.rst
@@ -290,6 +290,13 @@ properties of the instance.
def __init__(self, owner):
self.owner = owner
+.. warning::
+
+ Writing ``__acl__`` as properties is discouraged, as AttributeErrors
+ occuring in ``fget`` or ``fset`` will be silently dismissed (this is consistent
+ with Python ``getattr`` and ``hasattr`` behaviors). For dynamic ACLs, simply use
+ callables, as documented above.
+
.. index::
single: ACE
single: access control entry