OLD | NEW |
1 Protocol Buffers - Google's data interchange format | 1 Protocol Buffers - Google's data interchange format |
2 Copyright 2008 Google Inc. | 2 Copyright 2008 Google Inc. |
3 | 3 |
4 This directory contains the Python Protocol Buffers runtime library. | 4 This directory contains the Python Protocol Buffers runtime library. |
5 | 5 |
6 Normally, this directory comes as part of the protobuf package, available | 6 Normally, this directory comes as part of the protobuf package, available |
7 from: | 7 from: |
8 | 8 |
9 http://code.google.com/p/protobuf | 9 http://code.google.com/p/protobuf |
10 | 10 |
(...skipping 45 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
56 to be a bug either in Cygwin or in Python: | 56 to be a bug either in Cygwin or in Python: |
57 http://www.cygwin.com/ml/cygwin/2005-07/msg01378.html | 57 http://www.cygwin.com/ml/cygwin/2005-07/msg01378.html |
58 We do not know if or when it might me fixed. We also do not know | 58 We do not know if or when it might me fixed. We also do not know |
59 how likely it is that this bug will affect users in practice. | 59 how likely it is that this bug will affect users in practice. |
60 | 60 |
61 5) Install: | 61 5) Install: |
62 | 62 |
63 $ python setup.py install | 63 $ python setup.py install |
64 | 64 |
65 This step may require superuser privileges. | 65 This step may require superuser privileges. |
| 66 NOTE: To use C++ implementation, you need to export the environment variable |
| 67 before this step. See the "C++ Implementation" section below for more |
| 68 details. |
66 | 69 |
67 Usage | 70 Usage |
68 ===== | 71 ===== |
69 | 72 |
70 The complete documentation for Protocol Buffers is available via the | 73 The complete documentation for Protocol Buffers is available via the |
71 web at: | 74 web at: |
72 | 75 |
73 http://code.google.com/apis/protocolbuffers/ | 76 http://code.google.com/apis/protocolbuffers/ |
| 77 |
| 78 C++ Implementation |
| 79 ================== |
| 80 |
| 81 WARNING: This is EXPERIMENTAL and only available for CPython platforms. |
| 82 |
| 83 The C++ implementation for Python messages is built as a Python extension to |
| 84 improve the overall protobuf Python performance. |
| 85 |
| 86 To use the C++ implementation, export an environment variable: |
| 87 |
| 88 $ export PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION=cpp |
| 89 |
| 90 You need to export this variable before running setup.py script to build and |
| 91 install the extension. You must also set the variable at runtime, otherwise |
| 92 the pure-Python implementation will be used. In a future release, we will |
| 93 change the default so that C++ implementation is used whenever it is available. |
| 94 It is strongly recommended to run `python setup.py test` after setting the |
| 95 variable to "cpp", so the tests will be against C++ implemented Python |
| 96 messages. |
| 97 |
OLD | NEW |