Original implementation

CHANGES.txt

+=======
+CHANGES
+=======
+
+3.6.1 (2010-07-06)
+------------------
+
+- Make tests compatible with Python 2.7.
+
+3.6.0 (2010-04-30)
+------------------
+
+- Removed test extra and the remaining dependency on zope.testing.
+
+- Removed use of 'zope.testing.doctestunit' in favor of stdlib's 'doctest.
+
+3.5.0 (2009/01/31)
+------------------
+
+- Added support to bootstrap on Jython.
+
+- Use zope.container instead of zope.app.container.
+
+3.4.2 (2008/07/27)
+------------------
+
+- Made C code compatible with Python 2.5 on 64bit architectures.
+
+3.4.1 (2008/06/24)
+------------------
+
+- Bug: Updated `setup.py` script to conform to common layout. Also updated
+  some of the fields.
+
+- Bug: The behavior of tuples and lists in the `__getslice__()` and
+  `__setslice__()` method were incorrect by not honoring the pre-cooked
+  indices. See http://docs.python.org/ref/sequence-methods.html.
+
+3.4.0 (2007/07/12)
+------------------
+
+- Feature: Added a decorator module that supports declaring interfaces on
+  proxies that get blended with the interfaces of the things they proxy.
+
+3.3.0 (2006/12/20)
+------------------
+
+- Corresponds to the verison of the `zope.proxy` package shipped as part of
+  the Zope 3.3.0 release.
+
+
+3.2.0 (2006/01/05)
+------------------
+
+- Corresponds to the verison of the zope.proxy package shipped as part of
+  the Zope 3.2.0 release.
+
+
+3.0.0 (2004/11/07)
+------------------
+
+- Corresponds to the verison of the zope.proxy package shipped as part of
+  the Zope X3.0.0 release.

COPYRIGHT.txt

+Zope Foundation and Contributors
\ No newline at end of file

LICENSE.txt

+Zope Public License (ZPL) Version 2.1
+
+A copyright notice accompanies this license document that identifies the
+copyright holders.
+
+This license has been certified as open source. It has also been designated as
+GPL compatible by the Free Software Foundation (FSF).
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions in source code must retain the accompanying copyright
+notice, this list of conditions, and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the accompanying copyright
+notice, this list of conditions, and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+3. Names of the copyright holders must not be used to endorse or promote
+products derived from this software without prior written permission from the
+copyright holders.
+
+4. The right to distribute this software or to use it for any purpose does not
+give you the right to use Servicemarks (sm) or Trademarks (tm) of the
+copyright
+holders. Use of them is covered by separate agreement with the copyright
+holders.
+
+5. If any files are modified, you must cause the modified files to carry
+prominent notices stating that you changed the files and the date of any
+change.
+
+Disclaimer
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY EXPRESSED
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

PKG-INFO

