Document the AST transformations in visit_Attribute.

zopefoundation · Oct 5, 2016 · 82ff611 · 82ff611
1 parent 8e0bfee
commit 82ff611
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/src/RestrictedPython/transformer.py b/src/RestrictedPython/transformer.py
@@ -547,6 +547,13 @@ def visit_IfExp(self, node):
         return self.generic_visit(node)
 
     def visit_Attribute(self, node):
+        """Checks and mutates attribute access/assignment.
+
+        'a.b' becomes '_getattr_(a, "b")'
+
+        'a.b = c' becomes '_write_(a).b = c'
+        The _write_ function should return a security proxy.
+        """
         if node.attr.startswith('_') and node.attr != '_':
             self.error(
                 node,