| Index: third_party/protobuf/python/README.txt
|
| diff --git a/third_party/protobuf/python/README.md b/third_party/protobuf/python/README.txt
|
| similarity index 58%
|
| rename from third_party/protobuf/python/README.md
|
| rename to third_party/protobuf/python/README.txt
|
| index 1b5b9dffd9a1ad209293b428197cbfad31269597..6dc144e9b817c50bab9e59a1c25b408a3e955c16 100644
|
| --- a/third_party/protobuf/python/README.md
|
| +++ b/third_party/protobuf/python/README.txt
|
| @@ -1,8 +1,4 @@
|
| Protocol Buffers - Google's data interchange format
|
| -===================================================
|
| -
|
| -[](https://travis-ci.org/google/protobuf)
|
| -
|
| Copyright 2008 Google Inc.
|
|
|
| This directory contains the Python Protocol Buffers runtime library.
|
| @@ -10,7 +6,7 @@ This directory contains the Python Protocol Buffers runtime library.
|
| Normally, this directory comes as part of the protobuf package, available
|
| from:
|
|
|
| - https://developers.google.com/protocol-buffers/
|
| + http://code.google.com/p/protobuf
|
|
|
| The complete package includes the C++ source code, which includes the
|
| Protocol Compiler (protoc). If you downloaded this package from PyPI
|
| @@ -30,7 +26,7 @@ join the Protocol Buffers discussion list and let us know!
|
| Installation
|
| ============
|
|
|
| -1) Make sure you have Python 2.6 or newer. If in doubt, run:
|
| +1) Make sure you have Python 2.4 or newer. If in doubt, run:
|
|
|
| $ python -V
|
|
|
| @@ -39,7 +35,7 @@ Installation
|
| If you would rather install it manually, you may do so by following
|
| the instructions on this page:
|
|
|
| - https://packaging.python.org/en/latest/installing.html#setup-for-installing-packages
|
| + http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions
|
|
|
| 3) Build the C++ code, or install a binary distribution of protoc. If
|
| you install a binary distribution, make sure that it is the same
|
| @@ -47,43 +43,10 @@ Installation
|
|
|
| $ protoc --version
|
|
|
| -4) Build and run the tests:
|
| +4) Run the tests:
|
|
|
| - $ python setup.py build
|
| $ python setup.py test
|
|
|
| - To build, test, and use the C++ implementation, you must first compile
|
| - libprotobuf.so:
|
| -
|
| - $ (cd .. && make)
|
| -
|
| - On OS X:
|
| -
|
| - If you are running a homebrew-provided python, you must make sure another
|
| - version of protobuf is not already installed, as homebrew's python will
|
| - search /usr/local/lib for libprotobuf.so before it searches ../src/.libs
|
| - You can either unlink homebrew's protobuf or install the libprotobuf you
|
| - built earlier:
|
| -
|
| - $ brew unlink protobuf
|
| - or
|
| - $ (cd .. && make install)
|
| -
|
| - On other *nix:
|
| -
|
| - You must make libprotobuf.so dynamically available. You can either
|
| - install libprotobuf you built earlier, or set LD_LIBRARY_PATH:
|
| -
|
| - $ export LD_LIBRARY_PATH=../src/.libs
|
| - or
|
| - $ (cd .. && make install)
|
| -
|
| - To build the C++ implementation run:
|
| - $ python setup.py build --cpp_implementation
|
| -
|
| - Then run the tests like so:
|
| - $ python setup.py test --cpp_implementation
|
| -
|
| If some tests fail, this library may not work correctly on your
|
| system. Continue at your own risk.
|
|
|
| @@ -97,17 +60,12 @@ Installation
|
|
|
| 5) Install:
|
|
|
| - $ python setup.py install
|
| -
|
| - or:
|
| -
|
| - $ (cd .. && make install)
|
| - $ python setup.py install --cpp_implementation
|
| + $ python setup.py install
|
|
|
| This step may require superuser privileges.
|
| - NOTE: To use C++ implementation, you need to export an environment
|
| - variable before running your program. See the "C++ Implementation"
|
| - section below for more details.
|
| + NOTE: To use C++ implementation, you need to install C++ protobuf runtime
|
| + library of the same version and export the environment variable before this
|
| + step. See the "C++ Implementation" section below for more details.
|
|
|
| Usage
|
| =====
|
| @@ -115,11 +73,13 @@ Usage
|
| The complete documentation for Protocol Buffers is available via the
|
| web at:
|
|
|
| - https://developers.google.com/protocol-buffers/
|
| + 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.
|
|
|
| @@ -128,8 +88,13 @@ To use the C++ implementation, you need to:
|
| parent directory.
|
| 2) Export an environment variable:
|
|
|
| - $ export PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION=cpp
|
| + $ export PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION=cpp
|
|
|
| -You must set this variable at runtime, before running your program, otherwise
|
| +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.
|
| +
|
|
|