From: Stefan Behnel <scoder@users.berlios.de>
Date: Sun, 8 Feb 2009 08:08:20 +0000 (+0100)
Subject: additional note on importing .py files with pyximport
X-Git-Tag: 0.11.rc~89
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=94903a17047793a3883250642b617947e06dec0b;p=cython.git

additional note on importing .py files with pyximport
---

diff --git a/pyximport/pyximport.py b/pyximport/pyximport.py
index 2aa1bf20..42e397ff 100644
--- a/pyximport/pyximport.py
+++ b/pyximport/pyximport.py
@@ -14,6 +14,17 @@ For instance on the Mac with a non-system Python 2.3, you could create
 sitecustomize.py with only those two lines at
 /usr/local/lib/python2.3/site-packages/sitecustomize.py .
 
+Since Cython 0.11, the :mod:`pyximport` module also has experimental
+compilation support for normal Python modules.  This allows you to
+automatically run Cython on every .pyx and .py module that Python
+imports, including parts of the standard library and installed
+packages.  Cython will still fail to compile a lot of Python modules,
+in which case the import mechanism will fall back to loading the
+Python source modules instead.  The .py import mechanism is installed
+like this::
+
+    pyximport.install(pyimport = True)
+
 Running this module as a top-level script will run a test and then print
 the documentation.