[pypy-commit] pypy default: Add a warning to the tproxy docs
arigo
noreply at buildbot.pypy.org
Fri Jul 4 13:58:58 CEST 2014
Author: Armin Rigo <arigo at tunes.org>
Branch:
Changeset: r72353:261cce2fec2d
Date: 2014-07-04 13:58 +0200
http://bitbucket.org/pypy/pypy/changeset/261cce2fec2d/
Log: Add a warning to the tproxy docs
diff --git a/pypy/doc/objspace-proxies.rst b/pypy/doc/objspace-proxies.rst
--- a/pypy/doc/objspace-proxies.rst
+++ b/pypy/doc/objspace-proxies.rst
@@ -26,6 +26,16 @@
Transparent Proxies
================================
+.. warning::
+
+ This is a feature that was tried experimentally long ago, and we
+ found no really good use cases. The basic functionality is still
+ there, but we don't recommend using it. Some of the examples below
+ might not work any more (e.g. you can't tproxy a list object any
+ more). The rest can be done by hacking in standard Python. If
+ anyone is interested in working on tproxy again, he is welcome, but
+ we don't regard this as an interesting extension.
+
PyPy's Transparent Proxies allow routing of operations on objects
to a callable. Application level code can customize objects without
interfering with the type system - ``type(proxied_list) is list`` holds true
More information about the pypy-commit
mailing list