+Metadata-Version: 1.0
+Name: zope.proxy
+Version: 3.6.1
+Summary: Generic Transparent Proxies
+Home-page: http://pypi.python.org/pypi/zope.proxy
+Author: Zope Foundation and Contributors
+Author-email: zope-dev@zope.org
+License: ZPL 2.1
+Description: 
+        ===========================
+        Generic Transparent Proxies
+        ===========================
+        
+        Proxies are special objects which serve as mostly-transparent
+        wrappers around another object, intervening in the apparent behavior of
+        the wrapped object only when necessary to apply the policy (e.g., access
+        checking, location brokering, etc.) for which the proxy is responsible.
+        
+        Editorial note:
+        
+           Unfortunately, we don't have separate documentation for `zope.proxy`
+           at this time.  This is a shame because they are generically useful.
+           We are publishing this release without documentation mainly because
+           it is a dependency of other releases.
+        
+        
+        =======
+        CHANGES
+        =======
+        
+        3.6.1 (2010-07-06)
+        ------------------
+        
+        - Make tests compatible with Python 2.7.
+        
+        3.6.0 (2010-04-30)
+        ------------------
+        
+        - Removed test extra and the remaining dependency on zope.testing.
+        
+        - Removed use of 'zope.testing.doctestunit' in favor of stdlib's 'doctest.
+        
+        3.5.0 (2009/01/31)
+        ------------------
+        
+        - Added support to bootstrap on Jython.
+        
+        - Use zope.container instead of zope.app.container.
+        
+        3.4.2 (2008/07/27)
+        ------------------
+        
+        - Made C code compatible with Python 2.5 on 64bit architectures.
+        
+        3.4.1 (2008/06/24)
+        ------------------
+        
+        - Bug: Updated `setup.py` script to conform to common layout. Also updated
+          some of the fields.
+        
+        - Bug: The behavior of tuples and lists in the `__getslice__()` and
+          `__setslice__()` method were incorrect by not honoring the pre-cooked
+          indices. See http://docs.python.org/ref/sequence-methods.html.
+        
+        3.4.0 (2007/07/12)
+        ------------------
+        
+        - Feature: Added a decorator module that supports declaring interfaces on
+          proxies that get blended with the interfaces of the things they proxy.
+        
+        3.3.0 (2006/12/20)
+        ------------------
+        
+        - Corresponds to the verison of the `zope.proxy` package shipped as part of
+          the Zope 3.3.0 release.
+        
+        
+        3.2.0 (2006/01/05)
+        ------------------
+        
+        - Corresponds to the verison of the zope.proxy package shipped as part of
+          the Zope 3.2.0 release.
+        
+        
+        3.0.0 (2004/11/07)
+        ------------------
+        
+        - Corresponds to the verison of the zope.proxy package shipped as part of
+          the Zope X3.0.0 release.
+        
+Keywords: proxy generic transparent
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Zope Public License
+Classifier: Programming Language :: Python
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent

README.txt

+
+===========================
+Generic Transparent Proxies
+===========================
+
+Proxies are special objects which serve as mostly-transparent
+wrappers around another object, intervening in the apparent behavior of
+the wrapped object only when necessary to apply the policy (e.g., access
+checking, location brokering, etc.) for which the proxy is responsible.
+
+Editorial note:
+
+   Unfortunately, we don't have separate documentation for `zope.proxy`
+   at this time.  This is a shame because they are generically useful.
+   We are publishing this release without documentation mainly because
+   it is a dependency of other releases.

bootstrap.py

