diff options
author | liujisi@google.com <liujisi@google.com@630680e5-0e50-0410-840e-4b1c322b438d> | 2010-12-08 03:45:27 +0000 |
---|---|---|
committer | liujisi@google.com <liujisi@google.com@630680e5-0e50-0410-840e-4b1c322b438d> | 2010-12-08 03:45:27 +0000 |
commit | 9b7f6c544ae9546e7ae0c438e36900754edb108d (patch) | |
tree | 22aa38d996d14fbd1e34ea0ac3a1093d7acf01bc /python/README.txt | |
parent | 1fd96c43a01ec913a89de31c58c0bc9f1e5bf542 (diff) | |
download | protobuf-9b7f6c544ae9546e7ae0c438e36900754edb108d.tar.gz protobuf-9b7f6c544ae9546e7ae0c438e36900754edb108d.tar.bz2 protobuf-9b7f6c544ae9546e7ae0c438e36900754edb108d.zip |
Fix issues: 223 224 242.
Diffstat (limited to 'python/README.txt')
-rw-r--r-- | python/README.txt | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/python/README.txt b/python/README.txt index 96f1a734..73a26566 100644 --- a/python/README.txt +++ b/python/README.txt @@ -63,6 +63,9 @@ Installation $ python setup.py install This step may require superuser privileges. + NOTE: To use C++ implementation, you need to export the environment variable + before this step. See the "C++ Implementation" section below for more + details. Usage ===== @@ -71,3 +74,24 @@ The complete documentation for Protocol Buffers is available via the web at: http://code.google.com/apis/protocolbuffers/ + +C++ Implementation +================== + +WARNING: This is EXPERIMENTAL and only available for CPython platforms. + +The C++ implementation for Python messages is built as a Python extension to +improve the overall protobuf Python performance. + +To use the C++ implementation, export an environment variable: + + $ export PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION=cpp + +You need to export this variable before running setup.py script to build and +install the extension. You must also set the variable at runtime, otherwise +the pure-Python implementation will be used. In a future release, we will +change the default so that C++ implementation is used whenever it is available. +It is strongly recommended to run `python setup.py test` after setting the +variable to "cpp", so the tests will be against C++ implemented Python +messages. + |