+##############################################################################
+#
+# Copyright (c) 2006 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Bootstrap a buildout-based project
+
+Simply run this script in a directory containing a buildout.cfg.
+The script accepts buildout command-line options, so you can
+use the -c option to specify an alternate configuration file.
+"""
+
+import os, shutil, sys, tempfile, urllib2
+from optparse import OptionParser
+
+tmpeggs = tempfile.mkdtemp()
+
+is_jython = sys.platform.startswith('java')
+
+# parsing arguments
+parser = OptionParser()
+parser.add_option("-v", "--version", dest="version",
+                          help="use a specific zc.buildout version")
+parser.add_option("-d", "--distribute",
+                   action="store_true", dest="distribute", default=False,
+                   help="Use Disribute rather than Setuptools.")
+
+parser.add_option("-c", None, action="store", dest="config_file",
+                   help=("Specify the path to the buildout configuration "
+                         "file to be used."))
+
+options, args = parser.parse_args()
+
+# if -c was provided, we push it back into args for buildout' main function
+if options.config_file is not None:
+    args += ['-c', options.config_file]
+
+if options.version is not None:
+    VERSION = '==%s' % options.version
+else:
+    VERSION = ''
+
+USE_DISTRIBUTE = options.distribute
+args = args + ['bootstrap']
+
+to_reload = False
+try:
+    import pkg_resources
+    if not hasattr(pkg_resources, '_distribute'):
+        to_reload = True
+        raise ImportError
+except ImportError:
+    ez = {}
+    if USE_DISTRIBUTE:
+        exec urllib2.urlopen('http://python-distribute.org/distribute_setup.py'
+                         ).read() in ez
+        ez['use_setuptools'](to_dir=tmpeggs, download_delay=0, no_fake=True)
+    else:
+        exec urllib2.urlopen('http://peak.telecommunity.com/dist/ez_setup.py'
+                             ).read() in ez
+        ez['use_setuptools'](to_dir=tmpeggs, download_delay=0)
+
+    if to_reload:
+        reload(pkg_resources)
+    else:
+        import pkg_resources
+
+if sys.platform == 'win32':
+    def quote(c):
+        if ' ' in c:
+            return '"%s"' % c # work around spawn lamosity on windows
+        else:
+            return c
+else:
+    def quote (c):
+        return c
+
+cmd = 'from setuptools.command.easy_install import main; main()'
+ws  = pkg_resources.working_set
+
+if USE_DISTRIBUTE:
+    requirement = 'distribute'
+else:
+    requirement = 'setuptools'
+
+if is_jython:
+    import subprocess
+
+    assert subprocess.Popen([sys.executable] + ['-c', quote(cmd), '-mqNxd',
+           quote(tmpeggs), 'zc.buildout' + VERSION],
+           env=dict(os.environ,
+               PYTHONPATH=
+               ws.find(pkg_resources.Requirement.parse(requirement)).location
+               ),
+           ).wait() == 0
+
+else:
+    assert os.spawnle(
+        os.P_WAIT, sys.executable, quote (sys.executable),
+        '-c', quote (cmd), '-mqNxd', quote (tmpeggs), 'zc.buildout' + VERSION,
+        dict(os.environ,
+            PYTHONPATH=
+            ws.find(pkg_resources.Requirement.parse(requirement)).location
+            ),
+        ) == 0
+
+ws.add_entry(tmpeggs)
+ws.require('zc.buildout' + VERSION)
+import zc.buildout.buildout
+zc.buildout.buildout.main(args)
+shutil.rmtree(tmpeggs)

buildout.cfg

+[buildout]
+parts = test
+develop = .
+
+[test]
+recipe = zc.recipe.testrunner
+eggs = zope.proxy

setup.cfg

+[egg_info]
+tag_build = 
+tag_date = 0
+tag_svn_revision = 0
+

setup.py

+##############################################################################
+#
+# Copyright (c) 2006-2008 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+# This package is developed by the Zope Toolkit project, documented here:
+# http://docs.zope.org/zopetoolkit
+# When developing and releasing this package, please follow the documented
+# Zope Toolkit policies as described by this documentation.
+##############################################################################
+"""Setup for zope.proxy package
+"""
+import os
+from setuptools import setup, Extension
+
+def read(*rnames):
+    return open(os.path.join(os.path.dirname(__file__), *rnames)).read()
+
+setup(name='zope.proxy',
+      version = '3.6.1',
+      author='Zope Foundation and Contributors',
+      author_email='zope-dev@zope.org',
+      description='Generic Transparent Proxies',
+      long_description=(
+          read('README.txt')
+          + '\n\n' +
+          read('CHANGES.txt')
+          ),
+      url='http://pypi.python.org/pypi/zope.proxy',
+      license='ZPL 2.1',
+      classifiers = [
+          'Development Status :: 5 - Production/Stable',
+          'Intended Audience :: Developers',
+          'License :: OSI Approved :: Zope Public License',
+          'Programming Language :: Python',
+          'Natural Language :: English',
+          'Operating System :: OS Independent'],
+      keywords='proxy generic transparent',
+      packages=['zope', 'zope.proxy'],
+      package_dir = {'': 'src'},
+      namespace_packages=['zope',],
+
+      headers=[os.path.join('src', 'zope', 'proxy', 'proxy.h')],
+      ext_modules=[Extension("zope.proxy._zope_proxy_proxy",
+                             [os.path.join('src', 'zope', 'proxy',
+                                           "_zope_proxy_proxy.c")
+                              ]),
+                   ],
+
+      test_suite = 'zope.proxy',
+      install_requires=[
+          'zope.interface',
+          'setuptools'],
+      include_package_data = True,
+      zip_safe = False,
+      )

src/zope.proxy.egg-info/PKG-INFO

+Metadata-Version: 1.0
+Name: zope.proxy
+Version: 3.6.1
+Summary: Generic Transparent Proxies
+Home-page: http://pypi.python.org/pypi/zope.proxy
+Author: Zope Foundation and Contributors
+Author-email: zope-dev@zope.org
+License: ZPL 2.1
+Description: 
+        ===========================
+        Generic Transparent Proxies
+        ===========================
+        
+        Proxies are special objects which serve as mostly-transparent
+        wrappers around another object, intervening in the apparent behavior of
+        the wrapped object only when necessary to apply the policy (e.g., access
+        checking, location brokering, etc.) for which the proxy is responsible.
+        
+        Editorial note:
+        
+           Unfortunately, we don't have separate documentation for `zope.proxy`
+           at this time.  This is a shame because they are generically useful.
+           We are publishing this release without documentation mainly because
+           it is a dependency of other releases.
+        
+        
+        =======
+        CHANGES
+        =======
+        
+        3.6.1 (2010-07-06)
+        ------------------
+        
+        - Make tests compatible with Python 2.7.
+        
+        3.6.0 (2010-04-30)
+        ------------------
+        
+        - Removed test extra and the remaining dependency on zope.testing.
+        
+        - Removed use of 'zope.testing.doctestunit' in favor of stdlib's 'doctest.
+        
+        3.5.0 (2009/01/31)
+        ------------------
+        
+        - Added support to bootstrap on Jython.
+        
+        - Use zope.container instead of zope.app.container.
+        
+        3.4.2 (2008/07/27)
+        ------------------
+        
+        - Made C code compatible with Python 2.5 on 64bit architectures.
+        
+        3.4.1 (2008/06/24)
+        ------------------
+        
+        - Bug: Updated `setup.py` script to conform to common layout. Also updated
+          some of the fields.
+        
+        - Bug: The behavior of tuples and lists in the `__getslice__()` and
+          `__setslice__()` method were incorrect by not honoring the pre-cooked
+          indices. See http://docs.python.org/ref/sequence-methods.html.
+        
+        3.4.0 (2007/07/12)
+        ------------------
+        
+        - Feature: Added a decorator module that supports declaring interfaces on
+          proxies that get blended with the interfaces of the things they proxy.
+        
+        3.3.0 (2006/12/20)
+        ------------------
+        
+        - Corresponds to the verison of the `zope.proxy` package shipped as part of
+          the Zope 3.3.0 release.
+        
+        
+        3.2.0 (2006/01/05)
+        ------------------
+        
+        - Corresponds to the verison of the zope.proxy package shipped as part of
+          the Zope 3.2.0 release.
+        
+        
+        3.0.0 (2004/11/07)
+        ------------------
+        
+        - Corresponds to the verison of the zope.proxy package shipped as part of
+          the Zope X3.0.0 release.
+        
+Keywords: proxy generic transparent
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Zope Public License
+Classifier: Programming Language :: Python
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent

src/zope.proxy.egg-info/SOURCES.txt

+CHANGES.txt
+COPYRIGHT.txt
+LICENSE.txt
+README.txt
+bootstrap.py
+buildout.cfg
+setup.py
+src/zope/__init__.py
+src/zope.proxy.egg-info/PKG-INFO
+src/zope.proxy.egg-info/SOURCES.txt
+src/zope.proxy.egg-info/dependency_links.txt
+src/zope.proxy.egg-info/namespace_packages.txt
+src/zope.proxy.egg-info/not-zip-safe
+src/zope.proxy.egg-info/requires.txt
+src/zope.proxy.egg-info/top_level.txt
+src/zope/proxy/__init__.py
+src/zope/proxy/_zope_proxy_proxy.c
+src/zope/proxy/decorator.py
+src/zope/proxy/interfaces.py
+src/zope/proxy/proxy.h
+src/zope/proxy/tests/__init__.py
+src/zope/proxy/tests/test_decorator.py
+src/zope/proxy/tests/test_proxy.py
\ No newline at end of file

src/zope.proxy.egg-info/dependency_links.txt

+

src/zope.proxy.egg-info/namespace_packages.txt

+zope

src/zope.proxy.egg-info/not-zip-safe

+

src/zope.proxy.egg-info/requires.txt

+zope.interface
+setuptools
\ No newline at end of file

src/zope.proxy.egg-info/top_level.txt

+zope

src/zope/__init__.py

+__import__('pkg_resources').declare_namespace(__name__)

src/zope/proxy/__init__.py

+##############################################################################
+#
+# Copyright (c) 2003 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""More convenience functions for dealing with proxies.
+"""
+from zope.interface import moduleProvides
+from zope.proxy.interfaces import IProxyIntrospection
+from zope.proxy._zope_proxy_proxy import *
+from zope.proxy._zope_proxy_proxy import _CAPI
+
+moduleProvides(IProxyIntrospection)
+__all__ = tuple(IProxyIntrospection)
+
+def ProxyIterator(p):
+    yield p
+    while isProxy(p):
+        p = getProxiedObject(p)
+        yield p
+
+def non_overridable(func):
+    return property(lambda self: func.__get__(self))

src/zope/proxy/decorator.py

+##############################################################################
+#
+# Copyright (c) 2003 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Decorator support
+
+Decorators are proxies that are mostly transparent but that may provide
+additional features.
+"""
+__docformat__ = "reStructuredText"
+
+from zope.proxy import getProxiedObject, ProxyBase
+from zope.interface.declarations import ObjectSpecificationDescriptor
+from zope.interface.declarations import getObjectSpecification
+from zope.interface.declarations import ObjectSpecification
+from zope.interface import providedBy
+
+class DecoratorSpecificationDescriptor(ObjectSpecificationDescriptor):
+    """Support for interface declarations on decorators
+
+    >>> from zope.interface import *
+    >>> class I1(Interface):
+    ...     pass
+    >>> class I2(Interface):
+    ...     pass
+    >>> class I3(Interface):
+    ...     pass
+    >>> class I4(Interface):
+    ...     pass
+
+    >>> class D1(SpecificationDecoratorBase):
+    ...   implements(I1)
+
+
+    >>> class D2(SpecificationDecoratorBase):
+    ...   implements(I2)
+
+    >>> class X(object):
+    ...   implements(I3)
+
+    >>> x = X()
+    >>> directlyProvides(x, I4)
+
+    Interfaces of X are ordered with the directly-provided interfaces first
+
+    >>> [interface.getName() for interface in list(providedBy(x))]
+    ['I4', 'I3']
+
+    When we decorate objects, what order should the interfaces come
+    in?  One could argue that decorators are less specific, so they
+    should come last.
+
+    >>> [interface.getName() for interface in list(providedBy(D1(x)))]
+    ['I4', 'I3', 'I1']
+
+    >>> [interface.getName() for interface in list(providedBy(D2(D1(x))))]
+    ['I4', 'I3', 'I1', 'I2']
+
+    SpecificationDecorators also work with old-style classes:
+
+    >>> class X:
+    ...   implements(I3)
+
+    >>> x = X()
+    >>> directlyProvides(x, I4)
+
+    >>> [interface.getName() for interface in list(providedBy(x))]
+    ['I4', 'I3']
+
+    >>> [interface.getName() for interface in list(providedBy(D1(x)))]
+    ['I4', 'I3', 'I1']
+
+    >>> [interface.getName() for interface in list(providedBy(D2(D1(x))))]
+    ['I4', 'I3', 'I1', 'I2']
+    """
+    def __get__(self, inst, cls=None):
+        if inst is None:
+            return getObjectSpecification(cls)
+        else:
+            provided = providedBy(getProxiedObject(inst))
+
+            # Use type rather than __class__ because inst is a proxy and
+            # will return the proxied object's class.
+            cls = type(inst)
+            return ObjectSpecification(provided, cls)
+
+    def __set__(self, inst, value):
+        raise TypeError("Can't set __providedBy__ on a decorated object")
+
+
+class SpecificationDecoratorBase(ProxyBase):
+    """Base class for a proxy that provides additional interfaces."""
+
+    __providedBy__ = DecoratorSpecificationDescriptor()
+

src/zope/proxy/interfaces.py

+##############################################################################
+#
+# Copyright (c) 2001, 2002 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE
+#
+##############################################################################
+"""Proxy-related interfaces.
+"""
+
+from zope.interface import Interface
+
+class IProxyIntrospection(Interface):
+    """Provides methods for indentifying proxies and extracting proxied objects
+    """
+
+    def isProxy(obj, proxytype=None):
+        """Check whether the given object is a proxy
+
+        If proxytype is not None, checkes whether the object is
+        proxied by the given proxytype.
+        """
+
+    def sameProxiedObjects(ob1, ob2):
+        """Check whether ob1 and ob2 are the same or proxies of the same object
+        """
+
+    def getProxiedObject(obj):
+        """Get the proxied Object
+
+        If the object isn't proxied, then just return the object.
+        """
+
+    def setProxiedObject(ob1, ob2):
+        """Set the underlying object for ob1 to ob2, returning the old object.
+
+        Raises TypeError if ob1 is not a proxy.
+        """
+
+    def removeAllProxies(obj):
+        """Get the proxied object with no proxies
+
+        If obj is not a proxied object, return obj.
+
+        The returned object has no proxies.
+        """
+
+    def queryProxy(obj, proxytype, default=None):
+        """Look for a proxy of the given type around the object
+
+        If no such proxy can be found, return the default.
+        """
+
+    def queryInnerProxy(obj, proxytype, default=None):
+        """Look for the inner-most proxy of the given type around the object
+
+        If no such proxy can be found, return the default.
+
+        If there is such a proxy, return the inner-most one.
+        """

src/zope/proxy/proxy.h

+#ifndef _proxy_H_
+#define _proxy_H_ 1
+
+#if PY_VERSION_HEX < 0x02050000 && !defined(PY_SSIZE_T_MIN)
+typedef int Py_ssize_t;
+#define PY_SSIZE_T_MAX INT_MAX
+#define PY_SSIZE_T_MIN INT_MIN
+typedef Py_ssize_t (*lenfunc)(PyObject *);
+typedef PyObject *(*ssizeargfunc)(PyObject *, Py_ssize_t);
+typedef PyObject *(*ssizessizeargfunc)(PyObject *, Py_ssize_t, Py_ssize_t);
+typedef int(*ssizeobjargproc)(PyObject *, Py_ssize_t, PyObject *);
+typedef int(*ssizessizeobjargproc)(PyObject *, Py_ssize_t, Py_ssize_t, PyObject *);
+#endif
+
+typedef struct {
+    PyObject_HEAD
+    PyObject *proxy_object;
+} ProxyObject;
+
+#define Proxy_GET_OBJECT(ob)   (((ProxyObject *)(ob))->proxy_object)
+
+typedef struct {
+    PyTypeObject *proxytype;
+    int (*check)(PyObject *obj);
+    PyObject *(*create)(PyObject *obj);
+    PyObject *(*getobject)(PyObject *proxy);
+} ProxyInterface;
+
+
+#ifndef PROXY_MODULE
+
+/* These are only defined in the public interface, and are not
+ * available within the module implementation.  There we use the
+ * classic Python/C API only.
+ */
+
+static ProxyInterface *_proxy_api = NULL;
+
+static int
+Proxy_Import(void)
+{
+    if (_proxy_api == NULL) {
+        PyObject *m = PyImport_ImportModule("zope.proxy");
+        if (m != NULL) {
+            PyObject *tmp = PyObject_GetAttrString(m, "_CAPI");
+            if (tmp != NULL) {
+                if (PyCObject_Check(tmp))
+                    _proxy_api = (ProxyInterface *)
+                        PyCObject_AsVoidPtr(tmp);
+                Py_DECREF(tmp);
+            }
+        }
+    }
+    return (_proxy_api == NULL) ? -1 : 0;
+}
+
+#define ProxyType               (*_proxy_api->proxytype)
+#define Proxy_Check(obj)        (_proxy_api->check((obj)))
+#define Proxy_CheckExact(obj)   ((obj)->ob_type == ProxyType)
+#define Proxy_New(obj)          (_proxy_api->create((obj)))
+#define Proxy_GetObject(proxy)  (_proxy_api->getobject((proxy)))
+
+#endif /* PROXY_MODULE */
+
+#endif /* _proxy_H_ */

src/zope/proxy/tests/__init__.py

+#
+# This file is necessary to make this directory a package.

src/zope/proxy/tests/test_decorator.py

+##############################################################################
+#
+# Copyright (c) 2003 Zope Foundation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Test Harness
+"""
+from doctest import DocTestSuite
+
+
+def test_suite():
+    suite = DocTestSuite()
+    suite.addTest(DocTestSuite('zope.proxy.decorator'))
+    return suite